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.inspect_project_ai
Flags
Also takes the global flags.
Examples
List provider connections that you must fix:
blockersis empty when you can run models. Otherwise it says why not, such as no working provider, with thesetupUrlthat fixes it.modelRefreshhasstatus(queued,running,succeeded, orfailed),listedAt, and the counts of the last refresh.listedAtis the time the refresh read the provider’s list, andnullbefore that. WhilestatusisrunningandlistedAtis set, themodelsview 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(catalogorstated), and yourstatedContextWindowTokens.suggestedContextWindow(tokens,catalog,catalogModelId) comes from a public catalog and applies only once you state it withset_model_context_windows. - A custom agent’s model has
agentState:current,stale(Not confirmed), orunavailable(Unavailable).
Custom agent fields
Custom agents are in private beta. Email support@obss.app to enable them for your organization.
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.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:
- The provider’s current context window wins over a stated one.
- After
refresh_models, resolve any failed list’sactionRequired, then pollobss project ai inspectuntilcounts.modelRefresh.refreshingis 0. To read a provider’s models before its checks finish, read themodelsview once that provider’smodelRefresh.listedAtis set. - A refused operation changes nothing and exits
4with one of these codes:
obss project ai test-agent
Start a Test agent run, which checks that a custom agent installs, starts, and answers.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:
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.delete_project_ai
Flags
Also takes the global flags.
Delete operations
Examples
Remove a custom agent:
- 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 exits4with 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.inspect_mcp_account
Arguments
Takes only the global flags.
Examples
Check an MCP server’s connection:
obss mcp accounts detect-auth
Detect how an MCP server authenticates, and whether that matches its saved configuration.detect_mcp_auth_mode
Arguments
Takes only the global flags.
Examples
Detect an MCP server’s sign-in method:
See MCP server sign-in.
obss mcp tools list
List the tools that an MCP server listed when Obss last checked it.list_mcp_server_tools
Arguments
Flags
Also takes the global flags.
Examples
Find the tools about issues:
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.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:
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,
refreshstaysrunning, and you read the list again withobss 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
headerValuesBoundisfalse, it fails withmcp_tool_check_needs_weband exits4. Openerror.details.setupUrl, check the address under Refresh, and select Refresh. Then runobss mcp tools list.
obss setup links
Get the dashboard link for every secure input: account connections, API keys, secret headers, and other secret values.get_setup_links
Takes only the global flags.
Examples
Get the setup links as JSON:
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.
