> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blocks.team/llms.txt
> Use this file to discover all available pages before exploring further.

# Sisyphus (Oh My OpenCode)

> Multi-agent orchestration system with specialized agents for complex tasks

## Overview

Sisyphus, powered by Oh My OpenCode, is an advanced orchestration layer that manages multiple specialized agents working together. It features a main conductor agent (Claude Opus 4.5) coordinating with specialized agents including Oracle (GPT-5) for strategic planning and architecture decisions. Sisyphus excels at complex multi-agent workflows.

<Warning>
  Sisyphus is currently **experimental** and uses sophisticated multi-agent orchestration that may behave differently than single-agent systems.
</Warning>

## Latest Models

Sisyphus uses a multi-agent architecture with specialized models currently supported in Blocks:

* **Main Conductor**: Claude Opus 4.5 - Orchestrates all agents and handles coordination
* **Oracle Agent**: GPT-5 - Strategic planning and architecture decisions
* **Backend Specialist**: Claude Sonnet 4.5 - API and database work

<Note>
  Each agent specializes in specific tasks. The Main Conductor intelligently delegates work to the most appropriate specialist agent, enabling parallel execution and domain expertise. Additional specialized agents may be added as more providers become available in Blocks.
</Note>

## Multi-Agent Orchestration

Sisyphus's power comes from coordinated agent collaboration:

1. **Task Analysis**: Main Conductor analyzes the request
2. **Work Distribution**: Tasks are delegated to specialist agents
3. **Parallel Execution**: Multiple agents work simultaneously
4. **Quality Review**: Oracle validates architectural decisions
5. **Integration**: Main Conductor synthesizes results

This approach is particularly effective for:

* Large refactoring across multiple files
* Full-stack feature implementation
* Architecture design with code generation
* Complex debugging requiring multiple perspectives

## Authentication

Sisyphus requires API keys for the underlying model providers:

<Tabs>
  <Tab title="Anthropic API Key">
    **Required for Main Conductor and Backend Specialist**

    1. Get an API key at [Anthropic Console](https://console.anthropic.com/)
    2. Set the environment variable: `ANTHROPIC_API_KEY=sk-ant-...`
    3. In [Blocks Dashboard](https://blocks.team), go to **Dashboard** → **Agents**
    4. Select **Sisyphus** and configure Anthropic authentication
  </Tab>

  <Tab title="OpenAI API Key">
    **Required for Oracle Agent**

    1. Get an API key at [OpenAI Platform](https://platform.openai.com/api-keys)
    2. Set the environment variable: `OPENAI_API_KEY=sk-...`
    3. Configure in Blocks Dashboard → **Agents** → **Sisyphus**
    4. Enable Oracle agent for strategic planning tasks
  </Tab>

  <Tab title="Combined Setup">
    **Recommended for full capabilities**

    For the complete Sisyphus experience, configure both:

    * `ANTHROPIC_API_KEY` for Claude models
    * `OPENAI_API_KEY` for Oracle agent

    This enables all specialist agents and provides maximum flexibility in task delegation.
  </Tab>
</Tabs>

## Using Sisyphus

Sisyphus is experimental and cannot be set as a default agent. Use the `/sisyphus` slash command to invoke it:

```
@blocks /sisyphus implement a full-stack feature with tests and docs
@blocks /sisyphus refactor the entire auth system
```

<Tip>
  Sisyphus shines with complex requests like "refactor the entire auth system" or "add a new feature with frontend, backend, tests, and documentation." The multi-agent system handles complexity better than single agents.
</Tip>

<Note>
  As an experimental agent, Sisyphus must be explicitly invoked with the `/sisyphus` command and cannot be used as your default agent.
</Note>

## Best For

* Complex multi-file refactoring
* Full-stack feature implementation
* Architecture design and planning
* Large-scale codebase transformations
* Projects requiring multiple areas of expertise
* Strategic code reviews with Oracle agent validation
* Claude Code compatibility (drop-in replacement)

## Cost

Sisyphus uses multiple API providers currently supported in Blocks:

* **Anthropic API**: Billed for Claude Opus 4.5 and Sonnet 4.5 usage
* **OpenAI API**: Billed for GPT-5 (Oracle agent) usage

Check pricing at:

* [Anthropic Pricing](https://www.anthropic.com/pricing)
* [OpenAI Pricing](https://openai.com/pricing)

<Warning>
  Sisyphus may use more tokens than single-agent systems due to multi-agent coordination. However, it often completes complex tasks faster and with higher quality, potentially reducing overall cost through efficiency.
</Warning>

## Experimental Status

As an experimental feature, Sisyphus is actively evolving:

* Multi-agent orchestration is a cutting-edge approach
* Agent delegation strategies are being refined
* New specialist agents may be added
* Performance optimizations are ongoing
* Feedback helps improve the system

The orchestration layer represents the future of AI coding assistants, where specialized expertise combines for superior results.

## Next Steps

<CardGroup cols={2}>
  <Card title="Claude Code" icon="brain" href="/using-blocks/agents/claude-code">
    Learn about Claude Code compatibility
  </Card>

  <Card title="OpenCode Agent" icon="globe" href="/using-blocks/agents/opencode">
    Explore OpenCode's architecture
  </Card>
</CardGroup>