Skip to content

Quick Start

Get from zero to semantic search in 5 minutes.

  • Node.js 18+
  • An ACECode account (sign up free)
  • A codebase to index
  1. Install the CLI

    Terminal window
    npm install -g @ace/cli
  2. Authenticate

    Create an API key in your account settings, then:

    Terminal window
    export ACE_API_KEY=ace_xxxx...

    Or add it to your shell profile for persistence.

  3. Initialize your project

    Navigate to your project root and run:

    Terminal window
    cd /path/to/your/project
    ace init

    This detects your language/framework, registers the project, and creates a .ace/ config directory.

  4. Index your codebase

    Terminal window
    ace index

    For large codebases, indexing runs in batches. You’ll see progress:

    ✅ Registered project: my-project (id: y3p768RuGnaE)
    📁 Scanning files...
    ⚡ Indexing 847 files...
    ✅ Done! 12,840 chunks · 3,210 symbols indexed in 42s
  5. Search!

    Terminal window
    ace search "how does authentication work?"