Nika plugin
Nika records repeatable AI work as a .nika file, checks it before it runs and keeps a verifiable record of every run.
- 100 ★ on the repository
- Last commit
Extended access
Why this level
- Workflows can run commands and call tools, so read the permissions in the check report.
- A run spends tokens of the chosen model.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/nikaDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Workflows can run commands and call tools, so read the permissions in the check report.
- A run spends tokens of the chosen model.
This is third-party code. Review the repository files before installing.
What it does
Nika turns the work you regularly hand to AI into a readable `.nika` file. You describe a job in words, for example pull action items from meeting notes every Monday, and Nika records it as a workflow. Before it runs, `nika check` shows without calling a model what the workflow will do, which models and tools it uses, what it may touch and what it can cost. A workflow that reads private data, takes in untrusted content and sends data out is refused until it asks a person first. `nika run` runs the file with a model you choose, local through Ollama or over an API, and `nika trace verify` checks the hash chain of the run record. It is one Rust binary plus a TypeScript SDK. The plugin teaches Claude Code, Codex and Cursor to author, debug and migrate such workflows.
Who it is for. People who regularly hand the same tasks to agents and want to see cost, permissions and outcome before and after a run.
Good fit when
- A weekly task such as notes triage should run from one file.
- You need to see in advance which data and tools a workflow will touch.
- After a run a record that can be verified is required.
- A task has to move from a cloud model to a local one through Ollama.
Not a fit when
- The task is a one-off and a workflow file will not pay off.
- The AGPL-3.0 license does not suit your closed product.
- You need an interactive agent without fixed steps.
Example request
Record the task as a Nika workflow: read ./data/orders.csv, keep paid rows and write them to ./out/paid.csv, then run check.Limitations
The plugin calls the `nika` binary, which must be installed first, for example with `brew install supernovae-st/tap/nika`. The AGPL-3.0 license brings obligations on distributing changes and network use. The project changes quickly, versions grow from release to release and the `.nika` format may change. The pre-run check does not call a model, but the run itself spends tokens or local resources of the chosen model. The record signing key is kept in the keychain or in `~/.nika/keys/`.
How to disable. Remove the plugin with `claude plugin` or `codex plugin` and the binary with `brew uninstall nika`. Keys and run records live in `~/.nika`, so delete that directory if needed.
FAQ
How do I install the plugin in Claude Code?
The binary first: `brew install supernovae-st/tap/nika`. Then `claude plugin marketplace add supernovae-st/nika-plugins` and `claude plugin install nika@nika`.
What does nika check verify?
What the workflow will do, which models and tools it uses, what it can access and what it can cost, all without calling a model.
Which models fit?
Any you choose, local through Ollama or cloud through a provider API.
How do I verify a run result?
With `nika trace verify`, which reads the record hash chain, and the `/proof` command in a session shows what the run recorded.
Is there an SDK?
Yes, the `@supernovae-st/nika` npm package gives a TypeScript SDK and a bundled engine.
Discussion
No questions or reviews yet.
Related
PluginsOnyx runs teams of worker agents that hunt for code and metric improvements in your repo while you steer them through /onyx
Skills and hooks for building n8n workflows through the n8n-mcp server: expressions, nodes, validation, AI agents, self-hosting
TigerAI Code2n8n Skill Pack
TigerAI A2A Code2n8n Skill Pack
A pack of 14 skills: an agent builds n8n workflows from a description or ports code into n8n and validates the result.
The @itsaplan/runner CLI takes tasks from the It's a Plan tracker and hands them to Claude Code, Codex or opencode locally.
n8n Skills
n8n-skills
A skill package giving AI knowledge of 545 n8n nodes and workflow templates. The n8n version in the README: 2.38.7
Hycli turns a website URL and a goal into a typed CLI and MCP tools that run in your own browser session, with no cookie leaks.
README in short
The description walks through four steps: describe the job, check the file, run it with a chosen model, prove the result. Installation, session examples, workflow verbs and SDK use follow.