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 CLI

This 10-minute loop uses the CLI (nika init, nika wire, nika compile). The later commands on this page require a nika binary on PATH.
No key needed yet — mock/echo and local providers run without one. Driving Nika from Node instead of a shell? That is a different door: npm install @supernovae-st/nika@0.120.2 does not put nika on PATH. Follow SDK quickstart (run() admits, run.result() settles, run.events() yields normalized kinds).

​
Minute 2-5 · teach the repo

One command writes the agent surface: AGENTS.md (read natively by Codex, Claude Code, Cursor, OpenCode, Hermes, Jules and every AGENTS.md-aware tool), CLAUDE.md, 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 --help lists every target on this binary. Clients with no target (goose, Open WebUI, AnythingLLM, Cherry Studio, Jan) take the same two-field stanza — 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 previews (nika compile chain --json — incomplete questions stay questions; no file is written), answers them with repeatable --answer KEY=JSON_LITERAL, writes a Ready destination, 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 .nika/traces/<run>.ndjson → exit 0 — the run card prints the path on its trace: line).

​
Then: CI receipts

Put the GitHub Action on the repo — every PR that touches a .nika 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.