Merge pull request #218 from YingqiDuan/feat/opencode-integration

feat(sleep): add OpenCode CLI backend for plain replay

Author: Yif-Yang

CHANGELOG.md

@@ -7,6 +7,12 @@ All notable changes to SkillOpt are documented here. This project adheres to
 ## [Unreleased]
 
 ### Added
+- **OpenCode CLI backend** (`--backend opencode`) for SkillOpt-Sleep model calls,
+  including plain task replay, using an installed OpenCode CLI with the user's
+  existing login and file-based global configuration. Calls parse OpenCode's
+  JSONL output and disable project configuration, tool use, external plugins,
+  and configured MCP servers. Transcript harvesting and tool-aware replay
+  remain follow-up work.
 - **GitHub Copilot CLI backend**, in two forms: `copilot_chat` (usable as both
   optimizer and target) and `copilot_exec` (target-only execution harness).
   Because the Copilot CLI carries its own sign-in, `--backend copilot` selects
@@ -86,6 +92,8 @@ All notable changes to SkillOpt are documented here. This project adheres to
   @Alphaxalchemy's #129).
 
 ### Tests
+- Add focused OpenCode backend coverage and opt-in real-CLI smoke tests for a
+  plain call and a seeded cycle-level run.
 - Strengthen SkillOpt-Sleep verifier-discipline assertions, including recorded
   scores and gate actions (thanks @Tanmay9223, #96).
 - Add focused coverage for the validation-gate decision core and edit-budget

docs/reference/cli.md

@@ -4,9 +4,9 @@
 > include the generic research `openai_compatible` backend, Sleep handoff,
 > Sleep support for non-Azure OpenAI-compatible endpoints, the Sleep
 > `--preferences` flag, the research `cursor_exec` target harness, or Cursor
-> source/backend/plugin support, Pi source/backend support, or VS Code Copilot
-> transcript harvesting; use a source install from `main` for those features
-> until the next release.
+> source/backend/plugin support, Pi source/backend support, the OpenCode Sleep
+> backend, or VS Code Copilot transcript harvesting; use a source install from
+> `main` for those features until the next release.
 
 ## Training
 
@@ -130,13 +130,14 @@ Actions are `run`, `dry-run`, `status`, `adopt`, `harvest`, `schedule`, and
 | `--project PATH` | Project used for transcript scope, targets, state, and staging (default: current directory) |
 | `--scope invoked\|all` | Harvest this project or all projects |
 | `--source claude\|codex\|copilot\|cursor\|pi\|auto` | Transcript source; `auto` keeps Codex-then-Claude precedence and does not select Copilot, Cursor, or Pi |
-| `--backend mock\|claude\|codex\|copilot\|cursor\|pi\|handoff\|azure_openai` | Replay/optimizer backend |
+| `--backend mock\|claude\|codex\|copilot\|cursor\|pi\|opencode\|handoff\|azure_openai` | Replay/optimizer backend |
 | `--model NAME` | Backend-specific model override |
 | `--cursor-home PATH` | Override `~/.cursor` for Cursor transcript harvesting |
 | `--pi-home PATH` | Parent directory containing Pi's `agent/sessions` tree (default: `~/.pi`) |
 | `--vscode-workspace-storage PATH` | Override VS Code's `User/workspaceStorage` root for Copilot transcript harvesting |
 | `--cursor-path PATH` | Path to the installed Cursor Agent CLI |
 | `--pi-path PATH` | Path to the installed Pi coding-agent CLI |
+| `--opencode-path PATH` | Path to the installed OpenCode CLI |
 | `--preferences TEXT` | House rules supplied to reflection |
 | `--lookback-hours N` | Initial transcript lookback; `0` scans all history |
 | `--max-sessions N` / `--max-tasks N` | Bound the harvested workload |
@@ -213,6 +214,54 @@ The managed `schedule` command preserves the backend but not `--source`,
 `~/.skillopt-sleep/config.json`; use an absolute `pi_path` and verify
 authentication for the scheduled account.
 
+### OpenCode backend
+
+Install and configure OpenCode using its
+[official documentation](https://opencode.ai/docs/), then confirm the CLI is
+available with `opencode --version`.
+
+`--backend opencode` runs SkillOpt's model calls for mining, plain task replay,
+judging, and reflection through an installed OpenCode CLI. It uses the user's
+existing OpenCode login, provider environment variables, and file-based global
+configuration; SkillOpt does not manage OpenCode accounts or provider
+credentials. Transcript sources remain independent, and there is not yet a
+`--source opencode` harvester.
+
+If OpenCode is on `PATH`, no path option is needed. Otherwise use
+`--opencode-path`, the `opencode_path` config key, or
+`SKILLOPT_SLEEP_OPENCODE_PATH`. Use `--model`, the `model` config key, or
+`SKILLOPT_SLEEP_OPENCODE_MODEL` to override OpenCode's configured model:
+
+```bash
+skillopt-sleep run --project "$(pwd)" \
+  --source codex --backend opencode \
+  --opencode-path /absolute/path/to/opencode \
+  --model provider/model --max-sessions 5 --max-tasks 3 --progress
+```
+
+Plain calls run from a temporary directory with project configuration, tool
+use, and external plugins disabled. Before contacting the model, SkillOpt
+discovers the resolved MCP configuration, disables every
+configured MCP server for the call, and verifies that none remains enabled. If
+that check fails, the model call is not made. Tool-aware replay is not yet
+supported.
+
+The child process keeps normal OpenCode file-based global configuration and
+data directories. SkillOpt sets `OPENCODE_CONFIG_CONTENT` for the child process
+to define the temporary agent and disable configured MCP servers. This replaces
+the user's existing value in that child process, so settings supplied only
+through that value are unavailable. Because `--pure` skips external plugins,
+authentication or provider setup that depends on one of those plugins is also
+unavailable. Calls may appear in the user's normal OpenCode session history;
+these controls are invocation settings, not complete account or process
+isolation.
+
+The managed scheduler stores the backend but not `--opencode-path`, `--model`,
+or the transcript source. Before scheduling OpenCode, put `opencode_path`,
+`model`, and `transcript_source` in `~/.skillopt-sleep/config.json` as needed.
+Prefer an absolute executable path and verify OpenCode access for the account
+that runs the scheduled job.
+
 ### Cursor source and backend
 
 `--source cursor` reads local Cursor JSONL transcripts from

docs/sleep/README.md

@@ -90,8 +90,8 @@ skillopt-sleep schedule     # install a nightly cron entry for this project
 > **Version note.** This page tracks `main`. PyPI 0.2.0 provides the base
 > commands above. Cursor source/backend/plugin support, VS Code Copilot
 > transcript harvesting, Pi source/backend support, Sleep handoff, non-Azure
-> OpenAI-compatible endpoints, and `--preferences` landed later and require a
-> source install from `main` until the next release.
+> OpenAI-compatible endpoints, the OpenCode Sleep backend, and `--preferences`
+> landed later and require a source install from `main` until the next release.
 
 The per-agent integrations below still come from the repo; the CLI above is the
 standalone, pip-only way to run a cycle. Claude Code, Codex, Cursor, Copilot, and
@@ -170,6 +170,40 @@ The managed scheduler records the backend but does not preserve `--source`,
 `~/.skillopt-sleep/config.json`. Use an absolute `pi_path` and verify the
 scheduled account's Pi authentication.
 
+### OpenCode
+
+Install and configure OpenCode using its
+[official documentation](https://opencode.ai/docs/), then confirm the CLI is
+available with `opencode --version`.
+
+`--backend opencode` sends SkillOpt's model calls for mining, plain task replay,
+judging, and reflection through an installed OpenCode CLI, using the user's
+existing login, provider environment variables, and file-based global
+configuration. Select a binary and model only when the OpenCode defaults are
+not suitable:
+
+```bash
+skillopt-sleep run --project "$(pwd)" \
+  --source codex --backend opencode \
+  --opencode-path /absolute/path/to/opencode --model provider/model
+```
+
+For plain calls, SkillOpt disables project configuration, tool use, external
+plugins, and configured MCP servers. It stops before the model call if it cannot
+confirm that every resolved MCP server is disabled. The subprocess keeps
+OpenCode's normal data directory, so calls may appear in the user's OpenCode
+session history. SkillOpt sets `OPENCODE_CONFIG_CONTENT` for the child process
+to define the temporary agent and disable configured MCP servers. This replaces
+the user's existing value in that child process, so settings supplied only
+through that value are unavailable; use file-based global configuration or
+provider environment variables instead.
+
+OpenCode transcript harvesting and tool-aware replay are not implemented yet.
+For scheduling, put `opencode_path`, `model`, and the desired
+`transcript_source` in `~/.skillopt-sleep/config.json` as needed, and verify the
+scheduled account can run OpenCode. See the
+[CLI reference](../reference/cli.md#opencode-backend) for full details.
+
 ### Cursor
 
 Cursor transcript harvesting and model execution are independent. Use

plugins/README.md

@@ -48,8 +48,8 @@ an importable `skillopt_sleep` module. Install with `uv tool install skillopt` o
 > **Version note.** This integration reference tracks `main`. PyPI 0.2.0
 > supports the base Sleep CLI, while Cursor source/backend/plugin support,
 > Pi source/backend support, handoff, Sleep support for non-Azure
-> OpenAI-compatible endpoints, and `--preferences` require a source checkout
-> from `main` until the next release.
+> OpenAI-compatible endpoints, the OpenCode Sleep backend, and `--preferences`
+> require a source checkout from `main` until the next release.
 
 ## One sleep cycle
 
@@ -93,6 +93,12 @@ optimization.
   retained for scope filtering and may appear in miner prompts sent to a real
   backend and its provider. Known secret-shaped strings in retained message text
   are redacted only as defense in depth.
+- The core `opencode` backend uses the installed OpenCode CLI for plain model
+  calls. It keeps the user's login and file-based global configuration
+  while disabling project configuration, tool use, external plugins, and
+  configured MCP servers for those calls. OpenCode transcript harvesting,
+  tool-aware replay, and a native OpenCode plugin or command are not included
+  yet.
 - Outbound prompts are not currently guaranteed to be free of secrets. Do not
   use a third-party provider on sensitive transcripts without reviewing the data
   source and the provider's retention policy.
@@ -128,13 +134,14 @@ Common implemented flags include:
 
 | Flag | Default | Purpose |
 |---|---|---|
-| `--backend mock\|claude\|codex\|cursor\|copilot\|pi\|handoff\|azure_openai` | `mock` | select who performs model calls |
+| `--backend mock\|claude\|codex\|cursor\|copilot\|pi\|opencode\|handoff\|azure_openai` | `mock` | select who performs model calls |
 | `--model NAME` | backend default | select a backend-specific model |
 | `--source claude\|codex\|copilot\|cursor\|pi\|auto` | `claude` | select the transcript source; `auto` retains Codex-then-Claude precedence and does not select Copilot, Cursor, or Pi |
 | `--cursor-home PATH` | `~/.cursor` | override the Cursor transcript home |
 | `--cursor-path PATH` | auto-detect `cursor-agent` | select the Cursor Agent CLI executable |
 | `--pi-home PATH` | `~/.pi` | select the parent directory containing `agent/sessions` |
 | `--pi-path PATH` | auto-detect `pi` | select the Pi coding-agent CLI executable |
+| `--opencode-path PATH` | `SKILLOPT_SLEEP_OPENCODE_PATH`, then `opencode` on `PATH`/`PATHEXT` | select the OpenCode CLI executable |
 | `--project PATH` | current directory | select the project and invoked harvest scope |
 | `--scope invoked\|all` | `invoked` | limit transcript harvesting |
 | `--target-skill-path PATH` | managed skill | select a specific `SKILL.md` to stage/adopt |

plugins/openclaw/run_sleep.py

@@ -43,6 +43,7 @@ def get_backend(
     codex_path="",
     pi_path="",
     cursor_path="",
+    opencode_path="",
     azure_endpoint="",
     project_dir="",
 ):
@@ -55,6 +56,7 @@ def get_backend(
         codex_path=codex_path,
         pi_path=pi_path,
         cursor_path=cursor_path,
+        opencode_path=opencode_path,
         azure_endpoint=azure_endpoint,
         project_dir=project_dir,
     )

skillopt_sleep/__main__.py

@@ -13,7 +13,7 @@
     --max-tasks N       cap mined tasks per run
     --target-skill-path PATH explicit live SKILL.md to stage/adopt
     --tasks-file PATH   reviewed TaskRecord JSON file to replay instead of harvesting
-    --backend mock|claude|codex|copilot|cursor|pi|handoff|azure_openai
+    --backend mock|claude|codex|copilot|cursor|pi|opencode|handoff|azure_openai
     --source claude|codex|copilot|copilot_cli|cursor|pi|auto
     --vscode-workspace-storage PATH
     --copilot-cli-session-store PATH
@@ -74,11 +74,12 @@ def _add_common(p: argparse.ArgumentParser) -> None:
     p.add_argument("--scope", default="", choices=["", "all", "invoked"])
     p.add_argument("--backend", default="",
                    choices=["", "mock", "claude", "codex", "copilot", "cursor", "pi",
-                            "handoff", "azure_openai"])
+                            "opencode", "handoff", "azure_openai"])
     p.add_argument("--model", default="")
     p.add_argument("--codex-path", default="", help="path to the real @openai/codex binary")
     p.add_argument("--cursor-path", default="", help="path to the Cursor Agent CLI")
     p.add_argument("--pi-path", default="", help="path to the Pi coding-agent CLI")
+    p.add_argument("--opencode-path", default="", help="path to the OpenCode CLI")
     p.add_argument("--claude-home", default="", help="override ~/.claude (also isolates state)")
     p.add_argument("--codex-home", default="", help="override ~/.codex for archived session harvest")
     p.add_argument("--cursor-home", default="", help="override ~/.cursor for Cursor session harvest")
@@ -126,6 +127,8 @@ def _cfg_from_args(args, task_meta: Dict[str, Any] | None = None) -> Any:
         overrides["pi_path"] = os.path.abspath(os.path.expanduser(args.pi_path))
     if getattr(args, "cursor_path", ""):
         overrides["cursor_path"] = os.path.abspath(os.path.expanduser(args.cursor_path))
+    if getattr(args, "opencode_path", ""):
+        overrides["opencode_path"] = os.path.abspath(os.path.expanduser(args.opencode_path))
     if getattr(args, "claude_home", ""):
         overrides["claude_home"] = os.path.abspath(args.claude_home)
     if getattr(args, "codex_home", ""):