Ccagents

ccagents

[](https://crates.io/crates/ccagents) [](https://docs.rs/ccagents) [](https://opensource.org/licenses/MIT) [](https://github.com/Bitropy/ccagents/actions/workflows/ci.yml)

Manage Claude Code agents in your local projects with ease

`ccagents` is a Rust CLI tool that helps you manage [Claude Code](https://claude.ai/code) agents by creating symlinks, handling configuration, and downloading agents from GitHub. It ensures your agents are portable across different environments and team members.

Features

• 🔗 Symlink-based management - Enable/disable agents without copying files
• 📦 Portable configuration - Uses relative paths in .agents.json
• 🌐 GitHub integration - Download individual agent files directly from GitHub
• 🔍 Smart diagnostics - Detect and fix broken symlinks, missing sources, and orphaned agents
• 🎨 Beautiful CLI - Colored output with clear status indicators
• ⚡ Fast & lightweight - Written in Rust for easy portability

Installation

From source (requires Rust)

# Clone the repository
git clone https://github.com/yourusername/ccagents.git
cd ccagents

# Build and install
cargo install --path .

From crates.io

cargo install ccagents

Pre-built binaries

Download the latest release for your platform from the [releases page](https://github.com/yourusername/ccagents/releases).

Quick Start

# Add an agent from a local file
ccagents add ./my-agent.md

# Add an agent from GitHub (single file only)
ccagents add https://github.com/user/repo/blob/main/agents/backend.md

# List all agents
ccagents list

# Enable/disable agents
ccagents enable my-agent.md
ccagents disable my-agent.md

# Sync agents (create/remove syml