Agents

Planner-Sisyphus Agent

Enabled by Default

The Planner-Sisyphus agent is the default agent in Oh My OpenCode. It provides intelligent planning and execution capabilities, helping you break down complex tasks and execute them systematically.

Features

• Intelligent Planning - Breaks down complex tasks into manageable steps
• Systematic Execution - Executes plans step by step with error handling
• Task Continuation - Ensures tasks are completed even after interruptions
• Context Awareness - Maintains context throughout the planning and execution process

Configuration

{
  "agents": {
    "planner-sisyphus": {
      "enabled": true,
      "replace_plan": true
    }
  }
}

Options

Librarian Agent

Optional

The Librarian agent is specialized for documentation and code exploration. It helps you find relevant code, understand codebases, and manage knowledge effectively.

Use Cases

• Finding relevant code examples and patterns
• Understanding codebase structure and organization
• Managing and organizing documentation
• Answering questions about code functionality
• Discovering related code and dependencies

Configuration

{
  "agents": {
    "librarian": {
      "enabled": true
    }
  }
}

The Librarian agent works particularly well with the Context7 MCP for accessing up-to-date documentation.

Explore Agent

Optional

The Explore agent is designed for code exploration and navigation. It helps you efficiently navigate and understand large codebases.

Features

• Code Navigation - Quickly navigate through codebases
• Pattern Discovery - Find patterns and conventions in code
• Dependency Analysis - Understand code dependencies and relationships
• Codebase Overview - Get high-level overviews of project structure

Configuration

{
  "agents": {
    "explore": {
      "enabled": true
    }
  }
}

The Explore agent is especially useful when working with unfamiliar codebases or large projects.

Oracle Agent

Optional

The Oracle agent is a question-answering agent that provides intelligent responses based on codebase context. It's designed to answer questions about your code and help you understand complex concepts.

Features

• Context-Aware Answers - Answers questions based on your codebase
• Code Explanation - Explains how code works and why it's structured that way
• Best Practices - Provides recommendations based on code analysis
• Troubleshooting - Helps diagnose and solve problems

Configuration

{
  "agents": {
    "oracle": {
      "enabled": true
    }
  }
}

The Oracle agent works well in combination with other agents for comprehensive code understanding.

Agent Configuration

Configure agents in your oh-my-opencode.json file:

Complete Example

{
  "agents": {
    "planner-sisyphus": {
      "enabled": true,
      "replace_plan": true
    },
    "librarian": {
      "enabled": true
    },
    "explore": {
      "enabled": true
    },
    "oracle": {
      "enabled": true
    }
  }
}

Configuration Locations

Agent configuration can be set in:

• .opencode/oh-my-opencode.json - Project-specific
• ~/.config/opencode/oh-my-opencode.json - User-wide

Learn More About Configuration →

Using Multiple Agents

You can enable multiple agents simultaneously. Each agent is designed to handle specific types of tasks:

Best Practices

• Start with defaults - The Planner-Sisyphus agent is enabled by default and works well for most tasks.
• Enable agents as needed - Enable additional agents based on your specific workflow needs.
• Combine agents - Different agents can work together to provide comprehensive solutions.
• Project-specific configuration - Use project-specific configuration for different agent setups per project.