Use Context

Command reference

Run context <command> --help for the full text of any command.

Every command also takes --profile <name> to use a named pairing instead of the default one (see Run tasks on your machine).

context

Opens the terminal home: this computer, your recent tasks and a row to start a new one. The same as context seat with nothing after it.

Pair this computer with your workspace.

Option	What it does
`--server <address>`	Your workspace’s address. Needed the first time.
`--no-browser`	Only print the approval link; don’t open a browser.
`--browser`	Open the approval link in your default browser even when nothing is watching a terminal (an installer running the pairing for you).
`--new-pairing`	Pair as a new computer, keeping the pairing it already has.

context seat

Continue a task on this computer, or start one.

Code
context seat [task address or id] [--message "<next message>"]
context seat --new --message "<first message>" [--agent <name>] [--workspace <name>] [--model <provider/model>] [--title <text>]

Option	What it does
`--message <text>`	The next message (or the first, with `--new`).
`--new`	Start a new task here.
`--agent <name>`	The agent to talk to, by its name in the web app (any case). Leave it out to pick from a list.
`--workspace <name>`	The workspace to start in, by its name in the web app (any case). Leave it out to pick from a list.
`--model <provider/model>`	The model for a new task.
`--title <text>`	The new task’s title.

context worker

Take tasks sent to this computer and run them here, until you stop it. A worker that runs from the installed program also asks your workspace’s release channel for a newer release every hour, installs it beside itself and hands over to it once it is ready; your pairing and any tool call in flight survive the hand-over.

Option	What it does
`--once`	Take one task, run it, then exit.
`--data-dir <folder>`	Where task files live.

context worker install

Keep this computer present whenever you are signed in: registers a per-user autostart (a logon Scheduled Task on Windows, a LaunchAgent on macOS, a user systemd unit on Linux; never a system service, since the pairing and the MCP servers are yours) that runs context worker and starts it again whenever it exits. Run it before or after context login: an unpaired worker waits for the pairing. The worker’s lines go to worker.log in the data folder.

Option	What it does
`--profile <name>`	Register the autostart for that profile’s pairing.
`--data-dir <folder>`	Where task files live, as for `context worker`.

context worker uninstall

Remove the autostart and stop the worker it runs. The pairing and the program stay (context uninstall --purge removes those).

Option	What it does
`--profile <name>`	The profile whose autostart to remove.

context worker status

The installed release, the autostart’s registration, the pairing, the running worker (its process and whether your workspace sees it online) and the last update events from worker.log.

Option	What it does
`--profile <name>`	The profile to report.
`--json`	Machine-readable output.

context mcp

This computer’s own MCP servers, and an agent’s. See MCP servers.

Command	What it does
`context mcp list [task address or id]`	With nothing after it, this computer’s own servers. With a task, `--agent <name>` or `--workspace <name>`, that agent’s servers too. `--json` for machine-readable output.
`context mcp get <name>`	One of this computer’s servers.
`context mcp add <name> --url <address>`	Add a remote server. Options: `--transport http\|sse`, `--header KEY:VALUE`, `--token-env <NAME>`, `--token-stdin`, `--trusted`.
`context mcp add <name> -- <command…>`	Add a local program. Options: `--env KEY=VALUE`, `--trusted`.
`context mcp remove <name>`	Remove a server and its sign-in.
`context mcp enable <name>` / `disable <name>`	Turn a server on, or keep it but never start it.
`context mcp trust <name>` / `untrust <name>`	Let a server’s read-only tools run as reads, or make every tool ask.
`context mcp login <name>` / `logout <name>`	Sign in to a remote server in your browser (`--no-browser` only prints the link), or sign out.

context upgrade

Upgrade to your workspace’s current release. --force downloads the current version again and repairs this computer’s copy if its files no longer check out. --engine adds the full app to a tools-only install, so tasks can run on this computer.

context uninstall

Remove the program.

Option	What it does
`--dry-run`	List what would be removed; remove nothing.
`--purge`	Also remove the pairing, task files and the engine’s folder.
`--keep-data`	With `--purge`, keep each task’s files and the engine’s folder.

context doctor pairing

Say why sign-in refuses this computer’s pairing folder: every folder sign-in checks, its owner, every other account’s access, and whether sign-in refuses, warns or re-locks it. It changes nothing.

Option	What it does
`--fix`	Windows: re-lock the pairing folder and its files to you, SYSTEM and Administrators, as sign-in does, after saving their permissions; prints the command that restores them.

Upgrade, uninstall and sign out Troubleshooting