Skip to content

About

Kata work tracking for Claude Code, oh-my-pi and pi: delegated work and todo plans become Kata issues closed with evidence.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Kata Plugin

Kata work tracking for oh-my-pi, pi, OpenCode and Claude Code. Todo plans, and the delegations that name their items or a ticket, become Kata issues with attributed ownership and evidence for completion. Kata validates each close; automatic session parents close after their children finish.

Plugin Tracks
oh-my-pi Todo plans and the task subagents that work them
pi Todo plans and child Pi processes
OpenCode Todo plans, as one whole-list todowrite tool checked against Kata, and the subagent delegates that work them
Claude Code Todo plans, as one todo tool in place of the task tools, and the agents that work them: Agent subagents, Workflow agents and teammates

Oh-my-pi:

kata-plugin-omp.mp4
omp plugin marketplace add Dangerboi/kata-plugin
omp plugin install kata@kata-plugin

Or from npm, as listed on omp packages: omp plugin install @dangerboi/kata-omp. Use one install or the other; see the install guide.

That is the whole setup. The plugin replaces omp's built-in todo with Kata in every folder, with no configuration. A repo with no Kata project plans in the project named by KATA_DEFAULT_PROJECT (labeled with the repo), or else in its inferred project, which the plugin registers in the daemon without writing files into the repo.

Kata inbox requests reach a session when KATA_INBOX_USER names a session address, <actor>/<name>. A bare <actor> is that person's own inbox, so sessions don't read it. On OMP the main session gets each new request from that actor live, even while idle or mid-run (KATA_OMP_LIVE_INBOX=0 turns it off); Pi reads per turn.

Pi:

kata-plugin-pi.mp4
pi install npm:@dangerboi/kata-pi
# or from Git, or a local clone:
pi install git:github.com/Dangerboi/kata-plugin
pi install ./kata-plugin/plugins/pi

OpenCode 2.2.7 or later:

kata-plugin-opencode.mp4
{ "plugins": [{ "package": "@dangerboi/kata-opencode", "options": {} }] }

Add that to opencode.json, then run kata agent-hook install opencode for Kata's contract, inbox and attention. To load a checkout, put the absolute path of plugins/opencode in plugins instead. The TUI sidebar needs nothing more; set experimental.todo: true only for the desktop composer pill. See the install guide for plugin options.

Claude Code 2.1.326 (the mod API is early access):

kata-plugin-cc.mp4
/plugin install kata-cc --marketplace Dangerboi/kata-plugin

Or claude plugin marketplace add Dangerboi/kata-plugin and claude plugin install kata-cc@kata-plugin from a shell. There is no npm package and no restart. Run kata agent-hook install claude --attention for Kata's contract, inbox and attention; the plugin adds only the plan unless its contract option is on. Options (liveInbox, contract, kataExecutable, debugFile) are in the reference, and the live inbox turns off with KATA_CLAUDE_LIVE_INBOX=0. A session resumed with claude --resume takes up its saved plan; /branch forks share their source's plan (not under a managed-settings guard), while claude --resume <id> --fork-session starts a plan of its own. See the install guide and the limits.

Requires Kata 0.23.0, plus the selected harness. Plan tools report incompatible installations; see runtime compatibility. The omp plugin delegates session attention to kata agent-hook attention-native. Tested host versions are oh-my-pi 18.20.2, pi 1.5.0, OpenCode 2.2.7 and Claude Code 2.1.326. Bun and Node are needed for development.

Start with the first session tutorial, installation guide, or development guide. See completion rules and limits before adopting automatic closure.

Originally created by salmonumbrella.

About

Kata work tracking for Claude Code, oh-my-pi and pi: delegated work and todo plans become Kata issues closed with evidence.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages