@octri/cli
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OCTRI_DEBUG | No | Print stack traces on failure | |
| OCTRI_TOKEN | No | Bearer token, bypassing the stored session | |
| OCTRI_API_KEY | No | API key for the public routes | |
| OCTRI_API_URL | No | API root (local is shorthand for :3001) | |
| OCTRI_PROFILE | No | Profile to use | |
| OCTRI_CONFIG_DIR | No | Where config and the artifact cache live | |
| OCTRI_PROJECT_ID | No | Default project |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| octri_whoamiA | The signed-in user, org, plan, API URL and currently selected project. Call this first to confirm which environment the session is pointed at. |
| octri_list_projectsC | All projects in the organisation, with ids. |
| octri_list_specsC | OpenAPI specs uploaded to a project, newest first. |
| octri_push_specB | Upload OpenAPI spec text (JSON or YAML) as the project's new current spec. Returns the created spec id. |
| octri_import_spec_urlC | Import an OpenAPI spec from a public URL. |
| octri_list_languagesB | The SDK generator's language catalogue and the preference keys each language accepts. |
| octri_list_operationsB | Every operation the parser found in the current spec, with method, path, operationId and deprecation, the list the SDK Studio renders. |
| octri_get_sdk_settingsA | The project's persisted SDK Studio settings, per-endpoint overrides, revision, and last published release. The revision is required to write settings back. |
| octri_set_sdk_settingsA | Write SDK Studio settings. Pass a full settings object (read it first with octri_get_sdk_settings and modify), plus the revision you read. A stale revision is rejected. |
| octri_validate_specA | Run the generator's validator against the project's current spec. Cheap; do this before spending a build. |
| octri_preview_sdkA | Generate one language WITHOUT spending a build, and return the emitted file paths (and optionally contents). This is the fast loop for generator changes. |
| octri_trigger_buildA | Queue an SDK build for one or more languages. Returns a build id immediately; poll with octri_get_build or block with octri_wait_for_build. |
| octri_list_buildsC | Recent SDK builds with per-language status. |
| octri_get_buildB | One build's current state, including each language's lifecycle phase and any failure message. |
| octri_wait_for_buildA | Block until every language of a build reaches a terminal state, then return the final per-language result. Use after octri_trigger_build. |
| octri_retry_buildA | Re-run only the named languages of an existing build, in place. Omit |
| octri_fetch_artifactsB | Download and extract a build's artifacts into the local cache so their files can be listed and read. Returns per-language file counts and a content fingerprint. |
| octri_list_generated_filesA | List the files of a previously fetched build+language, with sizes. Call octri_fetch_artifacts first. |
| octri_read_generated_fileB | Read one generated file from a fetched build. This is how to inspect what the generator actually emitted. |
| octri_diff_buildsA | Compare two fetched builds file-by-file per language: which emitted files were added, removed or changed. The primary way to judge a generator change. |
| octri_list_doc_pagesC | Documentation pages generated for the project. |
| octri_get_doc_pageC | One documentation page by slug. |
| octri_list_mcp_toolsC | The MCP tool catalogue this project publishes to its own customers, derived from its SDK config. |
| octri_list_sdk_reposC | Per-language GitHub repositories linked to the project's SDKs. |
| octri_monitoring_summaryA | Production health for the project: event count, error count, error rate and distinct issues over a window. Call this before reading issues. It tells you whether there is anything to look at. |
| octri_list_issuesB | Grouped production errors, newest first. Each issue has an id usable with octri_get_issue. |
| octri_get_issueC | One issue with its stack frames and recent events. A frame with resolved=true was de-minified against an uploaded source map; if none are, the symbols for that release were never uploaded. |
| octri_set_issue_statusB | Triage an issue: resolve it, ignore it, or reopen it (status |
| octri_query_logsB | Raw production events, unaggregated. Use when an issue's grouped view is not enough, e.g. to see every occurrence across releases. |
| octri_monitoring_releasesB | Error rate, new issues and regressions per release. This is how you tell whether a deploy made things worse. |
| octri_monitoring_performanceC | Slowest transactions (p50/p95) and suspected N+1 query patterns for the project. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 31 tools
Most tools have crisp, distinct purposes (e.g. preview_sdk vs trigger_build, push_spec vs import_spec_url vs validate_spec). The only mild overlap clusters are the monitoring_* trio and the build lifecycle tools, but their descriptions clearly delineate when to reach for each.
Nearly all tools follow an octri_ + verb_noun snake_case pattern (list_projects, get_build, push_spec, trigger_build). A few deviate by prefixing a namespace noun instead of a verb (octri_monitoring_summary, octri_monitoring_releases, octri_whoami, octri_diff_builds), but the convention stays readable and predictable.
31 tools is on the heavy side and exceeds the comfortable range. The scope is genuinely broad (specs, SDK settings, builds, artifacts, monitoring, docs), so most tools arguably earn their place, but the surface is large enough that selection burden is real.
The surface covers the full lifecycle well: spec ingestion/validation, settings read/write, build trigger/poll/retry/fetch, artifact inspection, monitoring, issues, logs, docs, and MCP discovery. Minor gaps exist (no delete/cleanup for specs or builds, no project creation), but core workflows are complete.