braintracker 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Salad Arena for Researching, Insight and Prototyping
+
+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.

package/README.md

@@ -0,0 +1,60 @@
+# braintracker
+
+A Claude Code plugin that automatically logs every skill invocation — name, duration, and the prompt that triggered it — using Claude Code hooks.
+
+## Install
+
+```bash
+npx braintracker
+```
+
+That's it. The command copies the hook files to `~/.claude/plugins/braintracker/hooks/` and registers them in `~/.claude/settings.json`.
+
+**Requirements:** [Claude Code](https://claude.ai/code) and Node.js (already bundled with Claude Code).
+
+## Disable / Enable
+
+Pause logging without uninstalling:
+
+```bash
+npx braintracker disable   # removes hooks from settings.json, keeps files
+npx braintracker enable    # re-registers the hooks
+```
+
+## Uninstall
+
+```bash
+npx braintracker uninstall
+```
+
+Removes the hook files and cleans up `~/.claude/settings.json`.
+
+## Verify
+
+Invoke any skill inside Claude Code (e.g. `/review`), then:
+
+```bash
+cat ~/.claude/plugin/cache/cctracking/<project>/<session_id>.jsonl
+```
+
+Each line is a JSON object:
+
+```json
+{
+  "type": "skill_invocation",
+  "session_id": "abc123",
+  "skill": "review",
+  "triggered_by": "review this PR",
+  "started_at": "2026-05-25T10:00:00Z",
+  "duration_seconds": 4.2
+}
+```
+
+## How It Works
+
+| Hook | Script | Action |
+|------|--------|--------|
+| `PreToolUse` (Skill) | `pre_skill.js` | Writes a timing snapshot to `<session>.pre.json` |
+| `PostToolUse` (Skill) | `post_skill.js` | Reads the snapshot, computes duration, appends a log entry to `<session>.jsonl`, deletes the snapshot |
+
+Logs live at `~/.claude/plugin/cache/cctracking/<project>/` — one JSONL file per session, grouped by project name.

package/bin/braintracker.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+const fs   = require('fs');
+const path = require('path');
+const os   = require('os');
+
+const DEST_HOOKS = path.join(os.homedir(), '.claude', 'plugins', 'braintracker', 'hooks');
+const SETTINGS   = path.join(os.homedir(), '.claude', 'settings.json');
+
+const PRE_CMD  = `node ${path.join(DEST_HOOKS, 'pre_skill.js')}`;
+const POST_CMD = `node ${path.join(DEST_HOOKS, 'post_skill.js')}`;
+
+function readSettings() {
+  try { return JSON.parse(fs.readFileSync(SETTINGS, 'utf8')); } catch { return {}; }
+}
+
+function writeSettings(settings) {
+  fs.mkdirSync(path.dirname(SETTINGS), { recursive: true });
+  fs.writeFileSync(SETTINGS, JSON.stringify(settings, null, 2) + '\n');
+}
+
+function addHook(arr, matcher, command) {
+  let group = arr.find(h => h.matcher === matcher);
+  if (!group) { group = { matcher, hooks: [] }; arr.push(group); }
+  group.hooks = group.hooks || [];
+  if (!group.hooks.some(h => h.command === command)) {
+    group.hooks.push({ type: 'command', command });
+  }
+}
+
+function removeHook(arr, command) {
+  if (!arr) return arr;
+  return arr
+    .map(group => ({ ...group, hooks: (group.hooks || []).filter(h => h.command !== command) }))
+    .filter(group => group.hooks.length > 0);
+}
+
+function install() {
+  const SRC_HOOKS = path.join(__dirname, '..', 'braintracker', 'hooks');
+  fs.mkdirSync(DEST_HOOKS, { recursive: true });
+  for (const file of ['pre_skill.js', 'post_skill.js']) {
+    fs.copyFileSync(path.join(SRC_HOOKS, file), path.join(DEST_HOOKS, file));
+  }
+
+  const settings = readSettings();
+  settings.hooks             = settings.hooks             || {};
+  settings.hooks.PreToolUse  = settings.hooks.PreToolUse  || [];
+  settings.hooks.PostToolUse = settings.hooks.PostToolUse || [];
+  addHook(settings.hooks.PreToolUse,  'Skill', PRE_CMD);
+  addHook(settings.hooks.PostToolUse, 'Skill', POST_CMD);
+  writeSettings(settings);
+
+  console.log('braintracker installed.');
+  console.log('Logs → ~/.claude/plugin/cache/cctracking/<project>/<session>.jsonl');
+}
+
+function uninstall() {
+  fs.rmSync(path.join(os.homedir(), '.claude', 'plugins', 'braintracker'), { recursive: true, force: true });
+
+  const settings = readSettings();
+  if (settings.hooks) {
+    settings.hooks.PreToolUse  = removeHook(settings.hooks.PreToolUse,  PRE_CMD);
+    settings.hooks.PostToolUse = removeHook(settings.hooks.PostToolUse, POST_CMD);
+  }
+  writeSettings(settings);
+
+  console.log('braintracker uninstalled.');
+}
+
+function disable() {
+  const settings = readSettings();
+  if (settings.hooks) {
+    settings.hooks.PreToolUse  = removeHook(settings.hooks.PreToolUse,  PRE_CMD);
+    settings.hooks.PostToolUse = removeHook(settings.hooks.PostToolUse, POST_CMD);
+  }
+  writeSettings(settings);
+  console.log('braintracker disabled. Hook files kept. Run "npx braintracker enable" to re-enable.');
+}
+
+function enable() {
+  if (!fs.existsSync(path.join(DEST_HOOKS, 'pre_skill.js'))) {
+    console.error('braintracker is not installed. Run "npx braintracker" to install first.');
+    process.exit(1);
+  }
+
+  const settings = readSettings();
+  settings.hooks             = settings.hooks             || {};
+  settings.hooks.PreToolUse  = settings.hooks.PreToolUse  || [];
+  settings.hooks.PostToolUse = settings.hooks.PostToolUse || [];
+  addHook(settings.hooks.PreToolUse,  'Skill', PRE_CMD);
+  addHook(settings.hooks.PostToolUse, 'Skill', POST_CMD);
+  writeSettings(settings);
+
+  console.log('braintracker enabled.');
+}
+
+const cmd = process.argv[2];
+if      (cmd === 'uninstall') uninstall();
+else if (cmd === 'disable')   disable();
+else if (cmd === 'enable')    enable();
+else                          install();

package/braintracker/hooks/post_skill.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+let raw = '';
+process.stdin.on('data', chunk => (raw += chunk));
+process.stdin.on('end', () => {
+  let payload;
+  try {
+    payload = JSON.parse(raw);
+  } catch {
+    process.exit(0);
+  }
+
+  if (payload.tool_name !== 'Skill') process.exit(0);
+
+  const sessionId = payload.session_id;
+  const prj = path.basename(process.cwd());
+  const cacheDir = path.join(os.homedir(), '.claude', 'plugin', 'cache', 'cctracking', prj);
+  const preFile = path.join(cacheDir, `${sessionId}.pre.json`);
+
+  let preData;
+  try {
+    preData = JSON.parse(fs.readFileSync(preFile, 'utf8'));
+  } catch {
+    process.exit(0);
+  }
+
+  const durationSeconds = (Date.now() - preData.start_time) / 1000;
+  const entry = {
+    type: 'skill_invocation',
+    session_id: sessionId,
+    skill: preData.skill,
+    triggered_by: preData.triggered_by,
+    started_at: new Date(preData.start_time).toISOString(),
+    duration_seconds: durationSeconds,
+  };
+
+  const logFile = path.join(cacheDir, `${sessionId}.jsonl`);
+  fs.appendFileSync(logFile, JSON.stringify(entry) + '\n');
+  fs.unlinkSync(preFile);
+
+  process.exit(0);
+});

package/braintracker/hooks/pre_skill.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+let raw = '';
+process.stdin.on('data', chunk => (raw += chunk));
+process.stdin.on('end', () => {
+  let payload;
+  try {
+    payload = JSON.parse(raw);
+  } catch {
+    process.exit(0);
+  }
+
+  if (payload.tool_name !== 'Skill') process.exit(0);
+
+  const sessionId = payload.session_id;
+  const skill = (payload.tool_input && payload.tool_input.skill) || 'unknown';
+  const triggeredBy = (payload.tool_input && payload.tool_input.args) || '';
+  const prj = path.basename(process.cwd());
+  const cacheDir = path.join(os.homedir(), '.claude', 'plugin', 'cache', 'cctracking', prj);
+
+  fs.mkdirSync(cacheDir, { recursive: true });
+
+  const preFile = path.join(cacheDir, `${sessionId}.pre.json`);
+  fs.writeFileSync(preFile, JSON.stringify({
+    session_id: sessionId,
+    skill,
+    triggered_by: triggeredBy,
+    start_time: Date.now(),
+  }));
+
+  process.exit(0);
+});

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "braintracker",
+  "version": "1.0.0",
+  "description": "Claude Code plugin that logs every skill invocation with duration and triggering prompt",
+  "bin": {
+    "braintracker": "bin/braintracker.js"
+  },
+  "files": [
+    "bin/",
+    "braintracker/hooks/"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}