@skyf0xx/hedgehog 6.4.3 → 6.5.0

package/README.md

@@ -251,6 +251,12 @@ gemini extensions install https://github.com/skyf0xx/hedgehog
 git clone https://github.com/skyf0xx/hedgehog ~/.cursor/plugins/local/hedgehog
 ```
 
+### OpenCode
+
+``` bash
+npx @skyf0xx/hedgehog init --host=opencode
+```
+
 Then open a project and describe what you want to build and mention `hedgehog`.
 
 On a fresh project with no warm pnpm store, that first install can take

package/bin/cli.mjs

@@ -724,7 +724,8 @@ ${bold('Usage')}
   npx @skyf0xx/hedgehog init --cursor             install for Cursor (default: Claude Code)
   npx @skyf0xx/hedgehog init --host=claude,gemini install for several coding agents at once
   npx @skyf0xx/hedgehog init --all-hosts          install for every supported coding agent
-  npx @skyf0xx/hedgehog init --force              overwrite existing files
+  npx @skyf0xx/hedgehog init --force | -f         overwrite existing files
+  npx @skyf0xx/hedgehog --version | -v            print the installed version
   npx @skyf0xx/hedgehog update                    refresh the installed agents + skills
   npx @skyf0xx/hedgehog update --check            report whether a newer release is published
   npx @skyf0xx/hedgehog db init                   create .hedgehog/hedgehog.db if absent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyf0xx/hedgehog",
-  "version": "6.4.3",
+  "version": "6.5.0",
   "description": "Install the Hedgehog build discipline (agents + skills) into a repo, for Claude Code, Cursor, or Gemini CLI.",
   "type": "module",
   "repository": {

package/src/hosts/emit.mjs

@@ -21,3 +21,19 @@ export function emitPromptAgent(text) {
   const constraint = `**Tools for this role:** ${grant.summary}\n\n`;
   return stringify(kept, `\n${constraint}${body.replace(/^\n+/, '')}`);
 }
+
+// OpenCode registers subagents from `.opencode/agents/` markdown files.
+// Its frontmatter wants `description` and `mode`, and the file name is
+// the agent name. Claude Code's `model:`/`tools:` subagent schema and
+// the redundant `name:` come off; the tool grant is restated as a line
+// the agent reads — `hedgehog verify` gates the commit regardless.
+export function emitOpencodeAgent(text) {
+  const { data, body } = parse(text);
+  const kept = { ...data };
+  for (const key of [...CLAUDE_ONLY, 'name']) delete kept[key];
+  kept.mode = 'subagent';
+
+  const grant = grantFor(data.name);
+  const constraint = `**Tools for this role:** ${grant.summary}\n\n`;
+  return stringify(kept, `\n${constraint}${body.replace(/^\n+/, '')}`);
+}

package/src/hosts/gemini/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "hedgehog",
-  "version": "6.4.3",
+  "version": "6.5.0",
   "description": "Hedgehog build discipline: ordered, tested, verified build steps.",
   "contextFileName": "GEMINI.md"
 }

package/src/hosts/index.mjs

@@ -8,7 +8,7 @@
 // Adding a host means adding one entry here (and a matching directory
 // under src/hosts/<name>/ for whatever templates it needs).
 
-import { emitPromptAgent } from './emit.mjs';
+import { emitPromptAgent, emitOpencodeAgent } from './emit.mjs';
 
 // Hosts that dispatch real subagents get the full discipline: each build
 // step runs in its own context with its own role. Hosts that don't are
@@ -108,6 +108,22 @@ export const HOSTS = {
       ];
     },
   },
+
+  // OpenCode auto-loads AGENTS.md from the repo root — the same file
+  // every host ships as an index. The bootstrap merge carries the
+  // discipline shell and the dispatch into it directly, so no separate
+  // routing doc is generated and the file has one writer per install
+  // flag. Subagents register from `.opencode/agents/` (the file name is
+  // the agent name; Claude Code's `model:`/`tools:` subagent schema
+  // comes off on install), and skills load on demand from
+  // `.opencode/skills/`.
+  opencode: {
+    agentsDir: '.opencode/agents',
+    skillsDir: '.opencode/skills',
+    bootstrapFile: 'AGENTS.md',
+    label: 'OpenCode',
+    emitAgent: emitOpencodeAgent,
+  },
 };
 
 // One install flag per host, named for the tool a user is asking to use.
@@ -117,6 +133,7 @@ export const HOST_FLAGS = {
   '--claude': 'claude',
   '--cursor': 'cursor',
   '--gemini': 'gemini',
+  '--opencode': 'opencode',
 };
 
 export const DEFAULT_HOST = 'claude';

package/src/hosts/opencode/DISPATCH.md

@@ -0,0 +1,18 @@
+## Delegating on this host
+
+OpenCode registers subagents from `.opencode/agents/` — each file becomes
+an agent named for the file. Invoke one with `@<name>` and pass it the
+`hedgehog next` packet as the task: the full packet, not a step name.
+
+Independent steps can go out as several subagent calls in one message.
+Steps that depend on each other stay sequential.
+
+Each agent file carries its tool grant as a line of its prompt, and
+`hedgehog verify` checks the touched files against the packet's ALLOWED
+SCOPE before any commit lands.
+
+The skills in `.opencode/skills/` are procedures to follow — read the one
+whose situation applies rather than improvising the steps.
+
+Clear the conversation at the unit boundaries the `hedgehog-orchestrating`
+skill states.