Skip to content

README.md

Latest commit

 

History

History
142 lines (106 loc) · 5.63 KB

README.md

File metadata and controls

142 lines (106 loc) · 5.63 KB

🤖 opcode CC Agents

Pre-built AI agents for opcode powered by Claude Code

Browse Agents • Import Guide • Export Guide • Contribute

📦 Available Agents

Agent Model Alias Description Default Task
🎯 Git Commit Bot
🤖 bot		 Sonnet Automate your Git workflow with intelligent commit messages

Analyzes Git repository changes, generates detailed commit messages following Conventional Commits specification, and pushes changes to remote repository. Uses the sonnet alias to automatically use the latest Sonnet model.		 "Push all changes."
🛡️ Security Scanner
🛡️ shield		 Opus Advanced AI-powered Static Application Security Testing (SAST)

Performs comprehensive security audits by spawning specialized sub-agents for: codebase intelligence gathering, threat modeling (STRIDE), vulnerability scanning (OWASP Top 10, CWE), exploit validation, remediation design, and professional report generation. Uses the opus alias to automatically use the latest Opus model.		 "Review the codebase for security issues."
🧪 Unit Tests Bot
💻 code		 Opus Automated comprehensive unit test generation for any codebase

Analyzes codebase and generates comprehensive unit tests by: analyzing code structure, creating test plans, writing tests matching your style, verifying execution, optimizing coverage (>80% overall, 100% critical paths), and generating documentation. Uses the opus alias to automatically use the latest Opus model.		 "Generate unit tests for this codebase."

Available Icons

Choose from these icon options when creating agents:

  • bot - 🤖 General purpose
  • shield - 🛡️ Security related
  • code - 💻 Development
  • terminal - 🖥️ System/CLI
  • database - 🗄️ Data operations
  • globe - 🌐 Network/Web
  • file-text - 📄 Documentation
  • git-branch - 🌿 Version control

📥 Importing Agents

Method 1: Import from GitHub (Recommended)

  1. In opcode, navigate to CC Agents
  2. Click the Import dropdown button
  3. Select From GitHub
  4. Browse available agents from the official repository
  5. Preview agent details and click Import Agent

Method 2: Import from Local File

  1. Download a .opcode.json file from this repository
  2. In opcode, navigate to CC Agents
  3. Click the Import dropdown button
  4. Select From File
  5. Choose the downloaded .opcode.json file

📤 Exporting Agents

Export Your Custom Agents

  1. In opcode, navigate to CC Agents
  2. Find your agent in the grid
  3. Click the Export button
  4. Choose where to save the .opcode.json file

Agent File Format

All agents are stored in .opcode.json format with the following structure:

{
  "version": 1,
  "exported_at": "2025-01-23T14:29:58.156063+00:00",
  "agent": {
    "name": "Your Agent Name",
    "icon": "bot",
    "model": "sonnet|opus",
    "system_prompt": "Your agent's instructions...",
    "default_task": "Default task description"
  }
}

🔧 Technical Implementation

How Import/Export Works

The agent import/export system is built on a robust architecture:

Backend (Rust/Tauri)

  • Storage: SQLite database stores agent configurations
  • Export: Serializes agent data to JSON with version control
  • Import: Validates and deduplicates agents on import
  • GitHub Integration: Fetches agents via GitHub API

Frontend (React/TypeScript)

  • UI Components:
    • CCAgents.tsx - Main agent management interface
    • GitHubAgentBrowser.tsx - GitHub repository browser
    • CreateAgent.tsx - Agent creation/editing form
  • File Operations: Native file dialogs for import/export
  • Real-time Updates: Live agent status and execution monitoring

Key Features

  1. Version Control: Each agent export includes version metadata
  2. Duplicate Prevention: Automatic naming conflict resolution
  3. Model Selection: Choose between Opus, Sonnet, and Haiku models
  4. GitHub Integration: Direct import from the official repository

🤝 Contributing

We welcome agent contributions! Here's how to add your agent:

1. Create Your Agent

Design and test your agent in opcode with a clear, focused purpose.

2. Export Your Agent

Export your agent to a .opcode.json file with a descriptive name.

3. Submit a Pull Request

  1. Fork this repository
  2. Add your .opcode.json file to the cc_agents directory
  3. Update this README with your agent's details
  4. Submit a PR with a description of what your agent does

Agent Guidelines

  • Single Purpose: Each agent should excel at one specific task
  • Clear Documentation: Write comprehensive system prompts
  • Model Aliases: Use sonnet for general purpose tasks (fast and efficient), opus for complex reasoning and advanced capabilities. Model aliases automatically use the latest version of each model family.
  • Naming: Use descriptive names that clearly indicate the agent's function

📜 License

These agents are provided under the same license as the opcode project. See the main LICENSE file for details.

Built with ❤️ by the opcode community