CAMI Documentation

Your First Agent Deployment

Deploy Agents and See CAMI in Action

Now that CAMI is set up with agent sources, let's deploy agents to your first project.

Before You Begin

You should have:

  • CAMI installed (cami --version works)
  • At least one agent source added (e.g., official-agents)

Don't have a project yet? CAMI can help create one, or you can deploy to any existing directory.

Step 1: Open Your CAMI Workspace

Start Claude Code from your CAMI workspace:

bash
cd ~/cami-workspace
claude

Step 2: The Deployment Conversation

Here's an example of the conversation:

typescript
You: "I'm building a React frontend with Node.js backend. What agents should I use?"
Claude: *uses mcp__cami__list_agents to see available agents*
Claude: "Based on your stack, I recommend these agents:
  - frontend(v1.1.0) - React 19+ and Next.js specialist
  - backend(v2.0.0) - Node.js 20+ and Express expert
  - qa(v1.0.0) - Testing and quality specialist
Would you like me to deploy these to your project?"
You: "Yes, deploy them to ~/projects/my-web-app"
Claude: *uses mcp__cami__deploy_agents*
Claude: "✓ Successfully deployed 3 agents to ~/projects/my-web-app:
  - frontend.md(v1.1.0 from official-agents)
  - backend.md(v2.0.0 from official-agents)
  - qa.md(v1.0.0 from official-agents)
Created .claude/cami-manifest.yaml to track deployments.
Your project is now configured with specialized agents!"

Step 3: Understand What Happened

CAMI created the following in your project:

typescript
your-project/
└── .claude/
    ├── agents/
    │   ├── frontend.md
    │   ├── backend.md
    │   └── qa.md
    └── cami-manifest.yaml

The manifest tracks which agents are deployed, their versions, and sources. Learn more about manifests.

Step 4: Verify Deployment

Check what was deployed:

typescript
You: "What agents are deployed here?"
Claude: "This project has 3 deployed agents:
  - frontend(v1.1.0, from official-agents) ✓ up to date
  - backend(v2.0.0, from official-agents) ✓ up to date
  - qa(v1.0.0, from official-agents) ✓ up to date"

Step 5: Test Your Agents

Start a new Claude session in your project directory:

bash
cd ~/projects/my-web-app
claude

Now ask Claude to use one of your deployed agents:

typescript
You: "Use the frontend agent to create a React component for a login form"
Claude: "As your frontend specialist, I'll create a modern React login component..."

Claude automatically uses the appropriate agent based on your request!

That's It!

You've deployed your first agents. From here, explore: