CLI Reference

ace start

Start the ACE server on localhost:7777

🚀 Starting ACE server...

✅ ACE server already running (v3.0.15)
   Server: http://localhost:7777

If ACE is already running, it tells you instead of showing an error.

ace stop

Stop the running ACE server

ace status

Check server status, version, and health

📊 ACE Server Status

   Mode: Production
   Config: ~/.ace/config.json

✅ Server: Running (v3.0.15)
   URL: http://localhost:7777
   Status: healthy

ace init

Run the installation wizard to configure your database connection

Interactive wizard for setting up PostgreSQL connection (Neon, Supabase, local, etc.)

ace login

Authenticate with ACE via OAuth (opens browser)

Opens your browser to sign in. Token saved securely to ~/.ace/config.json

ace logout

Logout and clear saved credentials

ace whoami

Show current logged-in user information

ace env

Show environment variables for REST API access

Use ace env --export to output as export commands for shell scripts.

ace passport create

Create a new passport for this device

Generates a unique device fingerprint and creates a passport bound to this machine.

ace passport show

Show current passport info and status

ace passport link

Link passport to your ACE account

Opens browser to authenticate and link this device's passport to your account.

ace passport status

Check passport status and trust score

Shows if passport is linked, trust score (0-100), and device details.

ace passport revoke

Revoke the current passport (useful if device is lost/compromised)

Use --force to skip the confirmation prompt.

ace passport list

List all passports linked to your account

ace api-key create

Create a new API key

Save the key immediately - it won't be shown again.

ace api-key list

List all API keys

ace api-key delete <key-id>

Revoke and delete an API key

Use --force to skip the confirmation prompt. Get the key ID from ace api-key list.

ace api-key rotate <key-id>

Revoke an existing key and create a new one with the same description

ace config show

Show current configuration

ace config set

Set a configuration value

Available keys: db-path, db-type

ace config reset

Reset configuration to defaults

ace configure

Show current configuration (alias for "ace config show")

ace configure --remote <url>

Point the CLI at a remote ACE server instead of localhost

Useful when running ACE on a remote server or via a cloud deployment.

ace configure --local

Switch back to local mode (localhost:7777)

ace migrate

Apply pending database migrations (runs automatically on ace start)

ace mcp start

Start the MCP server (stdio transport)

Used by AI tools like Claude Desktop, Cursor, and VS Code for native integration.

ace mcp setup

Set up MCP config for AI IDEs (runs automatically during ace init)

Detects and configures Claude Desktop, Claude Code, Cursor, Gemini CLI, OpenAI Codex, and Windsurf. Use --fix to repair configs with hardcoded paths.

ace mcp config

Show MCP configuration for AI providers

Outputs JSON configuration to paste into your AI tool's settings.

ace admin reset-password

Reset a user's password

Use --password "newpass" to set directly, or omit to be prompted.

ace admin list-users

List all users in the system

ace --version

Show ACE version

ace --help

Show help and available commands