nika-agents · the Nika plugin marketplace

Teach your agent to hand repeatable work to Nika: a plain-text workflow it can check before a token is spent and verify after. This repo is the install surface: the nika-authoring skill (author → check → repair loop), the /nika:check · /nika:explain · /nika:new commands, and the read-only MCP oracle (8 tools: nika_check · nika_explain · nika_schema · nika_examples · nika_template · nika_canon · nika_catalog · nika_tools), for the plugin ecosystems:

brew install supernovae-st/tap/nika   # the binary first; plugins invoke it

# Codex
codex plugin marketplace add supernovae-st/nika-agents
codex plugin add nika@nika

# Claude Code
claude plugin marketplace add supernovae-st/nika-agents
claude plugin install nika@nika

# Hermes, or any skills.sh-compatible client
hermes skills tap add supernovae-st/nika-agents      # then: hermes skills list
hermes skills install https://raw.githubusercontent.com/supernovae-st/nika-agents/main/skills/autonomous-ai-agents/nika/SKILL.md
# or: npx skills add supernovae-st/nika-agents

The Hermes-facing skill (skills/autonomous-ai-agents/nika/SKILL.md · agentskills.io shape) teaches the delegation idiom: Hermes orchestrates, Nika runs the repeatable work as a checkable file with receipts: check before run, budget caps on paid models, trace verify after.

Other install paths (script, manual download): nika.sh. One-click MCP wiring where the client supports it (binary still required):

🗺️ Every door in one page: install paths, IDEs, agents, skills, MCP, CI, SDKs: docs.nika.sh/integrations/everywhere.

Why a separate repo

plugin marketplace add clones its target. The engine repo carries the full Rust workspace and media; this repo carries the plugin only, so the install is instant. The files are mirrored verbatim from the engine's .agents/plugins/. File issues and PRs against supernovae-st/nika.

What's inside

.agents/plugins/marketplace.json      Codex marketplace manifest
.agents/plugins/nika/                 the plugin (skill + commands + MCP bundle)
  .codex-plugin/plugin.json           Codex manifest
  .claude-plugin/plugin.json          Claude Code manifest
  skills/nika-authoring/SKILL.md      the authoring skill (agentskills.io shape)
  commands/{check,explain,new}.md     the /nika:* slash commands
  .mcp.json                           the read-only oracle wiring
.claude-plugin/marketplace.json       Claude Code marketplace manifest
skills/autonomous-ai-agents/nika/     the Hermes delegation skill (kit-native)
integrations/opencode/                opencode wiring (live-verified · pinned)
integrations/mcp/                     generic MCP wiring + registry manifest + threat model
integrations/description-bank.md      the words every listing copies
mirror.json                           the drift contract (classes + pins)

You want to support Nika in your client? Copy the matching integrations/ folder. Each one is self-contained, version-pinned, and gate-checked against the live binary.

Two content classes, one contract (mirror.json): engine-mirror files are byte-identical projections of the engine repo, pinned by sha256 at the engine SHA they were proven against: a pin mismatch means corruption (hard fail), upstream movement means a re-sync is due (warning, loud on the daily cron). kit-native files are owned here and proven against the latest released binary instead: the gate asserts every taught nika <subcommand> and every advertised nika_* tool actually ships.

Docs · https://docs.nika.sh/getting-started/agents · License · AGPL-3.0-or-later (mirrored engine content); per-file declarations win where present (the Hermes delegation skill is MIT, the Hermes catalog norm).

_{Start from a template: nika-starter (authoring) · nika-actions-starter (CI receipts)
Docs: docs.nika.sh · Engine (AGPL-3.0): nika · 🦋 SuperNovae Studio · Paris}