Team & Runner
Sign in to a workspace, run the local worker, and open the console.
These commands are the core workflow: login links your machine to the
AgentRail workspace, and runner is the local worker that claims and executes
queued issues. See Dashboard & hosted runner for the bigger
picture and setup steps.
login
login [--url BASE_URL]Sign this machine into an AgentRail workspace via an OAuth device flow.
Credentials are saved to ~/.agentrail/credentials.json. Use --url BASE_URL
to point at a self-hosted server instead of the default.
Login is required for all CLI commands — the only exempt commands are login,
logout, whoami, and --help.
agentrail loginlogout
logoutSign this machine out of its workspace.
agentrail logoutwhoami
whoamiShow the logged-in workspace for this machine.
agentrail whoamirunner
runner [--idle SECONDS] [--once] [--concurrency N]Run the local worker that executes queued issues — it polls the workspace queue, claims available work, and runs it on your machine with your own LLM keys.
| Flag | Description |
|---|---|
--idle SECONDS | How long to wait for work before idling out. |
--once | Process one batch, then exit. |
--concurrency N | Number of issues to run in parallel. |
agentrail runner --concurrency 2console
console [--target DIR]Open the interactive console.
agentrail console