One binary, many doors. This page is the single map of every surface Nika
ships on — pick your door, each row links to the exact guide.
The one-liner everywhere: brew install supernovae-st/tap/nika — then
nika init teaches whatever agent you run.
Install paths
| Surface | What you get | Where |
|---|
| Homebrew tap | brew install supernovae-st/tap/nika (macOS + Linux) | Quickstart |
| Release tarballs | per-platform binaries + SHA256SUMS (verify before you trust) | GitHub releases |
install.sh | one-command install from the site | nika.sh/install |
| cargo binstall | the prebuilt release tarball, no compile (cargo binstall --git https://github.com/supernovae-st/nika nika-cli) | Installation |
| nix flake | nix run github:supernovae-st/nika — builds the exact release source, store-cached | Installation |
.mcpb bundles | one-click MCP bundle (macOS arm64 · Linux x64) with checksums | Claude Desktop guide |
| Docker image | the read-only oracle in a container (integrations/mcp/Dockerfile in the kit) | nika-agents kit |
IDEs & editors
| Surface | Mechanism | Where |
|---|
| VS Code | extension on the Marketplace (LSP · DAG canvas · preflight) | VS Code / Copilot guide |
| Cursor | nika wire cursor + one-click deeplink button | Cursor guide |
| Windsurf | nika wire windsurf | Windsurf guide |
| Zed | nika wire zed (0.99+) | Zed guide |
| JetBrains (Junie) | project-scope .junie/mcp/mcp.json stanza | Junie guide |
| Cursor forks / VSCodium | extension via OpenVSX | — |
| Neovim | via the mcphub.nvim registry (covers avante · codecompanion) | MCP clients |
| Any editor with YAML-LSP | the # yaml-language-server: $schema= modeline nika init writes | Editors guide |
Agents & assistants
| Surface | Mechanism | Where |
|---|
| Claude Code | first-party plugin (.claude-plugin · /nika:check · /nika:explain · /nika:new · skill) + nika wire claude | Claude Code guide |
| Claude Desktop | claude_desktop_config.json stanza + one-click .mcpb bundles | Claude Desktop guide |
| Codex | first-party plugin (.codex-plugin · same commands) + nika wire codex | Codex guide |
| Hermes | skill pack (skills/autonomous-ai-agents/nika · guard-scanned SAFE) | Hermes guide |
| OpenCode | opencode.json MCP stanza + native .agents/ reading — nika init suffices | OpenCode guide |
| goose | MCP extension stanza + native AGENTS.md reading | goose guide |
| Gemini CLI · Qwen Code | mcpServers stanza in the user-scope settings.json | Gemini CLI · Qwen Code |
| Cline · Continue | cline_mcp_settings.json (hot-reloaded) · own-file ~/.continue/mcpServers/nika.json | Cline · Continue |
| Open WebUI · AnythingLLM · Cherry Studio · Jan | mcpo recipe · generic stdio stanza | Open WebUI · AnythingLLM · Cherry Studio · Jan |
| Aider | no MCP — AGENTS.md (written by nika init) covers it | MCP clients → Aider |
| Any AGENTS.md reader | nika init writes 6 agent-facing files (AGENTS.md included) | Quickstart |
Skills & plugins (the teaching surfaces)
| Element | What it is | Lives at |
|---|
| SKILL.md pack | the authoring skill (check-before-run law · cost honesty) — installable via npx skills add supernovae-st/nika-agents | nika-agents kit |
| Plugin commands | /nika:check · /nika:explain · /nika:new mirrored from the engine | kit .agents/plugins/nika/ |
| Integration kit contract | « You want to support Nika? Copy this folder » — pinned mirrors, drift-gated in CI | kit README |
MCP (the read-only oracle)
nika mcp exposes 8 tools — validate, explain, examples, schema, cost — no
execution, no mutation, by design (threat model).
| Element | Where |
|---|
| Full tool reference | MCP server reference |
| Per-client wiring (one dedicated page per client — the matrix) | MCP clients |
server.json (registry shape) + bundles + Dockerfile | kit integrations/mcp/ |
CI/CD
| Element | What it does | Where |
|---|
| nika-action — plan with receipts | check verdict · honest cost floor · permits · the DAG, as a sticky PR comment. Static, zero secrets by default | GitHub Actions guide · repo |
| Offline test lane | nika test golden runs on the mock provider — CI with no API key | Local-first tutorial |
SDKs & language surfaces
| Element | What it is | Where |
|---|
| TypeScript client | LocalNika — typed driver over the shipped binary (check · run stream · dry-run plan) · Apache-2.0 | nika-client |
| Language spec | the .nika.yaml contract — Apache-2.0, runtime-agnostic | nika-spec |
| Registry | CI-re-proven workflow artifacts (hash + oracle + engine cert) | nika-registry |
Where Nika is listed
Marketplaces and directories where you’ll find us today — the public
submissions ledger (with pinned descriptions and review cadence) lives in
listings.yaml.
- VS Code Marketplace · OpenVSX — the extension
- skills.sh — the skill pack
- GitHub topics + release feeds — engine · kit · action · docs · spec · client
- More MCP registries and community catalogs are in flight — the ledger above
is the always-current truth (every submission registers there the day it
goes out).
Learn the patterns first
New to agentic workflows as a concept? agentic-ai-systems
(282★) teaches the workflow taxonomy with diagrams — and its
patterns-as-code
folder expresses each pattern as a runnable .nika.yaml, checked in CI on
every push.
