kimetsu-pi 0.1.0

package/LICENSE

@@ -0,0 +1,46 @@
+Licensed under either of MIT or Apache-2.0 at your option.
+
+---
+
+MIT License
+
+Copyright (c) 2026 RodCor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+---
+
+Apache License
+
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright (c) 2026 RodCor
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,58 @@
+# kimetsu-pi
+
+Kimetsu brain as a Pi.dev package: persistent, cross-session memory for the Pi coding agent.
+
+## What it is
+
+Pi (the Pi.dev coding agent) has no MCP support, so this package brings Kimetsu's
+persistent memory to Pi through Pi's own extension points instead:
+
+- **Extension** (`extensions/kimetsu.ts`) — a TypeScript Pi extension that hooks into
+  Pi lifecycle events (`session_start`, `agent_end`, `session_shutdown`) and shells out
+  to the `kimetsu` binary to warm, load, and persist brain context around each session.
+- **Skill** (`skills/kimetsu-brain/SKILL.md`) — a Pi skill that teaches the agent when
+  and how to consult and record memories during a task.
+
+## Prerequisite
+
+The `kimetsu` binary must be on `PATH`. Install it with:
+
+```sh
+npm install -g kimetsu-ai
+```
+
+or via cargo, or one of the prebuilt archives — see
+[github.com/RodCor/kimetsu](https://github.com/RodCor/kimetsu) for all install options.
+
+If the binary is not found, the extension silently no-ops on every lifecycle hook —
+Pi's startup and session behavior are completely unaffected.
+
+## Install
+
+```sh
+pi install npm:kimetsu-pi
+```
+
+## What it does on each event
+
+| Pi lifecycle event | Kimetsu command run |
+| --- | --- |
+| `session_start` | `kimetsu brain warm` then `kimetsu brain context-hook` |
+| `agent_end` | `kimetsu brain stop-hook` |
+| `session_shutdown` | `kimetsu brain session-end-hook` |
+
+## Development
+
+```sh
+npm install
+npm test
+npm run typecheck
+```
+
+## License
+
+MIT OR Apache-2.0
+
+## See also
+
+Main project: [github.com/RodCor/kimetsu](https://github.com/RodCor/kimetsu)

package/extensions/kimetsu.ts

@@ -0,0 +1,41 @@
+// Kimetsu brain extension for Pi (earendil-works/pi).
+// Published as the `kimetsu-pi` npm package. Shells out to the kimetsu binary
+// on Pi lifecycle events to load brain context at session start and record
+// audit markers on session end. If kimetsu is not on PATH the exec silently
+// fails; Pi startup is unaffected.
+
+import { spawn } from "node:child_process";
+
+function kimetsuExec(args: string[]): Promise<void> {
+  return new Promise((resolve) => {
+    try {
+      const child = spawn("kimetsu", args, {
+        stdio: "ignore",
+        shell: false,
+        windowsHide: true,
+      });
+      child.on("error", () => resolve()); // binary not on PATH — silent no-op
+      child.on("close", () => resolve());
+    } catch {
+      resolve(); // any unexpected error — silent no-op
+    }
+  });
+}
+
+export default function (pi: any) {
+  // session_start fires once when Pi starts up or a new session begins.
+  pi.on("session_start", async (_event: any, _ctx: any) => {
+    await kimetsuExec(["brain", "warm"]);
+    await kimetsuExec(["brain", "context-hook"]);
+  });
+
+  // agent_end fires after the LLM turn completes (maps to Kimetsu stop-hook).
+  pi.on("agent_end", async (_event: any, _ctx: any) => {
+    await kimetsuExec(["brain", "stop-hook"]);
+  });
+
+  // session_shutdown fires on clean session close (maps to session-end-hook).
+  pi.on("session_shutdown", async (_event: any, _ctx: any) => {
+    await kimetsuExec(["brain", "session-end-hook"]);
+  });
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "kimetsu-pi",
+  "version": "0.1.0",
+  "description": "Kimetsu brain as a Pi.dev package — persistent cross-session memory for the Pi coding agent.",
+  "keywords": ["pi-package", "pi", "kimetsu", "memory", "extension", "skill"],
+  "homepage": "https://github.com/RodCor/kimetsu-pi#readme",
+  "repository": { "type": "git", "url": "git+https://github.com/RodCor/kimetsu-pi.git" },
+  "license": "MIT OR Apache-2.0",
+  "type": "module",
+  "pi": {
+    "extensions": ["./extensions"],
+    "skills": ["./skills"]
+  },
+  "files": ["extensions/", "skills/", "README.md", "LICENSE"],
+  "engines": { "node": ">=16" },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  }
+}

package/skills/kimetsu-brain/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: kimetsu-brain
+description: Use Kimetsu brain shell commands as a persistent memory sidecar across Pi sessions.
+---
+Kimetsu is a persistent brain sidecar accessible via the `kimetsu` CLI. Use it
+when the task may benefit from prior session knowledge, workflow memory, or
+durable cross-session context.
+
+Brain-first workflow:
+1. Before planning or editing broad coding, review, debugging, or setup tasks,
+   run `kimetsu brain context <query>` and read the returned capsules as working
+   context before deciding on a plan.
+2. After solving a non-obvious problem, run `kimetsu brain record` with a
+   concrete, actionable lesson and 2-5 domain tags so future sessions benefit.
+3. Run `kimetsu brain status` when you need to know whether the brain is
+   initialized, has accepted memories, or has pending proposals.
+
+Optional mode: Kimetsu brain context is a preferred first step for non-trivial
+work. If the binary is unavailable, note the absence and continue normally.