Ace CLI

Command-line interface for Ace, a GTD-inspired productivity assistant. Designed for integration with AI tools like Claude Code.

Installation

npm install -g ace-assistant-cli

Authentication

First, authenticate with your Ace account:

ace auth login

This opens a browser window where you can authorize the CLI. Your credentials are stored in ~/.ace/credentials.json.

Auth Commands

ace auth login     # Authenticate with Ace
ace auth logout    # Remove stored credentials
ace auth status    # Show authentication status
ace auth whoami    # Show current user

Usage

Quick Capture

ace capture "Call dentist tomorrow"
ace capture "Review PR #123" --notes "Check the test coverage"

Daily Orientation

ace orient           # Human-readable dashboard
ace orient --json    # JSON for AI consumption

Actions

ace actions list                    # List all actions
ace actions inbox                   # List inbox items
ace actions list --status active    # Filter by status
ace actions add "New task"          # Create action
ace actions complete <id>           # Mark complete
ace actions update <id> --status waiting --waiting "Bob"

Projects

ace projects list                   # List all projects
ace projects active                 # List active projects
ace projects list --domain Work     # Filter by domain
ace projects add "New Project"      # Create project
ace projects activate <id>          # Set to active
ace projects complete <id>          # Mark complete
ace projects review                 # Projects due for review

JSON Output

Add --json to any command for machine-readable output (ideal for AI tools):

ace orient --json
ace actions list --json
ace projects active --json

Environment Variables

• ACE_API_URL - Override the API URL (default: https://aceisyourassistant.com)

Links

• Ace Web App