CLI Reference

The AMOF CLI is your primary interface for workspace orchestration, AI agent interaction, infrastructure provisioning, and release management. Most commands require -e <ecosystem>.

Global Options

amof [-e <ecosystem>] <command> [options]

Flag	Description
-e <name>	Specify the ecosystem (overrides default)
--help	Show help for any command
--version	Show AMOF version

Workspace Commands

amof install

Bootstrap a workspace. Creates worktree, clones repos, generates profiles, builds codebase index.

amof -e aws-boilerplate install
amof -e aws-boilerplate install --dry-run

amof status

Show Git status of all repos. Columns: REPO, BRANCH, COMMIT, MODE (RO/RW), STATUS.

amof -e aws-boilerplate status

amof sync

Fetch and pull latest changes. Retries on transient failures with exponential backoff.

amof -e aws-boilerplate sync

amof push

Push all branches and record commit hashes for audit.

amof -e aws-boilerplate push

amof archive

Push all changes, save state to archives, delete workspace branch, preserve repo feature branches for PRs.

amof -e aws-boilerplate archive -m "OAuth2 fix complete"
amof -e aws-boilerplate archive --dry-run
amof -e aws-boilerplate archive --force

amof discard

Abandon work entirely. Deletes all feature branches and workspace state.

amof -e aws-boilerplate discard
amof -e aws-boilerplate discard --force

Ticket Commands

amof ticket start add-auth-flow    # Create feature branches
amof ticket list                   # Show all active tickets
amof ticket switch fix-db-bug      # Switch to different ticket
amof ticket end add-auth-flow      # Mark ticket complete
amof ticket end add-auth --cleanup # Also delete branches

Repository Commands

amof -e aws-boilerplate add-repo my-lib git@github.com:org/my-lib.git
amof -e aws-boilerplate add-repo ref git@github.com:org/ref.git --readonly
amof -e aws-boilerplate repo promote shared-infra  # readonly -> writable
amof -e aws-boilerplate repo cleanup               # Delete empty branches

AI Agent Commands

amof agent                                      # Interactive REPL
amof agent "Add retry logic to the API client"  # Single-shot
amof agent --plan "Analyze the auth flow"       # Read-only
amof agent --max-cost 10.00                     # Set budget
amof agent --resume                             # Resume session

Slash Command	Action
/status	Session cost and iteration count
/cost	Detailed cost breakdown
/release	Interactive version picker
/review	Quick git diff --stat
/quit	Exit the agent

Infrastructure Commands

amof -e aws-boilerplate spin deploy    # Create infrastructure
amof -e aws-boilerplate spin destroy   # Tear down

Release Management

amof release status                     # Current version info
amof release patch --alpha              # v1.2.0-alpha.1
amof release patch --alpha              # v1.2.0-alpha.2 (auto-increment)
amof release minor --alpha              # v1.3.0-alpha.1
amof release patch                      # v1.2.1 (stable)
amof release patch --dry-run            # Preview only
amof release patch --no-push            # Local only

amof release promote --beta             # alpha -> beta.1
amof release promote --rc               # beta -> rc.1
amof release promote                    # pre-release -> stable

amof release log                        # Show release history

Ecosystem Management

amof ecosystem create my-project        # Create new ecosystem
amof ecosystem list                     # List all ecosystems

Integration Commands

# Pull Requests
amof -e aws-boilerplate pr
amof -e aws-boilerplate pr --dry-run -r john.doe

# Jira
amof -e aws-boilerplate jira info PROJ-123
amof -e aws-boilerplate jira context PROJ-123

# Knowledge Base
amof -e aws-boilerplate kb pull
amof -e aws-boilerplate kb push
amof -e aws-boilerplate kb sync
amof -e aws-boilerplate kb consolidate

Diagnostics

amof check                              # Verify prerequisites
amof troubleshoot                       # Comprehensive diagnostics
amof -e aws-boilerplate manifest validate          # Validate manifest
amof -e aws-boilerplate manifest validate --strict # Strict mode

Server Commands

amof server start     # Start control plane
amof server stop      # Stop server
amof server status    # Check if running
amof server restart   # Restart server