CLI Reference¶

Complete reference for all Amplifier command-line commands.

Global Options¶

amplifier [OPTIONS] COMMAND [ARGS]

Option	Description
`--version`	Show version and exit
`--help`	Show help and exit
`--install-completion`	Install shell completion for the specified shell (bash, zsh, or fish)

Core Commands¶

`run`¶

Execute a prompt or start an interactive session.

amplifier run [OPTIONS] PROMPT

Option	Description
`--bundle, -B`	Bundle to use for this session
`--provider, -p`	LLM provider (anthropic, openai, etc.)
`--model, -m`	Specific model to use
`--max-tokens`	Maximum output tokens
`--mode`	Execution mode: `chat`, `single` (default: single)
`--output-format`	Output format: `text`, `json`, `json-trace` (default: text)
`--resume`	Resume specific session with new prompt
`--verbose, -v`	Verbose output

Examples:

# Basic usage
amplifier run "Explain this code"

# With options
amplifier run --bundle dev --model claude-opus-4-6 "Complex task"

# JSON output for scripting
amplifier run --output-format json "What is 2+2?"

# Resume a session
amplifier run --resume abc123 "Continue from where we left off"

`continue`¶

Resume the most recent session.

amplifier continue [PROMPT]

Option	Description
`--force-bundle, -B`	Force a different bundle for this session (experimental)
`--no-history`	Skip displaying conversation history
`--full-history`	Show all messages (default: last 10)
`--replay`	Replay conversation with timing simulation
`--replay-speed, -s`	Replay speed multiplier (default: 2.0)
`--show-thinking`	Show thinking blocks in history

Examples:

# Continue with a new prompt
amplifier continue "Now add tests"

# Interactive continuation
amplifier continue

# With full history
amplifier continue --full-history "Continue from here"

`resume`¶

Interactively select and resume a session.

amplifier resume [PATTERN]

Examples:

# Interactive session picker
amplifier resume

# Search by pattern
amplifier resume auth

Session Management¶

`session list`¶

List all sessions.

amplifier session list [OPTIONS]

Option	Description
`--limit, -n`	Number of sessions to show (default: 10)
`--all`	Show all sessions
`--project`	Filter by project path

`session show`¶

Show session details.

amplifier session show SESSION_ID

`session resume`¶

Resume a specific session.

amplifier session resume SESSION_ID [PROMPT]

`session fork`¶

Fork a session at a specific turn.

amplifier session fork SESSION_ID TURN [NEW_NAME]

`session delete`¶

Delete a session.

amplifier session delete SESSION_ID

`session cleanup`¶

Clean up old sessions.

amplifier session cleanup [OPTIONS]

Option	Description
`--days`	Delete sessions older than N days (default: 30)
`--dry-run`	Show what would be deleted without deleting

Bundle Management¶

`bundle list`¶

List available bundles.

amplifier bundle list

`bundle show`¶

Show bundle details.

amplifier bundle show BUNDLE_NAME

`bundle use`¶

Set active bundle.

amplifier bundle use BUNDLE_NAME

`bundle current`¶

Show currently active bundle.

amplifier bundle current

`bundle add`¶

Add a bundle from a source.

amplifier bundle add NAME SOURCE

`bundle remove`¶

Remove a bundle.

amplifier bundle remove NAME

`bundle update`¶

Update bundle sources.

amplifier bundle update [BUNDLE_NAME]

`bundle clear`¶

Clear active bundle.

amplifier bundle clear

Provider Management¶

`provider list`¶

List configured providers.

amplifier provider list

`provider add`¶

Add a new provider.

amplifier provider add PROVIDER [OPTIONS]

`provider remove`¶

Remove a provider.

amplifier provider remove PROVIDER

`provider edit`¶

Edit provider configuration.

amplifier provider edit PROVIDER

`provider test`¶

Test provider connection.

amplifier provider test PROVIDER

`provider models`¶

List available models for a provider.

amplifier provider models PROVIDER

`provider manage`¶

Interactive provider management.

amplifier provider manage

`provider install`¶

Install a provider from source.

amplifier provider install SOURCE

Module Management¶

`module list`¶

List installed modules.

amplifier module list [TYPE]

Type	Description
`provider`	LLM providers
`tool`	Agent tools
`orchestrator`	Execution loops
`context`	Memory management
`hook`	Lifecycle hooks

`module show`¶

Show module details.

amplifier module show MODULE_NAME

`module add`¶

Add a module from source.

amplifier module add SOURCE

`module remove`¶

Remove a module.

amplifier module remove MODULE_NAME

`module current`¶

Show currently active modules.

amplifier module current

`module update`¶

Update modules.

amplifier module update [MODULE_NAME]

`module validate`¶

Validate a module.

amplifier module validate PATH

`module override`¶

Override module source.

amplifier module override MODULE SOURCE

Source Management¶

`source list`¶

List module source overrides.

amplifier source list

`source add`¶

Add a source override.

amplifier source add MODULE SOURCE

`source remove`¶

Remove a source override.

amplifier source remove MODULE

`source show`¶

Show override details.

amplifier source show MODULE

Routing Management¶

`routing list`¶

List available routing matrices.

amplifier routing list

`routing use`¶

Set active routing matrix.

amplifier routing use MATRIX_NAME

`routing show`¶

Show routing matrix details.

amplifier routing show MATRIX_NAME

`routing manage`¶

Interactive routing management.

amplifier routing manage

`routing create`¶

Create a new routing matrix.

amplifier routing create NAME

Agent Management¶

`agents list`¶

List available agents.

amplifier agents list

`agents show`¶

Show agent configuration.

amplifier agents show AGENT_NAME

`agents dirs`¶

Show agent search directories.

amplifier agents dirs

Directory Management¶

`allowed-dirs list`¶

List allowed write directories.

amplifier allowed-dirs list

`allowed-dirs add`¶

Add allowed write directory.

amplifier allowed-dirs add PATH

`allowed-dirs remove`¶

Remove allowed write directory.

amplifier allowed-dirs remove PATH

`denied-dirs list`¶

List denied write directories.

amplifier denied-dirs list

`denied-dirs add`¶

Add denied write directory.

amplifier denied-dirs add PATH

`denied-dirs remove`¶

Remove denied write directory.

amplifier denied-dirs remove PATH

Tool Management¶

`tool list`¶

List available tools.

amplifier tool list

`tool info`¶

Show tool information.

amplifier tool info TOOL_NAME

`tool invoke`¶

Invoke a tool directly.

amplifier tool invoke TOOL_NAME [PARAMS]

Notification Management¶

`notify status`¶

Show notification configuration.

amplifier notify status

`notify desktop`¶

Configure desktop notifications.

amplifier notify desktop [on|off]

`notify ntfy`¶

Configure ntfy.sh notifications.

amplifier notify ntfy [OPTIONS]

`notify reset`¶

Reset notification configuration.

amplifier notify reset

System Commands¶

`init`¶

Run first-time initialization wizard.

amplifier init

`update`¶

Update Amplifier and modules.

amplifier update [OPTIONS]

Option	Description
`--check-only`	Check for updates without installing
`--modules`	Update modules only

`version`¶

Show version information.

amplifier version

`reset`¶

Reset Amplifier configuration.

amplifier reset [OPTIONS]

Option	Description
`--confirm`	Skip confirmation prompt

Environment Variables¶

Variable	Description
`AMPLIFIER_HOME`	Override home directory (default: `~/.amplifier`)
`AMPLIFIER_BUNDLE`	Default bundle to use
`AMPLIFIER_PROVIDER`	Default provider
`AMPLIFIER_MODEL`	Default model
`AMPLIFIER_AGENT_<NAME>`	Override agent path for testing

Shell Completion¶

Install shell completion for better CLI experience:

# Auto-detect shell and install
amplifier --install-completion

# Or specify shell
amplifier --install-completion bash
amplifier --install-completion zsh
amplifier --install-completion fish

Exit Codes¶

Code	Meaning
`0`	Success
`1`	Error or failure
`2`	User cancellation

CLI Reference¶

Global Options¶

Core Commands¶

run¶

continue¶

resume¶

Session Management¶

session list¶

session show¶

session resume¶

session fork¶

session delete¶

session cleanup¶

Bundle Management¶

bundle list¶

bundle show¶

bundle use¶

bundle current¶

bundle add¶

bundle remove¶

bundle update¶

bundle clear¶

Provider Management¶

provider list¶

provider add¶

provider remove¶

provider edit¶

provider test¶

provider models¶

provider manage¶

provider install¶

Module Management¶

module list¶

module show¶

module add¶

module remove¶

module current¶

module update¶

module validate¶

module override¶

Source Management¶

source list¶

source add¶

source remove¶

source show¶

Routing Management¶

routing list¶

routing use¶

routing show¶

routing manage¶

routing create¶

Agent Management¶

agents list¶

agents show¶

agents dirs¶

Directory Management¶

allowed-dirs list¶

allowed-dirs add¶

allowed-dirs remove¶

denied-dirs list¶

denied-dirs add¶

denied-dirs remove¶

Tool Management¶

tool list¶

tool info¶

tool invoke¶

Notification Management¶

notify status¶

notify desktop¶

notify ntfy¶

notify reset¶

System Commands¶

init¶

update¶

version¶

reset¶

Environment Variables¶

Shell Completion¶

Exit Codes¶

`run`¶

`continue`¶

`resume`¶

`session list`¶

`session show`¶

`session resume`¶

`session fork`¶

`session delete`¶

`session cleanup`¶

`bundle list`¶

`bundle show`¶

`bundle use`¶

`bundle current`¶

`bundle add`¶

`bundle remove`¶

`bundle update`¶

`bundle clear`¶

`provider list`¶

`provider add`¶

`provider remove`¶

`provider edit`¶

`provider test`¶

`provider models`¶

`provider manage`¶

`provider install`¶

`module list`¶

`module show`¶

`module add`¶

`module remove`¶

`module current`¶

`module update`¶

`module validate`¶

`module override`¶

`source list`¶

`source add`¶

`source remove`¶

`source show`¶

`routing list`¶

`routing use`¶

`routing show`¶

`routing manage`¶

`routing create`¶

`agents list`¶

`agents show`¶

`agents dirs`¶

`allowed-dirs list`¶

`allowed-dirs add`¶

`allowed-dirs remove`¶

`denied-dirs list`¶

`denied-dirs add`¶

`denied-dirs remove`¶

`tool list`¶

`tool info`¶

`tool invoke`¶

`notify status`¶

`notify desktop`¶

`notify ntfy`¶

`notify reset`¶

`init`¶

`update`¶

`version`¶

`reset`¶