AgentCrew

Why AgentCrew?

AgentCrew lets you build a team of specialists, each with the right tools and personality for the job.

• An Architect that weighs trade-offs before a line of code is written.
• A Coder that implements cleanly — no scope creep, no over-engineering.
• A Reviewer that catches what others miss.
• A Researcher that cross-references multiple sources before drawing conclusions.
• A Browser Operator that navigates web apps, fills forms, and clicks through workflows.

Agents hand off work to each other when a task needs a different specialty. You stay in control, orchestrating the team from one interface.

When AgentCrew fits: You have a complex task that benefits from multiple perspectives — building a feature from design to deployment, researching and writing a report, or automating a multi-step workflow.

When a single assistant is enough: You need one focused conversation with no tool access or multi-agent orchestration.

Quick Start

1. Install (10 seconds)

macOS / Linux

curl -LsSf https://agentcrew.dev/install.sh | bash

Windows

powershell -ExecutionPolicy ByPass -c "irm https://agentcrew.dev/install.ps1 | iex"

pip (any platform)

pip install agentcrew-ai

2. Add an API key — or skip this step entirely

Most tools need a paid API key. AgentCrew supports several options that don't require one:

Subscription-based (no API key needed):

# OpenCode Go — curated open-source models (GLM, Kimi, MiMo, Qwen)
agentcrew chat --provider opencode_go

# ChatGPT Plus / Pro (uses Codex models)
agentcrew chatgpt-auth
agentcrew chat --provider openai_codex

# GitHub Copilot subscribers
agentcrew copilot-auth
agentcrew chat --provider github_copilot

Pay-as-you-go API keys:

export CROFAI_API_KEY="your-key"          # CrofAI — OpenAI-compatible, budget-friendly
export DEEPINFRA_API_KEY="your-key"       # DeepInfra — open models (LLaMA, Qwen, etc.)
export OPENAI_API_KEY="sk-proj-..."       # OpenAI GPT-4o
export GEMINI_API_KEY="AIza..."           # Google Gemini — free tier available

Or store keys in ~/.AgentCrew/config.json:

{
  "api_keys": {
    "CROFAI_API_KEY": "your-key",
    "OPENAI_API_KEY": "sk-proj-..."
  }
}

All supported providers:

Which provider should I pick?

If you...	Pick this
Want curated open-source models	OpenCode Go — subscription-based
Want low-cost, open-source friendly	CrofAI or DeepInfra
Have a Command Code subscription	Command Code
Have ChatGPT Plus / Pro	openai_codex — no extra cost
Have GitHub Copilot	github_copilot — no extra cost
Want a free tier to start	Google Gemini
Need fully offline / air-gapped	Custom (Ollama, llama.cpp, etc.)

3. Launch

# Desktop GUI (default)
agentcrew chat

# Terminal mode — great for SSH, tmux, low-resource environments
agentcrew chat --console

On the first launch, AgentCrew walks you through creating your first agent.

4. Create your first agent

agentcrew create-agent

Or define one manually in ~/.AgentCrew/agents.toml:

[[agents]]
name = "CodeAssistant"
description = "Helps write and review code"
tools = ["code_analysis", "file_editing", "web_search", "memory"]
system_prompt = """You are an expert software engineer.
Focus on code quality, security, and maintainability.
Today is {current_date}."""

5. Start working

> /agent Architect
> Design a clean API for a task manager.
>
> @Coding  Implement the task manager in Python using FastAPI.
>
> @Reviewer  Review the code for security issues.

The @AgentName syntax hands off a subtask to another agent. The receiving agent picks up with full context and its own specialized tools and instructions.

What's in the box?

Four ways to use AgentCrew

Job mode example:

agentcrew job --agent "CodeAssistant" \
  "Review for security issues" \
  ./src/**/*.py

A2A server example:

agentcrew a2a-server --host 0.0.0.0 --port 41241

Tools — enable only what each agent needs