Quick Start

Quick Start Guide

Get your first Faber agent running in 5 minutes.

Step 1: Install

npm install -g @fractary/cli

Step 2: Initialize Project

mkdir my-agents
cd my-agents
fractary faber init

This creates the project structure:

.faber/
  config.yml              # Configuration
  overlays/               # Customizations
roles/                    # Agent definitions
tools/                    # MCP servers & utilities
teams/                    # Multi-agent compositions
workflows/                # Cross-team orchestrations
deployments/              # Generated artifacts

Step 3: Create Your First Agent

fractary faber create role issue-manager --platforms github-issues,linear

This creates:

• roles/issue-manager/agent.yml - Agent definition
• roles/issue-manager/contexts/ - Context files
• roles/issue-manager/tasks/ - Task definitions

Step 4: Validate

fractary faber validate role issue-manager

Step 5: Build for Claude Code

fractary faber build claude role issue-manager

This generates:

• .claude/agents/issue-manager.md - Claude Code agent file
• Deployment artifacts in deployments/claude/

Step 6: Use Your Agent

The generated agent is ready to use in Claude Code:

1. Open your project in Claude Code
2. The agent appears in .claude/agents/issue-manager.md
3. Invoke with prompts like: “Triage this issue” or “Create a bug report”

Next Steps

• Learn core concepts →
• Explore CLI commands →
• See examples →

What You’ve Built

You now have:

• ✅ A platform-agnostic agent definition
• ✅ A working Claude Code agent
• ✅ A foundation to deploy to other frameworks

To deploy to LangGraph or CrewAI:

fractary faber build langgraph role issue-manager
fractary faber build crewai role issue-manager