CLI API¶

The amplifier-app-cli package provides the reference CLI implementation.

Source: github.com/microsoft/amplifier-app-cli

Main Entry Point¶

The CLI entry point is amplifier_app_cli.main:main.

from amplifier_app_cli.main import main

# Run the CLI
main()

Commands¶

CLI commands are implemented in amplifier_app_cli.commands:

Command	Description
`run`	Execute prompts (single command or interactive)
`resume`	Interactively select and resume a session
`session`	Session management (list, show, resume, fork, delete, cleanup)
`bundle`	Bundle management (list, show, use, clear, current, add, remove, update)
`provider`	Provider management (install, add, list, remove, edit, test, models, manage)
`module`	Module management (list, show, add, remove, current, update, validate, override)
`source`	Source override management (add, remove, list, show)
`routing`	Model routing configuration (list, use, show, manage)
`agents`	Agent management (list, show, dirs)
`allowed-dirs`	Allowed write directory management (list, add, remove)
`denied-dirs`	Denied write directory management (list, add, remove)
`tool`	Tool management and invocation (list, info, invoke)
`notify`	Notification configuration (status, desktop, ntfy, reset)
`init`	First-run initialization wizard
`update`	Update Amplifier and modules
`version`	Show version information
`reset`	Reset Amplifier configuration

See CLI Reference for complete usage documentation.

Interactive Mode (Slash Commands)¶

In interactive REPL mode, the following slash commands are available:

Command	Description
`/mode`	Set or toggle a mode (e.g., `/mode plan`)
`/modes`	List available modes
`/save`	Save conversation transcript
`/status`	Show session status
`/clear`	Clear conversation context
`/help`	Show available commands
`/config`	Live session config — `/config [category] [disable\\|enable name]`
`/tools`	List available tools
`/agents`	List available agents
`/allowed-dirs`	Manage allowed write directories
`/denied-dirs`	Manage denied write directories
`/rename`	Rename current session
`/fork`	Fork session at turn N: `/fork [turn]`
`/skills`	List available skills
`/skill`	Load a skill (e.g., `/skill simplify`)

Shell Completion¶

Install shell completion with --install-completion. The shell is auto-detected from $SHELL:

amplifier --install-completion

Supported shells and their config files: - bash: ~/.bashrc (Linux) or ~/.bash_profile (macOS fallback) - zsh: ~/.zshrc - fish: ~/.config/fish/completions/amplifier.fish