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.

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.
Plugin (MCP) tool: inspect_project_ai Flags Also takes the global flags. Examples List provider connections that you must fix:
List a provider’s models that can’t be used, with the reason:
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.
  • A provider’s modelCount counts the models that an agent or an Oqoqo AI feature can use now, and enabledModelCount counts the ones of those that are turned on. unavailableModelCount counts 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 (available or unavailable). An unavailable model also has availabilityReason (refused, credentials_changed, or not_checked) and availabilityMessage, which says the reason in a sentence. Models that cannot be used explains each reason.
  • --availability works only with --provider-connection-id. With another view or with --agent-key, the command changes nothing and returns invalid_request. A cursor continues only the list it came from, so pass the same --availability with --cursor.
  • 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@oqoqo.ai to enable them for your organization.
In the 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.
Plugin (MCP) tool: 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:
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 oqoqo 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:

oqoqo 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 Oqo, 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 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.
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. 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 exits 4 with 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.
Plugin (MCP) tool: inspect_mcp_account Arguments Takes only the global flags. Examples Check an MCP server’s connection:
Result fields

oqoqo 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.

oqoqo mcp tools list

List the tools that an MCP server listed when Oqoqo 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.

oqoqo 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 oqoqo mcp tools list, and the global flags. Examples Check the server and wait for the result:
Result fields The fields of 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, refresh stays running, and you read the list again with oqoqo 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 oqoqo 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.

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.