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.
oqoqo project ai inspect
Read agents, custom agents, provider connections, models, and the model of each Oqoqo 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.- A provider’s
modelCountcounts the models that an agent or an Oqoqo AI feature can use now, andenabledModelCountcounts the ones of those that are turned on.unavailableModelCountcounts the listed models that can’t be used with the current credentials, and the text output adds (N more can’t be used) for them. - Each model of a provider has
availability(availableorunavailable). An unavailable model also hasavailabilityReason(refused,credentials_changed, ornot_checked) andavailabilityMessage, which says the reason in a sentence. Models that cannot be used explains each reason. --availabilityworks only with--provider-connection-id. With another view or with--agent-key, the command changes nothing and returnsinvalid_request. A cursor continues only the list it came from, so pass the same--availabilitywith--cursor.- 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@oqoqo.ai to enable them for your organization.
agents view, each custom agent has a custom block:
oqoqo project ai apply
Create or change custom agents, turn agents and models on or off, state context windows, refresh model lists, and set each Oqoqo AI feature’s model and instructions.manage_project_ai
Flags
Pass one of the two.
oqoqo 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 polloqoqo 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:
oqoqo 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 Oqo, you approve each call.
Arguments
Flags
Also takes the global flags.
Examples
Test an agent, watch the run, then read its status:
oqoqo 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:
oqoqo 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. Oqoqo 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
oqoqo project ai inspect. A refused removal changes nothing and exits4with one of these codes:
oqoqo 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:
oqoqo 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.
oqoqo mcp tools list
List the tools that an MCP server listed when Oqoqo 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.
oqoqo 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 oqoqo mcp tools list, and the global flags.
Examples
Check the server and wait for the result:
oqoqo 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 withoqoqo 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 runoqoqo mcp tools list.
oqoqo 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.
Related
Custom agents
Sources, values, status, and models of a custom agent.
Model providers
Connect providers and state context windows in the dashboard.
oqoqo experiments
Launch the agents and models you turned on.
Oqoqo AI defaults
Choose the model of each Oqoqo AI feature.

