@octoglyphs/claude-code 0.1.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+    "name": "octoglyphs",
+    "version": "0.1.0",
+    "description": "Prompt Fed Octo Companion for Claude Code. Feeds from sanitized activity metadata without reading prompts, responses, code, files, diffs, or terminal output.",
+    "author": {
+        "name": "OctoGlyphs",
+        "url": "https://github.com/OctoGlyphs/OctoGlyphs"
+    },
+    "homepage": "https://github.com/OctoGlyphs/OctoGlyphs",
+    "repository": "https://github.com/OctoGlyphs/OctoGlyphs",
+    "license": "MIT",
+    "keywords": [
+        "octoglyphs",
+        "companion",
+        "hooks",
+        "privacy"
+    ],
+    "hooks": "./hooks/hooks.json"
+}

package/README.md

@@ -0,0 +1,97 @@
+# OctoGlyphs for Claude Code
+
+Prompt Fed Octo Companion for Claude Code.
+
+OctoGlyphs turns Claude Code activity into a tiny aquarium companion. Prompts feed the octo, tool use drops gems, completed responses add session energy, and git commits can trigger special progression. It is designed to be privacy-first: the plugin only emits sanitized metadata and never sends prompt text, assistant text, code, file contents, diffs, stdout, stderr, or secrets to the game.
+
+## Install from npm
+
+```bash
+npm install -g @octoglyphs/claude-code
+```
+
+Then start Claude Code with OctoGlyphs attached from any directory:
+
+```bash
+claude-octoglyphs
+```
+
+Any extra arguments are passed through to Claude Code, for example:
+
+```bash
+claude-octoglyphs --model sonnet
+```
+
+Default URL:
+
+```text
+http://localhost:18791/octoglyphs
+```
+
+If that port is already occupied, the plugin automatically falls back to the next available local port. The actual URL is written to:
+
+```text
+~/.octoglyphs-claude-code.json
+```
+
+## Source install
+
+```bash
+git clone https://github.com/OctoGlyphs/OctoGlyphs.git
+cd OctoGlyphs/plugin/hosts/claude-code
+npm install
+npm test
+npm run install:launcher
+claude-octoglyphs
+```
+
+If `claude-octoglyphs` is not found after source installation, add `~/.local/bin` to your shell `PATH`.
+
+## What it captures
+
+The Claude Code plugin uses official hook events:
+
+- `SessionStart` starts the local OctoGlyphs sidecar.
+- `UserPromptSubmit` emits prompt length metadata.
+- `PostToolUse` emits sanitized tool category and success metadata.
+- `PostToolUseFailure` emits sanitized failed tool metadata.
+- `Stop` emits response completion metadata.
+
+## What it does not capture
+
+OctoGlyphs does not read or store:
+
+- raw prompts
+- assistant responses
+- source code
+- file contents
+- diffs
+- terminal output
+- secrets
+- transcript files
+
+## Local test flow
+
+From this directory:
+
+```bash
+npm test
+```
+
+To try it in Claude Code without installing the launcher, load this folder as a local plugin directory:
+
+```bash
+claude --plugin-dir .
+```
+
+The local health endpoint uses the same port, for example:
+
+```text
+http://localhost:18791/octoglyphs/health
+```
+
+## Development notes
+
+The hook script starts a local sidecar server on port `18791` when available, then falls back through nearby local ports if needed. Hook failures are swallowed so OctoGlyphs never blocks Claude Code work.
+
+The game assets are copied into `public/` from the shared OctoGlyphs browser build.

package/bin/claude-octoglyphs.mjs

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const pluginRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const claudeCommand = process.env.CLAUDE_CODE_BIN || "claude";
+const args = ["--plugin-dir", pluginRoot, ...process.argv.slice(2)];
+const child = spawn(claudeCommand, args, {
+    stdio: "inherit",
+    env: process.env
+});
+
+child.on("error", error => {
+    if (error.code === "ENOENT") {
+        console.error("claude-octoglyphs could not find Claude Code. Install Claude Code or set CLAUDE_CODE_BIN to its executable path.");
+        process.exit(127);
+    }
+
+    console.error(`claude-octoglyphs failed to launch Claude Code: ${error.message}`);
+    process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+    if (signal) {
+        process.kill(process.pid, signal);
+        return;
+    }
+
+    process.exit(code ?? 0);
+});

package/hooks/hooks.json

@@ -0,0 +1,69 @@
+{
+    "description": "Emit privacy-safe Claude Code activity metadata to the local OctoGlyphs companion tank.",
+    "hooks": {
+        "SessionStart": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "node \"$CLAUDE_PLUGIN_ROOT/scripts/octoglyphs-hook.mjs\"",
+                        "timeout": 2,
+                        "statusMessage": "Starting OctoGlyphs"
+                    }
+                ]
+            }
+        ],
+        "UserPromptSubmit": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "node \"$CLAUDE_PLUGIN_ROOT/scripts/octoglyphs-hook.mjs\"",
+                        "timeout": 2,
+                        "async": true,
+                        "statusMessage": "Feeding OctoGlyphs"
+                    }
+                ]
+            }
+        ],
+        "PostToolUse": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "node \"$CLAUDE_PLUGIN_ROOT/scripts/octoglyphs-hook.mjs\"",
+                        "timeout": 2,
+                        "async": true,
+                        "statusMessage": "Feeding OctoGlyphs"
+                    }
+                ]
+            }
+        ],
+        "PostToolUseFailure": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "node \"$CLAUDE_PLUGIN_ROOT/scripts/octoglyphs-hook.mjs\"",
+                        "timeout": 2,
+                        "async": true,
+                        "statusMessage": "Feeding OctoGlyphs"
+                    }
+                ]
+            }
+        ],
+        "Stop": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "node \"$CLAUDE_PLUGIN_ROOT/scripts/octoglyphs-hook.mjs\"",
+                        "timeout": 2,
+                        "async": true,
+                        "statusMessage": "Feeding OctoGlyphs"
+                    }
+                ]
+            }
+        ]
+    }
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+    "name": "@octoglyphs/claude-code",
+    "version": "0.1.0",
+    "description": "Privacy-first OctoGlyphs companion plugin and launcher for Claude Code.",
+    "type": "module",
+    "license": "MIT",
+    "private": false,
+    "homepage": "https://github.com/OctoGlyphs/OctoGlyphs#readme",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/OctoGlyphs/OctoGlyphs.git",
+        "directory": "plugin/hosts/claude-code"
+    },
+    "bugs": {
+        "url": "https://github.com/OctoGlyphs/OctoGlyphs/issues"
+    },
+    "keywords": [
+        "octoglyphs",
+        "claude-code",
+        "claude",
+        "plugin",
+        "companion",
+        "aquarium",
+        "privacy-first"
+    ],
+    "scripts": {
+        "copy:game": "rm -rf public && mkdir -p public && cp -R ../../../game/dist/. public/ && rm -rf public/assets/raw/Halloween\\ assets public/assets/raw/Enemies public/assets/raw/gems public/assets/raw/Old\\ cycles public/assets/raw/UI/Play public/assets/raw/UI/Settings public/assets/raw/Backgrounds/deep2.png public/assets/raw/Backgrounds/deep3.png public/assets/raw/Backgrounds/deep4.png public/assets/raw/Backgrounds/shallow2.png public/assets/raw/Backgrounds/shallow3.png public/assets/raw/Backgrounds/shallow4.png public/assets/raw/Backgrounds/mid*.png public/assets/raw/Backgrounds/newbg*.png",
+        "build:game": "npm --prefix ../../../game install && npm --prefix ../../../game run build -- --logLevel warn",
+        "build": "npm run build:game && npm run copy:game",
+        "install:launcher": "node scripts/install-launcher.mjs",
+        "test": "npm run build && node tests/claudeCodePlugin.test.mjs",
+        "pack:local": "npm pack",
+        "prepack": "npm run build"
+    },
+    "bin": {
+        "claude-octoglyphs": "./bin/claude-octoglyphs.mjs"
+    },
+    "files": [
+        ".claude-plugin/",
+        "bin/",
+        "hooks/",
+        "scripts/",
+        "public/",
+        "README.md"
+    ],
+    "engines": {
+        "node": ">=18"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}