Featured image of post OpenCode Beginner to Advanced: A Complete Guide to Parallel Scheduling and Usage Tips

OpenCode Beginner to Advanced: A Complete Guide to Parallel Scheduling and Usage Tips

๐Ÿ“‹ Table of Contents


๐Ÿ“Œ Key Points Summary

Feature One-Line Description
Session Parallelism OpenCode’s killer feature โ€” multiple tasks running simultaneously, no interference, double efficiency
Ultra Work Mode Type ULW, the main agent auto-breaks tasks and dispatches sub-agents to work in parallel
@ Designate Agent Let the frontend expert do frontend, the architect do reviews โ€” everyone does what they’re best at
Timeline Time Machine Roll back to any historical checkpoint anytime, zero-cost experimentation
Ralph Loop Let AI work in loops for hours, tackling the hardest tasks

1. Session Parallelism: Let AI Handle Multiple Tasks Simultaneously

This is OpenCode’s greatest differentiating advantage over other AI programming tools. Traditional tools can only work sequentially โ€” one task must finish before the next begins. OpenCode can run multiple Sessions simultaneously without interference.

Basic Operations

1
2
3
4
/new              # Create a new Session
/sessions         # View all Session statuses (spinning = running)
/session <id>     # Switch to a specific Session
/session prev     # Return to the previous Session

Real-World Scenario

Suppose you’re developing a “Draw and Guess” game with two independent requirements:

  • Requirement A: Add a timer that starts on first brush stroke, game fails after 20 seconds
  • Requirement B: Brush color adjustment

Traditional Approach

Finish A first, then B โ†’ Requirement B waits 5-10 minutes for nothing.

OpenCode Approach

1
2
3
4
5
6
7
1. Enter requirement A, AI starts working
2. Enter /new, create a new Session
3. Enter requirement B, AI starts working
4. Enter /sessions to check progress:

   Session 1  โ—  Adding timer logic...
   Session 2  โ—  Adding color picker...

Both requirements developed in parallel, total time compressed from 15 minutes to 8 minutes.

Notes

  • โš ๏ธ Sessions are completely isolated โ€” modifying the same file may cause conflicts, assign to different modules
  • โš ๏ธ Background Sessions don’t auto-notify completion, manually check with /sessions
  • โœ… You can /new anytime to open a third, fourth… no limit

2. Ultra Work: One-Click AI Programming Team

If Session parallelism is “manual transmission,” then Ultra Work is “full self-driving.” Enter a magic word and AI automatically splits tasks, assigns them to the most suitable agents, and executes in parallel.

Trigger Method

Include any of these keywords in your prompt:

1
2
3
ULW
ultrawork
Ultra Work

How It Works

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
Your requirement: Help me build a pet store website
        โ”‚
        โ–ผ
  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  โ”‚  Sisyphus (Main Agent)       โ”‚
  โ”‚  1. Break down โ†’ Todo List   โ”‚
  โ”‚  2. Assign subtasks          โ”‚
  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
         โ”‚          โ”‚
    โ”Œโ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”
    โ”‚ Prophet โ”‚ โ”‚ Frontendโ”‚ โ”‚ Doc Writer  โ”‚
    โ”‚ Arch.   โ”‚ โ”‚ UI Dev  โ”‚ โ”‚ Docs Gen    โ”‚
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
         โ”‚          โ”‚            โ”‚
         โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                    โ”‚
                    โ–ผ
              Complete Project Delivery
  1. Auto-split into Todo List
  2. Launch 3 background tasks running in parallel
  3. Main agent orchestrates from center
  4. Final delivery of complete project

When to Use?

Scenario Suitable Notes
Create complete project from scratch โœ… Excellent Auto-splits frontend, backend, docs
Multi-module parallel development โœ… Excellent Clear agent division of labor
Single-file small changes โŒ Not recommended Overkill, actually slower
Simple bug fix โŒ Not recommended Regular chat is faster

๐Ÿ’ก The higher the complexity, the greater Ultra Work’s value. Simple tasks get slower due to scheduling overhead.

Actual Results

Used Ultra Work mode to create a pet store website:

  • โœ… Used emojis as decorations with no image assets
  • โœ… Clean interface, smooth interactions, complete animations

3. @ Designate Agent: Let Experts Do What They Do Best

After installing Oh My OpenAgent (OMO), you have an AI programming team. Use @ to call specific agents.

Agent Capability Table

Agent Specialty Best Model Example Usage
๐Ÿง  Sisyphus Planning, task orchestration Claude Opus Complex multi-step tasks
๐Ÿ”ฎ Prophet Architecture design, code review GPT 5.5 Project structure design
๐ŸŽจ Frontend Engineer UI development, page layout Gemini 3 Pro Responsive layout optimization
๐Ÿ” Explorer Web search, research MiniMax Find latest API docs
๐Ÿ“š Librarian Literature review, doc retrieval โ€” Analyze open-source codebases
๐Ÿ“ Document Writer README, comments generation โ€” Generate project docs
๐Ÿ–ผ๏ธ Multimodal Image/PDF understanding โ€” Write code from design mockups

Usage Examples

1
2
3
4
5
6
7
@Frontend Engineer Convert this login page to responsive layout, mobile should look good too

@Prophet Review the code under src/service/, find potential performance issues

@Explorer Look up the latest usage of React 19 Server Components

@Document Writer Generate API documentation for the entire project

Switch Main Agent

Press Tab to switch the main agent for the current conversation โ€” great for extended use of a specific role.


4. Timeline Time Machine: Experiment Freely, Rollback Anytime

What’s the scariest thing in programming? Changing a ton of code, realizing the approach was wrong, and having no way back. Timeline is your undo button.

Basic Usage

1
/timeline    # List every conversation step in the current Session

Select any node:

  • Revert: Roll back both code and chat content to that point, like nothing happened
  • View: See what modifications the AI made at that time

Real-World Scenario

1
2
3
1. You had AI refactor a module โ†’ Results are unsatisfactory
2. /timeline โ†’ Select pre-refactor node โ†’ Revert
3. Code returns to pre-refactor state, try a different approach

Tips

  • ๐Ÿ• After completing a milestone, mentally note that checkpoint (which conversation step)
  • ๐Ÿ• Boldly try radical approaches โ€” one-click rollback anytime
  • ๐Ÿ• Compare two approaches: Revert to Approach A โ†’ Check results โ†’ Revert to Approach B โ†’ Compare

This is the programming version of “save/load” โ€” explore any possibility fearlessly.


5. Ralph Loop: Let AI Push Through to the End

This mode makes AI work in continuous loops until the task is truly complete. Perfect for tough tasks requiring iterative refinement.

Launch Method

1
/ralph-loop

Use Cases

1
2
3
4
5
"Refactor the entire project using the latest Spring Boot 4 standards until all test cases pass"

"Check every file under src/ for code standard violations and fix each one"

"Add complete unit tests to the project until coverage reaches 90%"

Difference from Ultra Work

Dimension Ultra Work Ralph Loop
Mechanism Parallel split, multi-agent collaboration Serial loop, continuous iteration
Best for Building from scratch, multi-module projects Refactoring, fixing, target-reaching tasks
Duration Minutes to tens of minutes Potentially hours
End point Task breakdown complete Termination condition met

โš ๏ธ Ralph Loop may run for a long time โ€” watch your API quota consumption.


6. Daily Speed Tips

1. Use /compact to Save Context

When you’ve chatted many rounds with AI and the context window is nearly full:

1
/compact

AI refines previous conversations into a summary, freeing space to continue working. No need to start a new chat and lose context.

2. Use /init to Get AI Up to Speed on New Projects

When entering a new project, have AI read through the code first:

1
/init

AI scans the entire project and generates agents.md as a system prompt. All subsequent conversations will be based on this understanding โ€” massive efficiency boost.

3. Share Your Programming Process

1
2
3
/share      # Generate a share link showing complete conversation and code changes
/unshare    # Stop sharing, link becomes invalid
/export     # Export conversation history as a file

Great for:

  • Showing colleagues how you solved a problem with AI
  • Documenting pitfalls for team reference ็ด ๆ for blog posts

4. View Available Models

1
/models    # Models marked "free" are free to use

GLM-4.7 and MiniMax-2.1 have decent programming capabilities, suitable for lightweight tasks.

5. Quick Code Paste (VS Code Plugin)

In VS Code, select a code snippet โ†’ Ctrl + Alt + K โ†’ Directly paste into OpenCode dialog.

Eliminates copy-paste switching costs, maintaining your flow state.


 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                 New Requirement              โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                   โ”‚
                   โ–ผ
          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
          โ”‚ Simple?         โ”‚
          โ””โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”˜
              โ”‚ Yes     โ”‚ No (Complex/Multi-module)
              โ–ผ         โ–ผ
    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ”‚ Regular chat โ”‚  โ”‚ Enter ULW to    โ”‚
    โ”‚ handles it   โ”‚  โ”‚ trigger Ultra   โ”‚
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ”‚ Work mode       โ”‚
                     โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                              โ”‚
                   โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                   โ”‚ Multiple independent โ”‚
                   โ”‚ subtasks?            โ”‚
                   โ””โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                       โ”‚ Yes       โ”‚ No
                       โ–ผ           โ–ผ
              โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
              โ”‚ /new open    โ”‚ โ”‚ Wait for Ultraโ”‚
              โ”‚ multiple     โ”‚ โ”‚ Work to auto  โ”‚
              โ”‚ Sessions     โ”‚ โ”‚ complete      โ”‚
              โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                     โ”‚
                     โ–ผ
              โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
              โ”‚ /sessions    โ”‚
              โ”‚ Check all    โ”‚
              โ”‚ progress     โ”‚
              โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                     โ”‚
                     โ–ผ
              โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
              โ”‚ Wrong        โ”‚
              โ”‚ direction?   โ”‚
              โ””โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                  โ”‚
                  โ–ผ
              โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
              โ”‚ /timeline โ†’  โ”‚
              โ”‚ Revert       โ”‚
              โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

One-Line Summary

Small tasks chat directly, big tasks call ULW, parallel with Sessions, mistakes get Timeline rollback, stubborn problems activate Ralph Loop.


8. A Real-World Case Study

After installing Oh My OpenAgent, I wanted to adjust agent model configuration โ€” making GitHub Copilot the primary and free OpenCode Zen the fallback.

First Attempt

Said directly in an OpenCode conversation:

“I also have your free OpenCode Zen, but I’ve already logged into GitHub Copilot โ€” help me modify it”

AI set OpenCode Zen as primary โ€” because the primary/secondary relationship wasn’t clear. โŒ

Correction

“No, GitHub Copilot should be primary, and OpenCode Zen’s built-in free model as fallback”

AI immediately corrected it, updating oh-my-openagent.json so all Agents use github-copilot/* as primary and opencode/* as fallback. โœ…

๐Ÿ’ก Lesson: When describing requirements to AI, always make the primary/secondary relationship clear โ€” “XX as primary, YY as fallback” โ€” don’t just say “add YY for me.”


๐Ÿ“š Reference: OpenCode In-Depth Guide, Oh My OpenAgent ๐Ÿ“… Note generated: 2026-05-07

comments powered by Disqus