alexandria-agents

171 expert AI agents from your terminal. Your API keys, their expertise.

Alexandria provides battle-tested agent prompts that transform any LLM into domain specialists — product managers, copywriters, engineers, designers, traders, and more. Like the ancient Library of Alexandria, we collect the world's knowledge — but for AI agents.

Quick Start

npx alexandria-agents

Or install globally:

npm install -g alexandria-agents
alexandria setup

The setup wizard takes 30 seconds: pick your LLM provider, enter your API key, done.

Usage

# Describe what you need — Alexandria picks the best agents
alexandria ask --task "Design a marketing funnel for a B2B SaaS product"

# See the plan without executing
alexandria ask --task "Create a go-to-market strategy" --plan-only

# Run a specific agent directly
alexandria run brand-copywriter --task "Write a tagline for a fitness app"

# Use a specific provider
alexandria run product-designer --task "Design a checkout flow" --provider openai

# List all agents
alexandria agents

# Filter by team
alexandria agents --team marketing

# Agent details
alexandria info edge-detector

# Set project context (injected into every run)
alexandria context set "We're building FitPal, a fitness app for millennials"

ask — The Smart Way

ask uses the GM (General Manager) to analyze your task, select the best agents, and run them in sequence. Each step builds on the previous one, and learnings from past executions are automatically applied.

alexandria ask --task "Review our landing page for conversion optimization" --max-agents 3

Providers

| Provider | Models | Setup | |----------|--------|-------| | Anthropic | Claude Sonnet 4, Opus 4 | console.anthropic.com | | OpenAI | GPT-4o, o1, o3 | platform.openai.com | | Google | Gemini 2.0 Flash/Pro | aistudio.google.com | | Groq | Llama 3.3 70B | console.groq.com | | Mistral | Mistral Large | console.mistral.ai |

Teams & Agents

| Team | Agents | Examples | |------|--------|----------| | Product | 28 | product-designer, ab-test-designer, roadmap-architect | | Marketing | 15 | seo-strategist, content-strategist, conversion-rate-optimizer | | Career | 12 | cv-writer, interview-coach, salary-negotiator | | Customer Service | 12 | support-agent, onboarding-specialist | | Sales | 8 | cold-outreach-architect, objection-handler | | Branding | 8 | brand-guardian, brand-copywriter | | Fitness & Health | 8 | movement-coach, nutrition-architect | | Content Creation | 8 | hook-architect, story-weaver | | Legal | 6 | contract-reviewer, privacy-policy-writer | | Finance | 6 | financial-modeler, budget-analyst | | Design | 6 | ui-designer, ux-researcher | | Engineering | 6 | code-reviewer, devops-architect | | Research | 6 | research-synthesizer, methodology-advisor | | Writing | 6 | technical-writer, blog-content-writer | | Testing | 4 | qa-engineer, security-auditor | | Trading | 3 | edge-detector, risk-assessor |

Cloud Connect (Optional)

Connect to Alexandria Cloud for shared learnings and team sync:

alexandria connect

Authenticates via GitHub. Your prompts and outputs are never stored — only anonymized performance metrics.

Self-hosted users can point to their own instance:

alexandria config set ALEXANDRIA_API_URL https://your-instance.example.com

Programmatic API

import { runAgent, listAgents } from 'alexandria-agents';

// Run an agent
const result = await runAgent({
  agentName: 'brand-copywriter',
  task: 'Write a tagline for a todo app',
  provider: 'anthropic',
});
console.log(result.content);

// List agents
const agents = listAgents({ team: 'marketing' });

Configuration

Config is stored at ~/.alexandria/config.json (shared with the Python CLI).

alexandria config list          # Show all config
alexandria config set KEY val   # Set a value
alexandria config get KEY       # Get a value
alexandria status               # Show overall status

Requirements

• Node.js 18+
• An API key from any supported LLM provider

License

MIT — Alexandria