nika init scaffolds.
Wire it (3 minutes)
1 · Teach the repo — OpenCode discoversAGENTS.md (project root,
upward traversal, CLAUDE.md fallback) and repo skills under
.agents/skills/ natively:
nika-authoring skill (author → check
→ repair loop) appears in OpenCode’s skill tool automatically.
2 · Wire the oracle — nika wire opencode (0.99+) writes it, or add
the two-field stanza to opencode.json yourself (project-local, or
~/.config/opencode/opencode.json globally):
Prove the loop
Ask OpenCode:Turn my weekly changelog digest into a Nika workflow from the chain template, check it, and run it with the mock model.Expected tool trail:
nika new chain → edit → nika check (static
audit, nothing spent) → nika run … --model mock/echo (offline) →
receipts in .nika/traces/.
When to reach for which
Troubleshooting
- Skill not listed — OpenCode discovers
.agents/skills/*/SKILL.mdfrom the git worktree root; re-checknika initran at the repo root. - MCP server absent — validate
opencode.jsonagainst its$schema; thenikabinary must be on PATH (nika --version). - Which config wins — project-local
opencode.jsonmerges over the global file; keep the stanza in one place.