Connect
circuit auth login. Approve with your passkey, name the connection, choose which wallets it may suggest changes for, and whether it may build new agents, suggest session actions, or suggest swaps and transfers. The permit lasts one year and is saved under the assistant’s name, separate from your own login and from other assistants. Commands use your own login when one is saved, otherwise the only assistant login on the machine; when several logins share a machine, the assistant sets CIRCUIT_ASSISTANT="Muse" (or passes --assistant "Muse") for every command. Change access or disconnect under Connected assistants in your profile menu, beside Settings and Passkeys; every request re-reads the connection’s access, so changes apply to the existing permit at once and a disconnected permit is refused.
The permit carries only account.read. Routes that need account.write, such as uploading code, approving a suggestion, signing and account settings, refuse it. Free-text Terminal turns are refused too: an assistant submits reviews and builds.
Workflow
- Read the account first.
circuit terminal contextprints the snapshot Terminal reasons from: wallets (id, name, address, VM family), indexed holdings, sessions with their status, agents with theirstartingAsset(includingminimumAmountRaw), pending operations, backtests, workspaces, and supported networks with their native asset. Use only ids and assets from this output. - Build through Builder.
circuit terminal --build "<strategy in plain words>" --waitbuilds a new agent and waits for the build to finish; it needs a connection allowed to build. Assistants never edit existing agents; the user does. Never write agent files or runcircuit neworcircuit upload; an assistant cannot upload. - Suggest changes. Write a JSON file matching
circuit capabilities --resource terminal/reviewand submit it withcircuit terminal --review <file> "<reason>"(-reads stdin). The request text is recorded as the reason for the suggestion.
Rules Circuit enforces
A refused suggestion returns the reason, for example
Assistants may only suggest transfers between your own wallets.