Skip to content

README.en.md

Latest commit

 

History

History
106 lines (74 loc) · 5.63 KB

README.en.md

File metadata and controls

106 lines (74 loc) · 5.63 KB
Raw

OpenCodeSkills

License OpenCode MCP Node.js Git worktrees

Run independent OpenCode tasks in separate Git worktrees and collect verifiable results before combining their changes. The toolkit includes three native skills and a stdio MCP server that limits concurrency and returns each task's status, exit code, stdout and stderr.

Start here: Quick start · Skills · MCP setup · Parallel example · Русский

Why use it

  • Separate changes: every Git task gets its own branch and worktree.
  • Bound parallel work: up to four active runs, with timeouts and cancellation.
  • Check the result: inspect exit codes, actual output files and diffs before integration.
  • Keep commands intact: preserve PowerShell arguments and Unicode across SSH and WinRM.

Skills

Component Practical use
Parallel agents Split independent tasks, collect results and integrate inspected changes
PowerShell invocation Preserve arguments and Unicode across PowerShell, SSH and WinRM
GitHub CI debugging Read failed GitHub Actions checks and find the relevant failure
OpenCode MCP server spawn, wait, result, cancel; isolated Git branches

Quick start

Requirements: Node.js 22+, Git, the OpenCode CLI and an authenticated provider that supports the server's configured model. The CI debugging skill also needs Python 3.10+ and authenticated GitHub CLI (gh).

Run these commands from the project that will receive the skills:

git clone https://github.com/krotname/OpenCodeSkills.git
mkdir -p .opencode/skills
cp -R OpenCodeSkills/opencode-parallel-agents OpenCodeSkills/powershell-invocation OpenCodeSkills/gh-fix-ci .opencode/skills/
node OpenCodeSkills/scripts/verify.mjs
PowerShell 
git clone https://github.com/krotname/OpenCodeSkills.git
New-Item -ItemType Directory -Path .opencode/skills -Force | Out-Null
Copy-Item -Recurse -Path OpenCodeSkills/opencode-parallel-agents, OpenCodeSkills/powershell-invocation, OpenCodeSkills/gh-fix-ci -Destination .opencode/skills
node OpenCodeSkills/scripts/verify.mjs

The checks use a deterministic CLI stand-in and make no model calls. Copy the complete skill folders, including the gh-fix-ci helper and its license. For a global installation, use ~/.config/opencode/skills as the destination.

The parallel agents skill also needs the MCP server configured. The other skills can be used independently. The same stdio server works with compatible MCP clients.

How parallel tasks work

flowchart LR
    C[Coordinator] --> M[OpenCode MCP server]
    M --> A[Task A: branch + worktree A]
    M --> B[Task B: branch + worktree B]
    A --> RA[Exit code + artifact + diff A]
    B --> RB[Exit code + artifact + diff B]
    RA --> V[Inspect and integrate]
    RB --> V
Loading

Start both tasks with spawn before waiting for either one. Use wait to follow a run, result to inspect its status and output, and cancel to stop that exact run. Tool inputs and results.

Try the parallel example

cd OpenCodeSkills
node examples/parallel-demo.mjs

The demo makes two real model calls in distinct worktrees, prints the run IDs and directories, and verifies these artifacts:

Artifact Verified content
parallel-demo.txt PARALLEL_TEXT_OK
parallel-demo.json {"ok":true,"task":"parallel-json"}

Read the MCP setup before the demo. The server selects free models and switches after provider errors or limits. GPT‑6.1 Sol requires local authorization with an expiry; requests cannot change this policy. Exhausting the fallback chain is reported as a failed run.

Integration boundaries

  • Worktrees start from committed HEAD; uncommitted changes are not copied.
  • Child commits are not merged automatically. Inspect the diff and artifacts first.
  • Non-Git directories have a single-writer lock.
  • Keep each returned worktree while its artifacts are needed.

Updates and contributions

Found a reproducible problem? Open an issue with the command, expected result and actual result. Small, focused pull requests are welcome.

This repository is a curated export maintained from a private source. Only explicitly selected files enter the public history; export checks run before publication. Changes to exported files are reconciled with the source before the next export, so an export stops rather than overwriting an independent edit.

License and maintainer

Apache-2.0. Bundled upstream licenses and attribution are retained in NOTICE and gh-fix-ci/LICENSE.txt.

Maintained by Andrei Ovcharenko (@krotname).