Alexandria CLI

Run AI agents from your terminal. Alexandria provides pre-built, specialized AI agents for marketing, branding, content creation, and more.

Installation

# From source
pip install -e .

# Or with uv
uv pip install -e .

Quick Start

# Set your API key
export ANTHROPIC_API_KEY="your-key-here"
# or
export OPENAI_API_KEY="your-key-here"

# Run an agent
alexandria run brand-copywriter --task "Write a tagline for a todo app"

# List available agents
alexandria agents

# Filter by team/category
alexandria agents --team marketing

Commands

alexandria run <agent> --task "..."

Run an agent with a specific task.

# Basic usage
alexandria run brand-copywriter --task "Write a tagline for a productivity app"

# With additional context
alexandria run brand-strategist --task "Create positioning" --context "B2B SaaS for developers"

# Use OpenAI instead of Anthropic
alexandria run brand-copywriter --task "Write copy" --provider openai

# Use a specific model
alexandria run brand-copywriter --task "Write copy" --model claude-3-5-sonnet-20241022

# Raw output (no formatting)
alexandria run brand-copywriter --task "Write a tagline" --raw

alexandria agents

List all available agents.

# List all agents
alexandria agents

# Filter by category/team
alexandria agents --team marketing
alexandria agents --category branding

# Verbose output with descriptions
alexandria agents -v

alexandria info <agent>

Show detailed information about an agent.

alexandria info brand-copywriter

alexandria connect

Connect to Alexandria cloud via GitHub OAuth (for syncing learnings).

alexandria connect

alexandria status

Show current status and statistics.

alexandria status

alexandria history

View execution history.

# Last 10 executions
alexandria history

# Filter by agent
alexandria history --agent brand-copywriter

# More results
alexandria history --limit 50

alexandria sync

Sync local learnings with Alexandria cloud.

alexandria sync

Agent Categories

• branding - Brand strategy, identity, positioning
• marketing - Copywriting, SEO, ads, growth
• content-creation - Content strategy, writing
• product - Product management, UX
• engineering - Code review, architecture
• design - UI/UX, visual design
• sales - Sales strategy, outreach
• career - Resume, interview prep
• And more...

Local Storage

Alexandria stores execution history and learnings locally:

• Database: ~/.alexandria/local_learnings.db (SQLite)
• Credentials: ~/.alexandria/credentials.json

Environment Variables

• ANTHROPIC_API_KEY - Anthropic API key (for Claude models)
• OPENAI_API_KEY - OpenAI API key (for GPT models)

Development

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run a specific test
pytest tests/test_runner.py -v

License

MIT