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
Metadata
Release files for alexandria-agents 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| alexandria_agents-0.1.0.tar.gz | 179.8 kB | Without provenance | Details for alexandria_agents-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| alexandria_agents-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for alexandria_agents-0.1.0-py3-none-any.whl |
Total release size: 427.2 kB
Release files / alexandria_agents-0.1.0.tar.gz
| Download URL | alexandria_agents-0.1.0.tar.gz |
|---|---|
| Size | 179.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
416a07b8f00cb018c443d8767e9a6a8128b599eee5f377819b88bbee5a882394
|
|
BLAKE2b-256 checksum How to use checksums |
2c96d22a89b563035bdc46e842dd130a29174969a10461ddadcd8694fe646f30
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Release files / alexandria_agents-0.1.0-py3-none-any.whl
| Download URL | alexandria_agents-0.1.0-py3-none-any.whl |
|---|---|
| Size | 247.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1eab8858c8e2ce1e0966be0a85283e5cdb740b276746b17902c2c81064e2a55b
|
|
BLAKE2b-256 checksum How to use checksums |
4b9299f8b131f84548e2aed114b1bbdc275d8e3dd35614e536769c492fcd2849
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Security for alexandria-agents 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.