{"id":51759163,"url":"https://github.com/supernovae-st/nika-agents","last_synced_at":"2026-07-24T13:00:51.595Z","repository":{"id":369879035,"uuid":"1287733195","full_name":"supernovae-st/nika-agents","owner":"supernovae-st","description":"One Add teaches your agent Nika: skills, commands, hooks, an MCP oracle.","archived":false,"fork":false,"pushed_at":"2026-07-20T12:13:06.000Z","size":473,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-20T14:12:21.057Z","etag":null,"topics":["agent-skills","agents-md","ai-agents","claude-code","codex","cursor","docker","hermes","llm","mcp","mcp-server","opencode","plugin-marketplace","workflow"],"latest_commit_sha":null,"homepage":"https://docs.nika.sh/getting-started/agents","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/supernovae-st.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-07-03T00:48:06.000Z","updated_at":"2026-07-19T19:12:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/supernovae-st/nika-agents","commit_stats":null,"previous_names":["supernovae-st/nika-agents"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/supernovae-st/nika-agents","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supernovae-st%2Fnika-agents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supernovae-st%2Fnika-agents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supernovae-st%2Fnika-agents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supernovae-st%2Fnika-agents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/supernovae-st","download_url":"https://codeload.github.com/supernovae-st/nika-agents/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supernovae-st%2Fnika-agents/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35842301,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-24T02:00:07.870Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","agents-md","ai-agents","claude-code","codex","cursor","docker","hermes","llm","mcp","mcp-server","opencode","plugin-marketplace","workflow"],"created_at":"2026-07-19T11:00:24.644Z","updated_at":"2026-07-24T13:00:51.586Z","avatar_url":"https://github.com/supernovae-st.png","language":"Shell","funding_links":[],"categories":["Workflows \u0026 Knowledge Guides 🧠","Skills \u0026 Plugins"],"sub_categories":["General","Community Skills"],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://nika.sh\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://nika.sh/brand/nika-logo-dark.svg\"\u003e\n      \u003cimg src=\"https://nika.sh/brand/nika-logo-light.svg\" alt=\"Nika\" width=\"220\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# nika-agents · the Nika plugin marketplace\n\n[![gate](https://github.com/supernovae-st/nika-agents/actions/workflows/gate.yml/badge.svg)](https://github.com/supernovae-st/nika-agents/actions/workflows/gate.yml)\n[![skills.sh](https://skills.sh/b/supernovae-st/nika-agents)](https://skills.sh/supernovae-st/nika-agents)\n\n**Teach your agent to hand repeatable work to [Nika](https://github.com/supernovae-st/nika):\na plain-text workflow it can check before a token is spent and verify\nafter.** This repo is the install surface: 4 skills (author · debug ·\noperate · migrate), 3 subagents, 5 commands (`/nika:check` ·\n`/nika:explain` · `/nika:new` · `/nika:trace` · `/nika:permits`),\n3 hooks and the read-only MCP oracle (9 tools: `nika_check` ·\n`nika_explain` · `nika_schema` · `nika_examples` · `nika_template` ·\n`nika_canon` · `nika_catalog` · `nika_tools` · `nika_inspect`), for the plugin\necosystems:\n\n```sh\nbrew install supernovae-st/tap/nika   # the binary first; plugins invoke it\n\n# Codex\ncodex plugin marketplace add supernovae-st/nika-agents\ncodex plugin add nika@nika\ncodex plugin marketplace upgrade nika   # later: pull a new kit version\n                                        # (the per-version cache refreshes on the next run)\n\n# Claude Code · updating is TWO rungs (proven live: an install sat 3 releases\n# behind, silently, with a fresh clone right next to it):\nclaude plugin marketplace add supernovae-st/nika-agents\nclaude plugin install nika@nika\nclaude plugin marketplace update nika   # rung 1: refresh the CLONE\nclaude plugin update nika@nika          # rung 2: move the INSTALL, then restart\n\n# Or climb every rung on every surface you have (Cursor · Claude Code ·\n# Codex), one gesture · and `--check` reports drift read-only (CI-able):\nscripts/update-mirrors.sh\n\n# Cursor · search \"nika\" in the marketplace (Settings → Plugins), one Add\n# installs the full bundle: rule + skill + subagent + commands + hooks + MCP.\n# Or wire this repo as a team marketplace: Dashboard → Plugins → add\n# supernovae-st/nika-agents\n# (A manual drop into ~/.cursor/plugins/local/ loads MCP + skills ONLY —\n# Cursor's local loader ignores the other components. Until the marketplace\n# listing serves you: `nika init` equips the repo fully · rules · mcp ·\n# the three subagents · delegation rule · the three seatbelt hooks, all\n# project-side and byte-identical to this kit (engine ≥0.101).)\n\n# Hermes, or any skills.sh-compatible client\nhermes skills tap add supernovae-st/nika-agents      # then: hermes skills list\nhermes skills install https://raw.githubusercontent.com/supernovae-st/nika-agents/main/skills/autonomous-ai-agents/nika/SKILL.md\n# or: npx skills add supernovae-st/nika-agents\n```\n\nThe Hermes-facing skill (`skills/autonomous-ai-agents/nika/SKILL.md` ·\nagentskills.io shape) teaches the delegation idiom: Hermes orchestrates,\nNika runs the repeatable work as a checkable file with receipts: check\nbefore run, budget caps on paid models, `trace verify` after.\n\nOther install paths (script, manual download): [nika.sh](https://nika.sh).\nOne-click MCP wiring where the client supports it (binary still required):\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-install%20nika%20mcp-0098FF?logo=githubcopilot)](https://insiders.vscode.dev/redirect/mcp/install?name=nika\u0026config=%7B%22command%22%3A%20%22nika%22%2C%20%22args%22%3A%20%5B%22mcp%22%5D%7D)\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=nika\u0026config=eyJjb21tYW5kIjogIm5pa2EiLCAiYXJncyI6IFsibWNwIl19)\n\n\u003e 🗺️ **Every door in one page**: install paths, IDEs, agents, skills, MCP, CI, SDKs: [docs.nika.sh/integrations/everywhere](https://docs.nika.sh/integrations/everywhere).\n\n## How the pieces fit (the three layers)\n\n```\nENGINE  supernovae-st/nika              the source of truth\n  ├─ .agents/plugins/nika/              THE plugin kit (skills · subagents ·\n  │    3 manifests: claude · codex ·     commands · rules · hooks · MCP · logo)\n  │    cursor                            · mirrored HERE, byte-pinned\n  ├─ nika init                          per-REPO scaffold (AGENTS.md ·\n  │                                      .cursor/{rules,mcp.json} · .vscode ·\n  │                                      copilot brief · CLAUDE.md · skill)\n  └─ nika wire \u003cclient\u003e                 per-MACHINE wiring (cursor · zed ·\n                                         cline · continue · claude · …)\n\nTHIS REPO  supernovae-st/nika-agents    the install surface (light clone —\n                                         marketplaces clone their target)\n   Claude Code · Codex · Cursor          the mirrored plugin, one Add each\n   Hermes / skills.sh · opencode ·       kit-native integrations\n   MCP registries (Glama · server.json)\n\nnika-vscode  supernovae-st/nika-vscode  the IDE product (compiled extension:\n                                         LSP · live DAG canvas · replay\n                                         debugger · runs view · VS Code ·\n                                         Cursor · Windsurf, one build)\n```\n\nThree mechanisms, no overlap: the **plugin** teaches any agent the\nlanguage (per-agent) · **`nika init`** equips one repository (per-repo)\n· **`nika wire`** configures one machine's clients (per-machine). The\nextension is not a plugin: it is the full IDE surface, and on Cursor it\nnudges you to the plugin for the agent side.\n\n## Why a separate repo\n\n`plugin marketplace add` clones its target. The engine repo carries the full\nRust workspace and media; this repo carries the plugin only, so the install\nis instant. The files are mirrored verbatim from the engine's\n[`.agents/plugins/`](https://github.com/supernovae-st/nika/tree/main/.agents/plugins).\nFile issues and PRs against [supernovae-st/nika](https://github.com/supernovae-st/nika).\n\n## What's inside\n\n```\n.agents/plugins/marketplace.json      Codex marketplace manifest\n.agents/plugins/nika/                 the plugin (the full suite, one bundle)\n  .codex-plugin/plugin.json           Codex manifest\n  .claude-plugin/plugin.json          Claude Code manifest\n  .cursor-plugin/plugin.json          Cursor manifest (logo + all components)\n  skills/{nika-authoring,nika-debugging,nika-operating,nika-migration}/\n                                      author · run forensics · day-2 ops · script porting\n  agents/{nika-author,nika-debugger,nika-migrator}.md\n                                      the three subagents (write · root-cause · port)\n  commands/{check,explain,new,trace,permits}.md\n                                      the /nika:* slash commands\n  hooks/{cursor,claude}-hooks.json    the three seatbelts, one file per dialect:\n                                      session map · check-on-edit · guard-run (a nika\n                                      run must pass nika check · the deny teaches)\n  rules/nika-workflow-language.mdc    the language rule (the init template, verbatim)\n  rules/nika-delegation.mdc           WHEN to propose a workflow, WHICH surface to use\n  assets/nika-logo.png                the marketplace logo\n  .mcp.json                           the read-only oracle wiring\n.claude-plugin/marketplace.json       Claude Code marketplace manifest\n.cursor-plugin/marketplace.json       Cursor marketplace manifest\nskills/autonomous-ai-agents/nika/     the Hermes delegation skill (kit-native)\nintegrations/opencode/                opencode wiring (live-verified · pinned)\nintegrations/mcp/                     generic MCP wiring + registry manifest + threat model\nintegrations/description-bank.md      the words every listing copies\nmirror.json                           the drift contract (classes + pins)\n```\n\nYou want to support Nika in your client? Copy the matching `integrations/`\nfolder. Each one is self-contained, version-pinned, and gate-checked\nagainst the live binary.\n\nTwo content classes, one contract (`mirror.json`): **engine-mirror** files\nare byte-identical projections of the engine repo, pinned by sha256 at the\nengine SHA they were proven against: a pin mismatch means corruption (hard\nfail), upstream movement means a re-sync is due (warning, loud on the daily\ncron). **kit-native** files are owned here and proven against the latest\nreleased binary instead: the gate asserts every taught `nika \u003csubcommand\u003e`\nand every advertised `nika_*` tool actually ships.\n\nDocs · https://docs.nika.sh/getting-started/agents · License ·\nAGPL-3.0-or-later (mirrored engine content); per-file declarations win\nwhere present (the Hermes delegation skill is MIT, the Hermes catalog norm).\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eStart from a template: \u003ca href=\"https://github.com/supernovae-st/nika-starter\"\u003enika-starter\u003c/a\u003e (authoring) · \u003ca href=\"https://github.com/supernovae-st/nika-actions-starter\"\u003enika-actions-starter\u003c/a\u003e (CI receipts)\u003cbr\u003e\n  Docs: \u003ca href=\"https://docs.nika.sh\"\u003edocs.nika.sh\u003c/a\u003e · Engine (AGPL-3.0): \u003ca href=\"https://github.com/supernovae-st/nika\"\u003enika\u003c/a\u003e · 🦋 SuperNovae Studio · Paris\u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupernovae-st%2Fnika-agents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsupernovae-st%2Fnika-agents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupernovae-st%2Fnika-agents/lists"}