Skip to main content
Nika is not another agent. It is the workflow file your agents already run — checked before, verified after. Integration therefore means two small things: teach your agent the language, and wire the read-only oracle.

​
Minute 0-2 · install the binary

brew install supernovae-st/tap/nika    # or: curl -LsSf https://nika.sh/install.sh | sh
nika --version && nika doctor          # doctor prints exact fixes, never mutates
No key needed yet — the mock and local providers run without one.

​
Minute 2-5 · teach the repo

nika init
One command writes the agent surface: AGENTS.md (read natively by Codex, Claude Code, Cursor, OpenCode, Hermes, Jules and every AGENTS.md-aware tool), the Cursor rule, the Copilot instructions, the repo-level agent skill, and the .vscode schema wiring. Idempotent — existing files are skipped.

​
Minute 5-7 · wire the oracle

nika wire cursor     # or: vscode · windsurf · claude · codex · all
For clients without a wire target yet (OpenCode, Hermes, Zed, Gemini CLI, Continue, Cline…), it is the same two-field stanza everywhere — copy it from per-client wiring. What the oracle exposes (and refuses to): Nika as an MCP server.

​
Minute 7-10 · prove the loop

Ask your agent:
Create a workflow from the chain template that summarizes ./notes.md into ./out/brief.md, check it, then run it with the mock model.
The agent scaffolds (nika new --from chain), audits (nika check — plan, cost floor, permits, before any token is spent), runs offline (--model mock/echo), and the receipts land in .nika/traces/ (nika trace verify → exit 0).

​
Then: CI receipts

Put the GitHub Action on the repo — every PR that touches a .nika.yaml gets a sticky comment with the check verdict, the honest cost floor, required secrets and the DAG. Check-only, zero secrets, by default.

​
The per-tool pages

  • OpenCode — native skills + AGENTS.md + MCP; zero packaging needed.
  • Hermes — the delegation pattern: Hermes orchestrates, Nika runs the repeatable work with receipts.
  • GitHub Actions — plan with receipts on every PR.
  • Everything MCP-capable — Cursor · Claude Code · Codex · Zed · Gemini CLI · Windsurf · Continue · Cline · Aider, one stanza each.