Skip to main content
These commands set up the agents and models a project runs, and find what still needs a value in the dashboard. Secret values never pass through the CLI. API keys, OAuth sign-ins, secret headers, and environment variable values go in the dashboard, and the CLI returns the exact link.

obss project ai inspect

Read agents, custom agents, provider connections, models, and the model of each Obss AI feature. It never starts a model refresh or changes settings.
Plugin (MCP) tool: inspect_project_ai Flags Also takes the global flags. Examples List provider connections that you must fix:
List agents, with each custom agent’s status and fix:
List a custom agent’s models:
Find an agent in the ACP Registry:
Result fields
  • blockers is empty when you can run models. Otherwise it says why not, such as no working provider, with the setupUrl that fixes it.
  • modelRefresh has status (queued, running, succeeded, or failed), listedAt, and the counts of the last refresh. listedAt is the time the refresh read the provider’s list, and null before that. While status is running and listedAt is set, the models view has the listed models, and the checks that decide which ones you can select still run. The text output then says Models listed; checking which ones you can use.
  • Each model has contextWindowTokens, contextWindowSource (catalog or stated), and your statedContextWindowTokens. suggestedContextWindow (tokens, catalog, catalogModelId) comes from a public catalog and applies only once you state it with set_model_context_windows.
  • A custom agent’s model has agentState: current, stale (Not confirmed), or unavailable (Unavailable).

Custom agent fields

Custom agents are in private beta. Email support@obss.app to enable them for your organization.
In the agents view, each custom agent has a custom block:

obss project ai apply

Create or change custom agents, turn agents and models on or off, state context windows, refresh model lists, and set each Obss AI feature’s model and instructions.
Plugin (MCP) tool: manage_project_ai Flags Pass one of the two. obss schema project ai apply prints the full schema. Also takes the global flags.

Apply operations

A custom agent’s source is registry (an ACP Registry agent, such as {"kind":"registry","registryId":"gemini"}), manual (an npm package, Python package, or download with its SHA-256, plus args), or agent_json (a standard agent.json). env lists variable names only; the result gives the acp-… key, the agent’s page, and the dashboard link for each value. Examples Turn on every agent in the project:
Create a custom agent from the ACP Registry:
Create a custom agent from an npm package with an exact version:
State a model’s context window:
Refresh model lists, then check progress:
Notes
  • The provider’s current context window wins over a stated one.
  • After refresh_models, resolve any failed list’s actionRequired, then poll obss project ai inspect until counts.modelRefresh.refreshing is 0. To read a provider’s models before its checks finish, read the models view once that provider’s modelRefresh.listedAt is set.
  • A refused operation changes nothing and exits 4 with one of these codes:

obss project ai test-agent

Start a Test agent run, which checks that a custom agent installs, starts, and answers.
Plugin (MCP) tool: test_custom_agent Uses 1 run from your balance. In Ask Obss, you approve each call. Arguments Flags Also takes the global flags. Examples Test an agent, watch the run, then read its status:
Notes The run is one short Agent check task with Agent default, the Raw Agent treatment (no tools), no project files, and Evals and Insights off. Watch the launch ID with obss experiments watch. Each finished run with these settings updates the agent’s status. The command refuses while custom.testBlockers names a blocker, with the first one’s code:

obss project ai delete

Remove a custom agent, delete or reset an organization provider connection, or disconnect your own account from a provider.
Plugin (MCP) tool: delete_project_ai
Removing a custom agent clears its environment variable values. Deleting or resetting a provider connection affects every project in the organization. In a terminal, the CLI asks you to confirm; with --output json or no terminal, pass --yes.
Flags Also takes the global flags.

Delete operations

Examples Remove a custom agent:
Notes
  • A removed custom agent no longer shows in new experiments or the Agents list, and its past results keep its name. Obss refuses the removal while a run of the agent is in progress, either a Test agent run or an experiment. Removing it again returns the same result.
  • A personal disconnect changes only your own account in this organization.
  • Pass the revisions from obss project ai inspect. A refused removal changes nothing and exits 4 with one of these codes:

obss mcp accounts inspect

Check whether an MCP server has the sign-in and headers it needs, without showing any secret.
Plugin (MCP) tool: inspect_mcp_account Arguments Takes only the global flags. Examples Check an MCP server’s connection:
Result fields

obss mcp accounts detect-auth

Detect how an MCP server authenticates, and whether that matches its saved configuration.
Plugin (MCP) tool: detect_mcp_auth_mode Arguments Takes only the global flags. Examples Detect an MCP server’s sign-in method:
Result fields See MCP server sign-in.

obss mcp tools list

List the tools that an MCP server listed when Obss last checked it.
Plugin (MCP) tool: list_mcp_server_tools Arguments Flags Also takes the global flags. Examples Find the tools about issues:
Result fields Notes Tool titles, descriptions, and hints are the server’s own text.

obss mcp tools refresh

Check an MCP server’s tools now and list them.
Plugin (MCP) tool: refresh_mcp_server_tools Arguments Flags Also takes --version-id, --query, --after-position, --limit, and --full, as in obss mcp tools list, and the global flags. Examples Check the server and wait for the result:
Result fields The fields of obss mcp tools list (canTurnOff, lastChange, usageRunCount, onRunCount, runCount, callCount, offInTreatmentCount, offInTreatmentIds, headerValuesBound, truncated, and nextAfterPosition), plus refresh, which is running until the check finishes. Notes
  • A check that is already running is joined, not started again. If the wait ends first, refresh stays running, and you read the list again with obss mcp tools list.
  • A server that needs your account connection or a header value returns that status and its setupUrl.
  • The command never sends saved header values to an address they aren’t bound to, and it never binds them. When headerValuesBound is false, it fails with mcp_tool_check_needs_web and exits 4. Open error.details.setupUrl, check the address under Refresh, and select Refresh. Then run obss mcp tools list.
Get the dashboard link for every secure input: account connections, API keys, secret headers, and other secret values.
Plugin (MCP) tool: get_setup_links Takes only the global flags. Examples Get the setup links as JSON:
Result fields issues lists each machine, MCP server, CLI, and SDK that still needs a required value or your account connection, with the setupUrl where a person does that step. An MCP server whose saved values aren’t bound to its address has a field of scope address, with its Tools tab as setupUrl. The list is empty when nothing is missing.

Next steps