Skip to main content
Two things live here: the agent family configures and inspects the server-side agents (Auditor, Architect, Librarian), and the hook / hooks commands manage the local auto-pull hook. They are unrelated: agent talks to the server, hooks edits a local file. Add --json to any agent command for machine output.

​
Agent runs and config

The agents run automatically server-side; the CLI inspects and configures them. There is no manual run-trigger command (it was retired).
CommandDescription
agent runs [--limit <n>]Recent runs (id, agent, status, time).
agent run <id>One run with its full trace.
agent config [--show]Print the current config. Secret keys are never echoed.
agent config --set <key>=<value>Set a config key (repeatable).
agent usage [--days <n>]Token and cost rollup.
agent statsProposal acceptance stats.
agent modelsThe BYOM model catalog.

​
BYOM configuration

Settable keys on agent config --set: opencode_key (the bring-your-own-model key, write-only), model (a comma-separated priority list of provider/model; the runner rotates on a rate-limit or credit error), and the toggles auditor, architect, librarian, and librarian_autovouch. 
driftless agent config --set opencode_key=oc_xxx --set model="opencode/claude-sonnet-4-6"
driftless agent config --set auditor=true --set architect=true
driftless agent config --show    # key is redacted
Each agent is off until its toggle is on and a model key is configured; otherwise a run records a no_op.

​
Hooks (auto-pull)

The auto-pull hook is a local Claude Code feature, off by default. Two commands manage it, and they are different:
CommandDescription
hook <pre-edit|post-edit|stop|sync>The runtime glue Claude Code invokes. You never run it by hand.
hooks enableInstall the hook entries into .claude/settings.json (PreToolUse, PostToolUse, Stop).
hooks disableRemove those entries from this machine.
Installing the hook is inert until a workspace admin turns on the auto_pull_context toggle in the dashboard. Only Knowledge (reviewed) topics ever inject. 
driftless install-skill    # installs the hook, inert
driftless hooks disable    # remove it from this machine

​
Permissions

Reading agent runs and setting BYOM config are workspace-member actions from the CLI. The agent-runs surface is not reachable over OAuth/MCP (agent runs spend model inference); the MCP surface exposes only driftless_agent_stats.