Opencode Mirror
Keep a local, gitignored OpenCode upstream mirror under vendor/opencode for self-reference without vendoring it into git history.
Overview
opencode-mirror is an agent skill for the Build phase that documents how to clone and fast-forward a gitignored local OpenCode mirror at vendor/opencode for self-reference.
Install
npx skills add https://github.com/different-ai/openwork --skill opencode-mirrorWhat is this skill?
- One-command mirror update: git -C vendor/opencode pull --ff-only
- Mirror must stay gitignored—never commit vendor/opencode
- --ff-only avoids merge commits in the reference clone
- First-time setup: git clone anomalyco/opencode into vendor/opencode
- Update command uses pull --ff-only on vendor/opencode
- First-time clone URL: github.com/anomalyco/opencode
Adoption & trust: 565 installs on skills.sh; 15.9k GitHub stars; 1/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need OpenCode source on disk for agent self-reference but must not commit vendor trees or pollute your repo with mirror merge commits.
Who is it for?
OpenWork or similar agent-repo maintainers who reference OpenCode locally and already use vendor/ conventions.
Skip if: Projects that should use a formal git submodule, npm package import only, or teams without git access to GitHub.
When should I use this skill?
Maintaining the local OpenCode mirror for self-reference in an OpenWork-style repository.
What do I get? / Deliverables
You maintain an up-to-date, gitignored vendor/opencode mirror using ff-only pulls suitable for repeatable agent lookups.
- Fresh vendor/opencode working tree
- Documented ff-only update habit without mirror merge commits
Recommended Skills
Journey fit
Mirror maintenance supports developing OpenWork-style agent tooling that references OpenCode source locally during implementation. Agent-tooling subphase covers vendored reference trees and workflows agents use while extending coding products.
How it compares
Local reference mirror workflow—not an MCP server and not OpenCode installation or runtime configuration.
Common Questions / FAQ
Who is opencode-mirror for?
Maintainers of agent-forward repos who want a local OpenCode copy for documentation and self-reference without committing vendor/opencode.
When should I use opencode-mirror?
During Build (agent-tooling) when setting up a new dev environment, refreshing upstream OpenCode before changes, or fixing a stale vendor mirror.
Is opencode-mirror safe to install?
The skill only describes git operations to a public repo; review the Security Audits panel on this page and never commit secrets into vendor paths.
SKILL.md
READMESKILL.md - Opencode Mirror
## Quick Usage (Already Configured) ### Update mirror ```bash git -C vendor/opencode pull --ff-only ``` ## Common Gotchas - Keep the mirror gitignored; never commit `vendor/opencode`. - Use `--ff-only` to avoid merge commits in the mirror. ## First-Time Setup (If Not Configured) ### Clone mirror ```bash git clone https://github.com/anomalyco/opencode vendor/opencode ```