Codius CLI

Your Codius host, from the terminal.

Start and supervise supported coding agents, create isolated workspaces, manage schedules, and automate a Codius host with the open-source codius command.

Read the CLI guide Get Codius

codius --help

$codius --help

Usage: codius [options] [command]

Codius CLI - administer hosts, agents, workspaces, and schedules

Options:
  -v, --version                 output the version number
  -o, --format <format>         output format: table, json, yaml (default:
                                "table")
  --json                        output in JSON format (alias for --format json)
  -q, --quiet                   minimal output (IDs only)
  --no-headers                  omit table headers
  --no-color                    disable colored output
  -h, --help                    display help for command

Commands:
  ls [options]                  List agents. By default excludes archived
                                agents.
  run [options] <prompt>        Create and start an agent with a task
  import [options] <id>         Import an existing provider session as a Codius
                                agent
  clone [options] <repo>        Clone a GitHub repo and register it as a Codius
                                workspace
  attach [options] <id>         Attach to a running agent's output stream
  logs [options] <id>           View agent activity/timeline
  stop [options] [id]           Interrupt an agent if it is running (no-op for
                                idle agents)
  delete [options] [id]         Delete an agent (interrupt if running, then
                                hard-delete)
  send [options] <id> [prompt]  Send a message/task to an existing agent
  inspect [options] <id>        Show detailed information about an agent
  wait [options] <id>           Wait for an agent to become idle
  archive [options] <id>        Archive an agent (soft-delete)
  onboard [options]             Run first-time setup, start daemon, and print
                                pairing instructions
  start [options]               Start the local Codius daemon
  hooks <agent> <event>         Record agent hook activity
  status [options]              Show local daemon status (alias for "codius
                                daemon status")
  restart [options]             Restart local daemon (alias for "codius daemon
                                restart")
  agent                         Manage agents (advanced operations)
  daemon                        Manage the Codius daemon
  hub                           Manage this daemon's Codius Hub relationship
  chat                          Manage chat rooms for agent coordination
  terminal                      Manage workspace terminals
  script                        Manage configured workspace scripts
  loop                          Run iterative worker loops
  schedule                      Manage recurring schedules
  heartbeat                     Manage this agent's heartbeats
  permit                        Manage permission requests
  provider                      Manage agent providers
  speech                        Speech commands
  workspace                     Manage workspaces
  help [command]                display help for command

A real command surface, not another coding agent.

Codius CLI controls the same hosts, workspaces, agents, and schedules shown in the App. It works alongside the coding agents you already use.

Install

Install from npm.

Install the standalone npm package, then connect it to the same local or paired Codius host.

Command surface

Everything needed to direct agent work.

The CLI is designed for hands-on terminal use, scripts, headless hosts, and agent-to-agent orchestration.

Start and follow agents

Create a task, attach to its output, send follow-up instructions, inspect the timeline, and wait for a structured result.

Manage isolated work

Create local or worktree workspaces, choose a branch or pull request, and keep each agent in the right working directory.

Automate recurring work

Create, pause, inspect, and run schedules from scripts or a headless host, using the same history visible in Codius App.

Operate local or paired hosts

Use the local daemon by default or target a paired host explicitly without exposing a repository through a public shell.

Handle permissions deliberately

Review pending agent permission requests and make allow or deny decisions from an automation-friendly interface.

Use the same model access

Compatible agents launched through the CLI receive the host's session-scoped Codius model defaults while explicit workspace choices still win.

One host

Move between App and terminal without splitting the work.

Codius App: See sessions, terminals, previews, diffs, schedules, and review state in a visual workspace.
Codius CLI: Start and manage the same work from a shell, CI job, script, or paired machine.
Supported agents: Choose Codex, Claude Code, OpenCode, Pi, Gemini CLI, and other verified integrations rather than being locked to one agent.
Codius Coding Plans: Connect one organization key on the host so compatible launched agents can use eligible Codius models without editing project configuration.

Local by design

The command goes to the host that owns the work.

Repository access, agent processes, terminals, and worktree operations remain on your chosen Codius host.

Local

Use the daemon on the same machine with no extra host argument.

Paired

Target a paired Codius host when you need to operate it from another device.

Agent-driven

Let one supervised agent start and coordinate additional workers through Codius.

Run Codius your way.

Start with the App, then use the same host from the terminal whenever the workflow calls for scripts, a headless machine, or faster command-line control.

Download Codius Explore CLI commands