Installation

Install Claude Code

Ace is built on top of Claude Code — Anthropic's official CLI for Claude. Install it globally via npm:

npm install -g @anthropic-ai/claude-code

Authenticate with your Anthropic account after install:

claude --auth

Install Prerequisites

Ace requires the following tools on your PATH:

Bootstrap Ace

Clone the Ace repository and run the bootstrap script. This creates the local database, config directory, and installs the ace command globally.

git clone https://github.com/aceforce-dev/ace.git ~/.ace-cli
cd ~/.ace-cli
npm install
npm run bootstrap

The bootstrap script will:

• →Create ~/.ace/ config directory
• →Initialize ace.db (SQLite)
• →Register the ace global CLI command
• →Prompt you to set your default project directory

Verify the Install

Confirm everything is working:

ace --version
ace status

You should see version info and a green System Active status. If you see errors, check the Get Started guide for troubleshooting.