CLI reference

Watch AI coding agent sessions across your machines and projects.

This page is generated from the command tree that driga --help prints, so it matches the binary built from the same commit. Run driga <command> --help for the same text in a terminal.

Running driga with no command runs driga summary.

Exit codes: 0 success; 1 failure, refusal or partial completion; 2 invalid usage or missing required non-interactive input. A command that needs confirmation exits 2 when stdin is not a terminal unless --yes is passed.

Global flags

Flag	Default	Description
`-h, --help`		Show context-sensitive help.
`--version`		Print the driga version.

Commands

Command	Description
`driga summary`	Show a one-screen summary. Bare driga opens top in a terminal.
`driga flow`	Show a session family and its state signals.
`driga agents`	List agents grouped by family.
`driga projects`	List project status.
`driga inbox`	List attention and completion events.
`driga orphans`	List orphan process trees.
`driga machines`	List known machines and their connection health.
`driga cleanup`	Inspect and explicitly clean local agent disk candidates.
`driga top`	Open the interactive session viewer.
`driga web`	Serve the interactive browser dashboard on loopback.
`driga ask`	Ask a one-shot Chat question through Claude and driga’s read-only tools.
`driga mcp`	Serve read-only MCP tools over stdio.
`driga doctor`	Check setup and collection health.
`driga init`	Guide optional setup.
`driga config`	Inspect or edit configuration.
`driga collect`	Run the collector (what launchd runs).
`driga service`	Manage the collector service.
`driga hooks`	Manage agent hooks.
`driga fleet`	Inspect fleet identity, serving status and viewers.
`driga version`	Print the driga version.

driga summary

Show a one-screen summary. Bare driga opens top in a terminal.

driga summary [flags]

Flag	Default	Description
`--machine=<machine>`	`all`	Scope to a machine name, ID, device-ID prefix, local, or all.
`--project=<project>`		Scope to one project (path, name, or dot).
`--since=<since>`		Only show items since a duration ago or yesterday.
`--snapshot`		Force one-shot snapshot collection without history.
`--json`		Print versioned JSON instead of tables.
`--no-color`		Disable colors.

driga flow

Show a session family and its state signals.

driga flow [<session-id>] [flags]

Argument	Default	Description
`[<session-id>]`		Internal session ID (defaults to most recently active live interactive session).

Flag	Default	Description
`--machine=<machine>`	`all`	Scope to a machine name, ID, device-ID prefix, local, or all.
`--project=<project>`		Scope to one project (path, name, or dot).
`--since=<since>`		Only show items since a duration ago or yesterday.
`--snapshot`		Force one-shot snapshot collection without history.
`--json`		Print versioned JSON instead of tables.
`--no-color`		Disable colors.
`--minutes=<minutes>`	`60`	Time window: 15, 60 or 240 minutes.

driga agents

List agents grouped by family.

Without a subcommand, runs driga agents list.

Subcommand	Description
`driga agents list`	List agents grouped by family.
`driga agents show`	Show one session by session ID.
`driga agents jump`	Confirm and jump to a local session.
`driga agents kill`	Confirm and terminate a local idle session.

driga agents list

List agents grouped by family.

driga agents list [flags]

Flag	Default	Description
`--machine=<machine>`	`all`	Scope to a machine name, ID, device-ID prefix, local, or all.
`--project=<project>`		Scope to one project (path, name, or dot).
`--since=<since>`		Only show items since a duration ago or yesterday.
`--snapshot`		Force one-shot snapshot collection without history.
`--json`		Print versioned JSON instead of tables.
`--no-color`		Disable colors.
`--all`		Include sessions ended within the last 24 hours.

driga agents show

Show one session by session ID.

driga agents show <session-id> [flags]

Argument	Default	Description
`<session-id>`		Internal session ID.

Flag	Default	Description
`--machine=<machine>`	`all`	Scope to a machine name, ID, device-ID prefix, local, or all.
`--project=<project>`		Scope to one project (path, name, or dot).
`--snapshot`		Force one-shot snapshot collection without history.
`--json`		Print versioned JSON instead of tables.
`--no-color`		Disable colors.

driga agents jump

Confirm and jump to a local session.

driga agents jump <session-id> [flags]

Argument	Default	Description
`<session-id>`		Internal session ID.

Flag	Default	Description
`-y, --yes`		Jump without asking for confirmation.

driga agents kill

Confirm and terminate a local idle session.

driga agents kill <session-id> [flags]

Argument	Default	Description
`<session-id>`		Internal session ID.

Flag	Default	Description
`--force`		Escalate survivors to SIGKILL (TerminateProcess on Windows); use —yes to skip confirmation.
`-y, --yes`		Skip confirmation; identity and idle checks still apply.

driga projects

List project status.

Without a subcommand, runs driga projects list.

Subcommand	Description
`driga projects list`	List project status.
`driga projects show`	Show project status, worktrees and sessions.
`driga projects summarize`	Refresh opt-in local project summaries through Claude.

driga projects list

List project status.

driga projects list [flags]

Flag	Default	Description
`--machine=<machine>`	`all`	Scope to a machine name, ID, device-ID prefix, local, or all.
`--project=<project>`		Scope to one project (path, name, or dot).
`--since=<since>`		Only show items since a duration ago or yesterday.
`--snapshot`		Force one-shot snapshot collection without history.
`--json`		Print versioned JSON instead of tables.
`--no-color`		Disable colors.
`--at-risk`		Only show projects with risk flags.
`--active`		Only show active projects.

driga projects show

Show project status, worktrees and sessions.

driga projects show <project> [flags]

Argument	Default	Description
`<project>`		Repository name or path.

Flag	Default	Description
`--machine=<machine>`	`all`	Scope to a machine name, ID, device-ID prefix, local, or all.
`--snapshot`		Force one-shot snapshot collection without history.
`--json`		Print versioned JSON instead of tables.
`--no-color`		Disable colors.

driga projects summarize

Refresh opt-in local project summaries through Claude.

driga projects summarize [<project>...] [flags]

Argument	Default	Description
`[<project> ...]`		Local project names or paths; requires names or —all.

Flag	Default	Description
`--json`		Print versioned JSON instead of tables.
`--all`		Summarize every collected local project.

driga inbox

List attention and completion events.

Without a subcommand, runs driga inbox list.

Subcommand	Description
`driga inbox list`	List inbox events.
`driga inbox ack`	Explicitly acknowledge inbox events.
`driga inbox jump`	Jump to a local inbox item without acknowledging it.

driga inbox list

List inbox events.

driga inbox list [flags]

Flag	Default	Description
`--machine=<machine>`	`all`	Scope to a machine name, ID, device-ID prefix, local, or all.
`--project=<project>`		Scope to one project (path, name, or dot).
`--since=<since>`		Only show items since a duration ago or yesterday.
`--snapshot`		Force one-shot snapshot collection without history.
`--json`		Print versioned JSON instead of tables.
`--no-color`		Disable colors.
`--all`		Show all history, including acknowledged and ended events (default: current waits and up to 50 completions from 24h).

driga inbox ack

Explicitly acknowledge inbox events.

driga inbox ack [<item-id>] [flags]

Argument	Default	Description
`[<item-id>]`		Inbox item ID.

Flag	Default	Description
`--machine=<machine>`	`all`	Scope to a machine name, ID, device-ID prefix, local, or all.
`--all`		Acknowledge every unacknowledged item.

driga inbox jump

Jump to a local inbox item without acknowledging it.

driga inbox jump <item-id>

Argument	Default	Description
`<item-id>`		Inbox item ID.

driga orphans

List orphan process trees.

Without a subcommand, runs driga orphans list.

Subcommand	Description
`driga orphans list`	List orphan candidates.
`driga orphans kill`	Confirm and terminate an orphan tree.

driga orphans list

List orphan candidates.

driga orphans list [flags]

Flag	Default	Description
`--project=<project>`		Scope candidates to one project (path, name, or dot).
`--machine=<machine>`	`all`	Scope to a machine name, ID, device-ID prefix, local, or all.
`--since=<since>`		Only show items since a duration ago or yesterday.
`--snapshot`		Force one-shot snapshot collection without history.
`--json`		Print versioned JSON instead of tables.
`--no-color`		Disable colors.

driga orphans kill

Confirm and terminate an orphan tree.

driga orphans kill [<orphan-id>] [flags]

Argument	Default	Description
`[<orphan-id>]`		Orphan candidate ID.

Flag	Default	Description
`--machine=<machine>`	`all`	Select orphan candidates from this machine, local, or all.
`--snapshot`		Collect one snapshot before selecting candidates.
`-y, --yes`		Skip confirmation; identity and idle checks still apply.
`--all`		Select all local orphan candidates; verify and confirm each unless —yes.
`--force`		Escalate survivors to SIGKILL (TerminateProcess on Windows); confirmation is still required unless —yes.

driga machines

List known machines and their connection health.

Without a subcommand, runs driga machines list.

Subcommand	Description
`driga machines list`	List known machines and connection health.
`driga machines show`	Show one machine (default: local).
`driga machines reset-id`	Regenerate the local machine identity.

driga machines list

List known machines and connection health.

driga machines list [flags]

Flag	Default	Description
`--machine=<machine>`	`all`	Scope to a machine name, ID, device-ID prefix, local, or all.
`--snapshot`		Force one-shot snapshot collection without history.
`--json`		Print versioned JSON instead of tables.
`--no-color`		Disable colors.

driga machines show

Show one machine (default: local).

driga machines show [<machine>] [flags]

Argument	Default	Description
`[<machine>]`	`local`	Machine name, ID, device-ID prefix, or local.

Flag	Default	Description
`--project=<project>`		Scope process detail to one project (path, name, or dot).
`--snapshot`		Force one-shot snapshot collection without history.
`--json`		Print versioned JSON instead of tables.
`--no-color`		Disable colors.
`--full`		Show all retained MCP trends and full process detail.

driga machines reset-id

Regenerate the local machine identity.

driga machines reset-id [flags]

Flag	Default	Description
`-y, --yes`		Apply without asking for confirmation.

driga cleanup

Inspect and explicitly clean local agent disk candidates.

Without a subcommand, runs driga cleanup list.

Subcommand	Description
`driga cleanup list`	List local disk cleanup candidates.
`driga cleanup remove`	Verify and remove selected local disk candidates.

driga cleanup list

List local disk cleanup candidates.

driga cleanup list [flags]

Flag	Default	Description
`--json`		Print versioned JSON instead of tables.
`--kind=<kind>`		Filter by worktree, scratch, or history.
`--sizes`		Walk candidate sizes on demand.
`--why`		Include worktrees that do not qualify, with reasons.

driga cleanup remove

Verify and remove selected local disk candidates.

driga cleanup remove [<candidate-id>] [flags]

Argument	Default	Description
`[<candidate-id>]`		Candidate ID to clean after confirmation.

Flag	Default	Description
`--json`		Print versioned JSON instead of tables.
`--kind=<kind>`		Filter by worktree or scratch (required with —all); history is report-only.
`--sizes`		Walk candidate sizes on demand (30s cap per walk).
`--all`		Remove ready candidates of —kind; skip candidates needing review and report failures.
`--dry-run`		Print exact commands after verification without removing anything.
`-y, --yes`		Confirm the displayed action without prompting.
`--include-ignored`		Allow listed non-regenerable ignored files for one explicit ID.

driga top

Open the interactive session viewer.

driga top [flags]

Flag	Default	Description
`--machine=<machine>`	`all`	Scope to a machine name, ID, device-ID prefix, local, or all.
`--project=<project>`		Scope to one project (path, name, or dot).
`--since=<since>`		Only show items since a duration ago or yesterday.
`--snapshot`		Force one-shot snapshot collection without history.
`--no-color`		Disable colors.
`--theme=<theme>`		TUI theme: system, light or dark (overrides ui.theme).
`--tab=<tab>`	`flow`	Initial tab: flow, projects or machines.

driga web

Serve the interactive browser dashboard on loopback.

driga web [flags]

Flag	Default	Description
`--machine=<machine>`	`all`	Scope to a machine name, ID, device-ID prefix, local, or all.
`--project=<project>`		Scope to one project (path, name, or dot).
`--since=<since>`		Only show items since a duration ago or yesterday.
`--snapshot`		Force one-shot snapshot collection without history.
`--listen=<listen>`	`127.0.0.1:0`	Loopback address and port for the dashboard.
`--open`		Open the dashboard in your browser.

driga ask

Ask a one-shot Chat question through Claude and driga’s read-only tools.

driga ask <question>... [flags]

Argument	Default	Description
`<question> ...`		One-shot Chat question using Claude and driga’s read-only tools.

Flag	Default	Description
`--machine=<machine>`	`all`	Scope to a machine name, ID, device-ID prefix, local, or all.
`--project=<project>`		Scope to one project (path, name, or dot).
`--json`		Print versioned JSON instead of tables.

driga mcp

Serve read-only MCP tools over stdio.

Read-only MCP server on stdio. Reading never acknowledges inbox items; snapshot mode has no history.

Claude Code: claude mcp add --scope user driga -- driga mcp

Codex configuration:
[mcp_servers.driga]
command = "driga"
args = ["mcp"]

driga mcp [flags]

Flag	Default	Description
`--snapshot`		Force one-shot snapshot collection for read tools (no history).

driga doctor

Check setup and collection health.

driga doctor [flags]

Flag	Default	Description
`--json`		Print versioned JSON instead of tables.

driga init

Guide optional setup.

driga init [flags]

Flag	Default	Description
`-y, --yes`		Accept each optional setup change without asking.

driga config

Inspect or edit configuration.

Subcommand	Description
`driga config path`	Print the config path.
`driga config show`	Print effective values including defaults.
`driga config edit`	Edit the config with $EDITOR (default vi).

driga config path

Print the config path.

driga config path [flags]

Flag	Default	Description
`--json`		Print versioned JSON instead of tables.

driga config show

Print effective values including defaults.

driga config show

driga config edit

Edit the config with $EDITOR (default vi).

driga config edit

driga collect

Run the collector (what launchd runs).

driga collect [flags]

Flag	Default	Description
`--serve`		Enable fleet serving alongside collection (overrides fleet.serve).
`--listen=<listen>`		Fleet private IP or interface and port (requires serving).
`--once`		Collect once into the persistent database and exit.
`--cpu-profile=<cpu-profile>`		Write a CPU profile of the collector to this file.
`--profile-for=<profile-for>`	`2m`	How long —cpu-profile records before it stops.

driga service

Manage the collector service.

Subcommand	Description
`driga service install`	Install and start the collector service.
`driga service start`	Start the collector service.
`driga service stop`	Stop the collector service.
`driga service restart`	Restart the collector service.
`driga service status`	Show collector service status.
`driga service logs`	Print collector logs.
`driga service uninstall`	Uninstall the collector service.

driga service install

Install and start the collector service.

driga service install

driga service start

Start the collector service.

driga service start

driga service stop

Stop the collector service.

driga service stop

driga service restart

Restart the collector service.

driga service restart

driga service status

Show collector service status.

driga service status

driga service logs

Print collector logs.

driga service logs [flags]

Flag	Default	Description
`-f, --follow`		Follow collector log output.

driga service uninstall

Uninstall the collector service.

driga service uninstall

driga hooks

Manage agent hooks.

Subcommand	Description
`driga hooks install`	Preview and install agent hooks.
`driga hooks uninstall`	Preview and remove Driga’s agent hooks.
`driga hooks status`	Show installed agent hooks.

driga hooks install

Preview and install agent hooks.

driga hooks install [<adapter>] [flags]

Argument	Default	Description
`[<adapter>]`	`all`	Adapter: claude, codex, copilot, or all.

Flag	Default	Description
`--dry-run`		Print the diff without writing or prompting.
`-y, --yes`		Apply without asking for confirmation.
`--otlp`		Configure optional metadata-only loopback OTLP instead of hooks.
`--traces`		Include Claude beta spans (requires —otlp).

driga hooks uninstall

Preview and remove Driga’s agent hooks.

driga hooks uninstall [<adapter>] [flags]

Argument	Default	Description
`[<adapter>]`	`all`	Adapter: claude, codex, copilot, or all.

Flag	Default	Description
`--dry-run`		Print the diff without writing or prompting.
`-y, --yes`		Apply without asking for confirmation.
`--otlp`		Configure optional metadata-only loopback OTLP instead of hooks.
`--traces`		Include Claude beta spans (requires —otlp).

driga hooks status

Show installed agent hooks.

driga hooks status [<adapter>] [flags]

Argument	Default	Description
`[<adapter>]`	`all`	Adapter: claude, codex, copilot, or all.

Flag	Default	Description
`--otlp`		Show optional loopback OTLP status.

driga fleet

Inspect fleet identity, serving status and viewers.

Subcommand	Description
`driga fleet peers`	List paired machines.
`driga fleet viewers`	List identities trusted to read this machine.
`driga fleet enroll`	Open a bounded pairing window.
`driga fleet rekey`	Regenerate identity; invalidate all pairings.
`driga fleet id`	Print this machine’s fleet device ID.
`driga fleet status`	Show the serving collector’s live state.

driga fleet peers

List paired machines.

Subcommand	Description
`driga fleet peers list`	List paired machines.
`driga fleet peers add`	Pair with a serving machine.
`driga fleet peers remove`	Remove a peer locally.

driga fleet peers list

List paired machines.

driga fleet peers list [flags]

Flag	Default	Description
`--json`		Print versioned JSON instead of tables.

driga fleet peers add

Pair with a serving machine.

driga fleet peers add <host> [flags]

Argument	Default	Description
`<host>`		Peer host[:port] (default port 7411).

Flag	Default	Description
`-y, --yes`		Skip confirmation only with —device-id identity pinning.
`--json`		Print versioned JSON instead of tables.
`--name=<name>`		Local name for the peer.
`--device-id=<device-id>`		Require this peer device ID (headless).

driga fleet peers remove

Remove a peer locally.

driga fleet peers remove <peer> [flags]

Argument	Default	Description
`<peer>`		Peer name, device ID or machine ID (removed peers with —purge).

Flag	Default	Description
`-y, --yes`		Apply without asking for confirmation.
`--purge`		Delete this peer’s cached rows.

driga fleet viewers

List identities trusted to read this machine.

Subcommand	Description
`driga fleet viewers list`	List identities trusted to read this machine.
`driga fleet viewers revoke`	Revoke a viewer immediately.

driga fleet viewers list

List identities trusted to read this machine.

driga fleet viewers list [flags]

Flag	Default	Description
`--json`		Print versioned JSON instead of tables.

driga fleet viewers revoke

Revoke a viewer immediately.

driga fleet viewers revoke <viewer> [flags]

Argument	Default	Description
`<viewer>`		Viewer name or device ID.

Flag	Default	Description
`-y, --yes`		Apply without asking for confirmation.

driga fleet enroll

Open a bounded pairing window.

driga fleet enroll [flags]

Flag	Default	Description
`-y, --yes`		Skip confirmation only with —allow-viewer identity pinning.
`--allow-ack`		Allow this viewer to acknowledge inbox items.
`--allow-viewer=<allow-viewer>`		Pre-authorize exactly this viewer device ID (headless).
`--window=<window>`		Enrollment duration (default fleet.enroll_window, at most 10m).

driga fleet rekey

Regenerate identity; invalidate all pairings.

driga fleet rekey [flags]

Flag	Default	Description
`-y, --yes`		Apply without asking for confirmation.

driga fleet id

Print this machine’s fleet device ID.

driga fleet id [flags]

Flag	Default	Description
`--json`		Print versioned JSON instead of tables.

driga fleet status

Show the serving collector’s live state.

driga fleet status [flags]

Flag	Default	Description
`--json`		Print versioned JSON instead of tables.

driga version

Print the driga version.

driga version [flags]

Flag	Default	Description
`--json`		Print versioned JSON instead of tables.