oh-my-opencode 2.2.0 → 2.3.0

package/README.md

@@ -27,7 +27,7 @@ No stupid token consumption massive subagents here. No bloat tools here.
 [![GitHub Issues](https://img.shields.io/github/issues/code-yeongyu/oh-my-opencode?color=ff80eb&labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/issues)
 [![License](https://img.shields.io/badge/license-MIT-white?labelColor=black&style=flat-square)](https://github.com/code-yeongyu/oh-my-opencode/blob/master/LICENSE)
 
-[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md)
+[English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [简体中文](README.zh-cn.md)
 
 </div>
 
@@ -38,7 +38,7 @@ No stupid token consumption massive subagents here. No bloat tools here.
 - [Oh My OpenCode](#oh-my-opencode)
   - [Just Skip Reading This Readme](#just-skip-reading-this-readme)
     - [It's the Age of Agents](#its-the-age-of-agents)
-    - [For Those Who Want to Read](#for-those-who-want-to-read)
+    - [For Those Who Want to Read: Meet Sisyphus](#for-those-who-want-to-read-meet-sisyphus)
       - [Just Install It.](#just-install-it)
   - [Installation](#installation)
     - [For Humans](#for-humans)
@@ -58,6 +58,7 @@ No stupid token consumption massive subagents here. No bloat tools here.
     - [Verify the setup](#verify-the-setup)
     - [Say 'Congratulations! 🎉' to the user](#say-congratulations--to-the-user)
     - [Too Complicated?](#too-complicated)
+  - [Uninstallation](#uninstallation)
   - [Features](#features)
     - [Agents: Your Teammates](#agents-your-teammates)
     - [Background Agents: Work Like a Team](#background-agents-work-like-a-team)
@@ -76,10 +77,11 @@ No stupid token consumption massive subagents here. No bloat tools here.
     - [Google Auth](#google-auth)
     - [Agents](#agents)
       - [Permission Options](#permission-options)
-    - [OmO Agent](#omo-agent)
+    - [Sisyphus Agent](#sisyphus-agent)
     - [Hooks](#hooks)
     - [MCPs](#mcps)
     - [LSP](#lsp)
+    - [Experimental](#experimental)
   - [Author's Note](#authors-note)
   - [Warnings](#warnings)
 
@@ -115,22 +117,27 @@ Hand this doc to an agent and let them set it up.
   - Ask why it's good, why it's not just another boilerplate setup, what actually gets better.
   - If you're an LLM agent, explain to the user what becomes possible right now with this project.
 
-### For Those Who Want to Read
+### For Those Who Want to Read: Meet Sisyphus
 
-Welcome. Introducing OmO (Oh-Mo).
-Everything below is customizable. Take what you want.
-All features are enabled by default. You don't have to do anything. Battery Included, works out of the box.
+![Meet Sisyphus](.github/assets/sisyphus.png)
 
-- Claude Code Compatibility: Command, Agent, Skill, MCP, Hook(PreToolUse, PostToolUse, UserPromptSubmit, Stop)
-- Comment Checker: No AI-like Comments Anymore.
-- Full LSP / AstGrep Support: Explore precisely, Refactor with confidence.
-- Todo Continuation Enforcer: Forces the agent to continue if it quits halfway.
-- Curated Agents
-  - OmO: Super smart main agent (Opus 4.5 High)
+In greek mythology, Sisyphus was condemned to roll a boulder up a hill for eternity as punishment for deceiving the gods. LLM Agents haven't really done anything wrong, yet they too roll their "stones"—their thoughts—every single day.
+My life is no different. Looking back, we are not so different from these agents.
+**Yes! LLM Agents are no different from us. They can write code as brilliant as ours and work just as excellently—if you give them great tools and solid teammates.**
+
+Meet our main agent: Sisyphus (Opus 4.5 High). Below are the tools Sisyphus uses to keep that boulder rolling.
+
+*Everything below is customizable. Take what you want. All features are enabled by default. You don't have to do anything. Battery Included, works out of the box.*
+
+- Sisyphus's Teammates (Curated Agents)
   - Oracle: Design, debugging (GPT 5.2 Medium)
   - Frontend UI/UX Engineer: Frontend development (Gemini 3 Pro)
   - Librarian: Official docs, open source implementations, codebase exploration (Claude Sonnet 4.5)
   - Explore: Blazing fast codebase exploration (Contextual Grep) (Grok Code)
+- Full LSP / AstGrep Support: Refactor decisively.
+- Todo Continuation Enforcer: Forces the agent to continue if it quits halfway. **This is what keeps Sisyphus rolling that boulder.**
+- Comment Checker: Prevents AI from adding excessive comments. Code generated by Sisyphus should be indistinguishable from human-written code.
+- Claude Code Compatibility: Command, Agent, Skill, MCP, Hook(PreToolUse, PostToolUse, UserPromptSubmit, Stop)
 - Curated MCPs:
   - Exa (Web Search)
   - Context7 (Official Documentation)
@@ -158,7 +165,10 @@ If you don't want all this, as mentioned, you can just pick and choose specific
 
 ### For Humans
 
-Let the LLM Agent handle the grunt work. Paste this link and ask it to install and configure.
+Let the LLM Agent handle the grunt work. Paste this into a fresh opencode session:
+```
+Install and configure by following the instructions here https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/README.md
+```
 
 ### For LLM Agents
 
@@ -179,7 +189,7 @@ Since OpenCode Supports various models, and our plugin suggests various frontier
      ```json
      {
        "agents": {
-         "OmO": { "model": "opencode/big-pickle" },
+         "Sisyphus": { "model": "opencode/big-pickle" },
          "librarian": { "model": "opencode/big-pickle" }
        }
      }
@@ -301,13 +311,13 @@ The `opencode-antigravity-auth` plugin uses different model names than the built
   "google_auth": false,
   "agents": {
     "frontend-ui-ux-engineer": { "model": "google/gemini-3-pro-high" },
-    "document-writer": { "model": "google/gemini-3-pro-high" },
+    "document-writer": { "model": "google/gemini-3-flash" },
     "multimodal-looker": { "model": "google/gemini-2.5-flash" }
   }
 }
 ```
 
-**Available model names**: `google/gemini-3-pro-high`, `google/gemini-3-pro-medium`, `google/gemini-3-pro-low`, `google/gemini-2.5-flash`, `google/gemini-2.5-flash-lite`, `google/claude-sonnet-4-5`, `google/claude-sonnet-4-5-thinking`, `google/claude-opus-4-5-thinking`, `google/gpt-oss-120b-medium`
+**Available model names**: `google/gemini-3-pro-high`, `google/gemini-3-pro-medium`, `google/gemini-3-pro-low`, `google/gemini-3-flash`, `google/gemini-2.5-flash`, `google/gemini-2.5-flash-lite`, `google/claude-sonnet-4-5`, `google/claude-sonnet-4-5-thinking`, `google/claude-opus-4-5-thinking`, `google/gpt-oss-120b-medium`
 
 Then authenticate:
 
@@ -330,7 +340,7 @@ First, add the opencode-openai-codex-auth plugin:
 {
   "plugin": [
     "oh-my-opencode",
-    "opencode-openai-codex-auth@4.1.0"
+    "opencode-openai-codex-auth@4.1.1"
   ]
 }
 ```
@@ -400,12 +410,44 @@ That's it. The agent will figure out the rest and handle everything automaticall
 
 </details>
 
+## Uninstallation
+
+To remove oh-my-opencode:
+
+1. **Remove the plugin from your OpenCode config**
+
+   Edit `~/.config/opencode/opencode.json` (or `opencode.jsonc`) and remove `"oh-my-opencode"` from the `plugin` array:
+
+   ```bash
+   # Using jq
+   jq '.plugin = [.plugin[] | select(. != "oh-my-opencode")]' \
+       ~/.config/opencode/opencode.json > /tmp/oc.json && \
+       mv /tmp/oc.json ~/.config/opencode/opencode.json
+   ```
+
+2. **Remove configuration files (optional)**
+
+   ```bash
+   # Remove user config
+   rm -f ~/.config/opencode/oh-my-opencode.json
+
+   # Remove project config (if exists)
+   rm -f .opencode/oh-my-opencode.json
+   ```
+
+3. **Verify removal**
+
+   ```bash
+   opencode --version
+   # Plugin should no longer be loaded
+   ```
+
 
 ## Features
 
 ### Agents: Your Teammates
 
-- **OmO** (`anthropic/claude-opus-4-5`): **The default agent.** A powerful AI orchestrator for OpenCode. Plans, delegates, and executes complex tasks using specialized subagents with aggressive parallel execution. Emphasizes background task delegation and todo-driven workflow. Uses Claude Opus 4.5 with extended thinking (32k budget) for maximum reasoning capability.
+- **Sisyphus** (`anthropic/claude-opus-4-5`): **The default agent.** A powerful AI orchestrator for OpenCode. Plans, delegates, and executes complex tasks using specialized subagents with aggressive parallel execution. Emphasizes background task delegation and todo-driven workflow. Uses Claude Opus 4.5 with extended thinking (32k budget) for maximum reasoning capability.
 - **oracle** (`openai/gpt-5.2`): Architecture, code review, strategy. Uses GPT-5.2 for its stellar logical reasoning and deep analysis. Inspired by AmpCode.
 - **librarian** (`anthropic/claude-sonnet-4-5`): Multi-repo analysis, doc lookup, implementation examples. Uses Claude Sonnet 4.5 for deep codebase understanding and GitHub research with evidence-based answers. Inspired by AmpCode.
 - **explore** (`opencode/grok-code`): Fast codebase exploration and pattern matching. Claude Code uses Haiku; we use Grok—it's free, blazing fast, and plenty smart for file traversal. Inspired by Claude Code.
@@ -624,7 +666,12 @@ Highly opinionated, but adjustable to taste.
 
 Config file locations (priority order):
 1. `.opencode/oh-my-opencode.json` (project)
-2. `~/.config/opencode/oh-my-opencode.json` (user)
+2. User config (platform-specific):
+
+| Platform | User Config Path |
+|----------|------------------|
+| **Windows** | `%APPDATA%\opencode\oh-my-opencode.json` |
+| **macOS/Linux** | `~/.config/opencode/oh-my-opencode.json` |
 
 Schema autocomplete supported:
 
@@ -645,7 +692,7 @@ When using `opencode-antigravity-auth`, disable the built-in auth and override a
   "google_auth": false,
   "agents": {
     "frontend-ui-ux-engineer": { "model": "google/gemini-3-pro-high" },
-    "document-writer": { "model": "google/gemini-3-pro-high" },
+    "document-writer": { "model": "google/gemini-3-flash" },
     "multimodal-looker": { "model": "google/gemini-2.5-flash" }
   }
 }
@@ -679,7 +726,7 @@ Override built-in agent settings:
 
 Each agent supports: `model`, `temperature`, `top_p`, `prompt`, `tools`, `disable`, `description`, `mode`, `color`, `permission`.
 
-You can also override settings for `OmO` (the main orchestrator) and `build` (the default agent) using the same options.
+You can also override settings for `Sisyphus` (the main orchestrator) and `build` (the default agent) using the same options.
 
 #### Permission Options
 
@@ -717,16 +764,16 @@ Or disable via `disabled_agents` in `~/.config/opencode/oh-my-opencode.json` or
 
 Available agents: `oracle`, `librarian`, `explore`, `frontend-ui-ux-engineer`, `document-writer`, `multimodal-looker`
 
-### OmO Agent
+### Sisyphus Agent
 
-When enabled (default), OmO adds two primary agents and demotes the built-in agents to subagents:
+When enabled (default), Sisyphus adds two primary agents and demotes the built-in agents to subagents:
 
-- **OmO**: Primary orchestrator agent (Claude Opus 4.5)
-- **OmO-Plan**: Inherits all settings from OpenCode's plan agent at runtime (description appended with "OhMyOpenCode version")
+- **Sisyphus**: Primary orchestrator agent (Claude Opus 4.5)
+- **Planner-Sisyphus**: Inherits all settings from OpenCode's plan agent at runtime (description appended with "OhMyOpenCode version")
 - **build**: Demoted to subagent
 - **plan**: Demoted to subagent
 
-To disable OmO and restore the original build/plan agents:
+To disable Sisyphus and restore the original build/plan agents:
 
 ```json
 {
@@ -736,16 +783,16 @@ To disable OmO and restore the original build/plan agents:
 }
 ```
 
-You can also customize OmO and OmO-Plan like other agents:
+You can also customize Sisyphus and Planner-Sisyphus like other agents:
 
 ```json
 {
   "agents": {
-    "OmO": {
+    "Sisyphus": {
       "model": "anthropic/claude-sonnet-4",
       "temperature": 0.3
     },
-    "OmO-Plan": {
+    "Planner-Sisyphus": {
       "model": "openai/gpt-5.2"
     }
   }
@@ -754,7 +801,7 @@ You can also customize OmO and OmO-Plan like other agents:
 
 | Option     | Default | Description                                                                                                                                   |
 | ---------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
-| `disabled` | `false` | When `true`, disables OmO agents and restores original build/plan as primary. When `false` (default), OmO and OmO-Plan become primary agents. |
+| `disabled` | `false` | When `true`, disables Sisyphus agents and restores original build/plan as primary. When `false` (default), Sisyphus and Planner-Sisyphus become primary agents. |
 
 ### Hooks
 
@@ -809,6 +856,28 @@ Add LSP servers via the `lsp` option in `~/.config/opencode/oh-my-opencode.json`
 
 Each server supports: `command`, `extensions`, `priority`, `env`, `initialization`, `disabled`.
 
+### Experimental
+
+Opt-in experimental features that may change or be removed in future versions. Use with caution.
+
+```json
+{
+  "experimental": {
+    "aggressive_truncation": true,
+    "empty_message_recovery": true,
+    "auto_resume": true
+  }
+}
+```
+
+| Option                   | Default | Description                                                                                                                                                                                  |
+| ------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `aggressive_truncation`  | `false` | When token limit is exceeded, aggressively truncates tool outputs to fit within limits. More aggressive than the default truncation behavior. Falls back to summarize/revert if insufficient. |
+| `empty_message_recovery` | `false` | Automatically recovers from "non-empty content" API errors by fixing empty messages in the session. Up to 3 recovery attempts before giving up.                                              |
+| `auto_resume`            | `false` | Automatically resumes session after successful recovery from thinking block errors or thinking disabled violations. Extracts the last user message and continues.                            |
+
+**Warning**: These features are experimental and may cause unexpected behavior. Enable only if you understand the implications.
+
 
 ## Author's Note