openagent

OpenAgent - Universal Agent Guide

Your intelligent assistant for questions, tasks, and workflows

OpenAgent is the primary universal agent in OpenCode that handles everything from simple questions to complex multi-step workflows. This guide explains how it works and how to get the most out of it.

---

Table of Contents

• What is OpenAgent?
• How It Works
• The Two Paths
• The 6-Stage Workflow
• Session Management
• Dynamic Context Loading
• When OpenAgent Delegates
• Visual Workflows
• Tips for Your Workflow

---

What is OpenAgent?

OpenAgent is your universal coordinator that:

• ✅ Answers questions - Get explanations, comparisons, and guidance
• ✅ Executes general tasks - Create files, documentation, simple updates
• ✅ Coordinates workflows - Handles most general tasks directly, delegates to specialists when needed
• ✅ Preserves context - Remembers information across multiple steps
• ✅ Keeps you in control - Always asks for approval before taking action

Think of OpenAgent as a smart project coordinator who:

• Understands what you need
• Plans how to do it
• Asks for your approval
• Executes the plan (directly or via delegation)
• Confirms everything is done right

Note: For complex multi-file coding work, architecture analysis, or deep refactoring, use opencoder instead. OpenAgent is optimized for general tasks and coordination, while opencoder specializes in development work.

---

How It Works

The Simple Version

graph LR
    A[You Ask] --> B{Question or Task?}
    B -->|Question| C[Get Answer]
    B -->|Task| D[See Plan]
    D --> E[Approve Plan]
    E --> F[Watch Execution]
    F --> G[Confirm Done]
    
    style A fill:#4A90E2,stroke:#2E5C8A,stroke-width:3px,color:#000
    style B fill:#F5A623,stroke:#C17D11,stroke-width:3px,color:#000
    style C fill:#7ED321,stroke:#5FA319,stroke-width:3px,color:#000
    style D fill:#50E3C2,stroke:#3AB89E,stroke-width:3px,color:#000
    style E fill:#F5A623,stroke:#C17D11,stroke-width:3px,color:#000
    style F fill:#6B7C93,stroke:#4A5568,stroke-width:3px,color:#fff
    style G fill:#7ED321,stroke:#5FA319,stroke-width:3px,color:#000