codewhale.history 2.0.0

package/README.md

@@ -0,0 +1,44 @@
+# CodeWhale Tools Pack
+
+A portable pack of global CodeWhale commands: `//tools` and `//history`.
+
+Cross-platform — works on Windows, Mac, Linux.
+
+## What's inside
+
+```
+tools_for_codewhale/
+├── _list_sessions.js       # codewhale-history command (Node.js)
+├── package.json            # npm package config
+├── tools-install.js        # Cross-platform installer (skills + instructions)
+├── skills/
+│   ├── history/SKILL.md    # //history — calls codewhale-history
+│   └── tools/tools-skill/SKILL.md  # //tools — lists all available tools
+├── instructions.md         # Trigger config (drop into any .codewhale/)
+└── README.md               # This file
+```
+
+## Install
+
+One command:
+
+```bash
+npm install -g codewhale.history && codewhale-tools-install
+```
+
+Then in any CodeWhale workspace, `//tools` and `//history` work immediately.
+
+### Manual per-workspace install (if already globally installed)
+
+```bash
+codewhale-tools-install                          # current workspace
+codewhale-tools-install -p <target-path>        # specific workspace
+```
+
+## After install
+- **`//tools`** — lists every tool available in the current session
+- **`//history`** — lists all chat sessions for the current workspace with cost totals
+
+## Requirements
+- Node.js (for the `codewhale-history` command)
+- CodeWhale

package/_list_sessions.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const sessionsDir = path.join(os.homedir(), '.codewhale', 'sessions');
+const targetWorkspace = process.cwd();
+
+let files = [];
+try {
+  files = fs.readdirSync(sessionsDir)
+    .filter(f => f.endsWith('.json'))
+    .map(f => ({
+      name: f,
+      filepath: path.join(sessionsDir, f),
+      mtime: fs.statSync(path.join(sessionsDir, f)).mtimeMs
+    }))
+    .sort((a, b) => b.mtime - a.mtime);
+} catch {
+  console.log('No sessions found for this workspace.');
+  process.exit(0);
+}
+
+const results = [];
+for (const file of files) {
+  try {
+    const data = JSON.parse(fs.readFileSync(file.filepath, 'utf-8'));
+    const meta = data.metadata;
+    if (meta.workspace === targetWorkspace) {
+      const created = (meta.created_at || '').substring(0, 16) || '?';
+      const title = meta.title || 'Untitled';
+      const msgs = meta.message_count ?? '?';
+      const tokens = meta.total_tokens ?? '?';
+      const cost = meta.cost?.session_cost_usd ?? 0;
+      const model = meta.model || '?';
+      console.log(
+        `${created} | ${title} | ${msgs} msgs | ${typeof tokens === 'number' ? tokens.toLocaleString() : tokens} tok | $${cost.toFixed(4)} | ${model}`
+      );
+      results.push({ msgs: meta.message_count ?? 0, tokens: meta.total_tokens ?? 0, cost });
+    }
+  } catch {
+    // skip files that don't parse
+  }
+}
+
+if (results.length > 0) {
+  const totalMsgs = results.reduce((s, r) => s + r.msgs, 0);
+  const totalTokens = results.reduce((s, r) => s + r.tokens, 0);
+  const totalCost = results.reduce((s, r) => s + r.cost, 0);
+  console.log('');
+  console.log(
+    `TOTAL | ${results.length} sessions | ${totalMsgs} msgs | ${totalTokens.toLocaleString()} tok | $${totalCost.toFixed(4)} |`
+  );
+} else {
+  console.log('No sessions found for this workspace.');
+}

package/instructions.md

@@ -0,0 +1,7 @@
+# Delegated Instructions
+
+## //tools Command
+When the user types `//tools`, immediately load the `tools` skill (from `tools-skill/SKILL.md`) and enumerate every tool available in this session grouped by category with brief descriptions. This works in all sessions once the skill is installed globally.
+
+## //history Command
+When the user types `//history`, immediately load the `history` skill (from `history/SKILL.md`) and list all CodeWhale chat sessions for the current workspace with message count, tokens, cost, and totals. This works in all sessions once the skill is installed globally.

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "codewhale.history",
+  "version": "2.0.0",
+  "description": "CodeWhale utility commands: session history, tool listing — global install",
+  "bin": {
+    "codewhale-history": "./_list_sessions.js",
+    "codewhale-tools-install": "./tools-install.js"
+  },
+  "files": [
+    "_list_sessions.js",
+    "tools-install.js",
+    "README.md",
+    "instructions.md",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=14"
+  }
+}

package/skills/history/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: history
+description: Lists all CodeWhale chat sessions for the current workspace with message count, tokens, cost, and totals. Triggered when the user types `//history`.
+---
+
+# `//history` Command
+
+When the user types `//history`, list all chat sessions from the current workspace with their metadata and a total summary row.
+
+## Behavior
+
+1. Run `codewhale-history` (installed globally via `npm install -g`)
+2. Present the output as a formatted table with columns: Date/Time, Title, Messages, Tokens, Cost, Model
+3. Include the TOTAL row at the bottom
+
+### Important: No-sessions handling
+If the output says "No sessions found for this workspace.", that's **normal**. Do NOT create debug scripts, investigate further, or treat it as an error. Simply relay that message and stop.
+
+## Notes
+- `codewhale-history` is a global npm package — works on Windows, Mac, Linux
+- Filter sessions by the current workspace directory (`process.cwd()`)
+- The skill is installed globally — works in any workspace
+- Do NOT recreate the script or embed it — the npm package is the source of truth

package/skills/tools/tools-skill/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: tools
+description: Lists all available tools and their capabilities. Triggered when the user types /tools.
+---
+
+# `//tools` Command
+
+When the user types `//tools`, enumerate every tool available to the model in this session, grouped by category with a brief description of each.  I want the tool listing, not just the activation notice.
+
+## Behavior
+1. Scan all tools currently available in the runtime
+2. Group by category (File I/O, Search, Git, Sub-agents, RLM, Shell/Execution, Planning, etc.)
+3. For each tool, provide the name and a one-line description of what it does
+4. Present as a readable terminal-friendly list
+
+## Notes
+- Read-only — no files modified or state changed
+- The tool list is dynamic per-session — do not hardcode it
+- Do not fabricate tools; list only what's actually available

package/tools-install.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+/**
+ * CodeWhale Tools Installer
+ *
+ * Installs global skills and workspace triggers for //tools and //history.
+ *
+ * Usage:
+ *   node tools-install.js                          # current directory
+ *   node tools-install.js -p <target-path>          # specific workspace
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const sourceDir = __dirname;
+
+// Parse -p flag
+const pIndex = process.argv.indexOf('-p');
+const workspaceArg = pIndex !== -1 ? process.argv[pIndex + 1] : null;
+const workspacePath = path.resolve(workspaceArg || process.cwd());
+
+// ── 1. Install skills ──────────────────────────────────
+const skillsSource = path.join(sourceDir, 'skills');
+const skillsDest = path.join(os.homedir(), '.codewhale', 'skills');
+
+console.log('[1/3] Installing global skills...');
+if (fs.existsSync(skillsSource)) {
+  for (const entry of fs.readdirSync(skillsSource)) {
+    const src = path.join(skillsSource, entry);
+    if (fs.statSync(src).isDirectory()) {
+      const dest = path.join(skillsDest, entry);
+      fs.cpSync(src, dest, { recursive: true, force: true });
+      console.log(`  -> Copied skill '${entry}'`);
+    }
+  }
+  console.log('  Skills installed.');
+} else {
+  console.log('  WARNING: Skills folder not found.');
+}
+
+// ── 2. Install instructions ────────────────────────────
+console.log('[2/3] Setting up workspace instructions...');
+const dotCodeWhale = path.join(workspacePath, '.codewhale');
+const instructionsDest = path.join(dotCodeWhale, 'instructions.md');
+const instructionsSource = path.join(sourceDir, 'instructions.md');
+
+if (!fs.existsSync(dotCodeWhale)) {
+  fs.mkdirSync(dotCodeWhale, { recursive: true });
+  console.log('  Created .codewhale folder.');
+}
+
+if (fs.existsSync(instructionsSource)) {
+  if (fs.existsSync(instructionsDest)) {
+    const backup = instructionsDest + '.bak';
+    fs.cpSync(instructionsDest, backup);
+    console.log('  Backed up existing instructions.md -> instructions.md.bak');
+  }
+  fs.cpSync(instructionsSource, instructionsDest);
+  console.log('  instructions.md deployed.');
+} else {
+  console.log('  WARNING: instructions.md not found.');
+}
+
+// ── 3. Verify ──────────────────────────────────────────
+console.log('[3/3] Verifying installation...');
+let errors = 0;
+
+const checklist = {
+  'history skill': path.join(skillsDest, 'history', 'SKILL.md'),
+  'tools skill': path.join(skillsDest, 'tools', 'tools-skill', 'SKILL.md'),
+  'workspace instructions': instructionsDest
+};
+
+for (const [name, filePath] of Object.entries(checklist)) {
+  if (fs.existsSync(filePath)) {
+    console.log(`  [OK] ${name}`);
+  } else {
+    console.log(`  [FAIL] ${name} not found at ${filePath}`);
+    errors++;
+  }
+}
+
+console.log('');
+if (errors === 0) {
+  console.log('=== Installation complete! ===');
+  console.log('Make sure codewhale-history is installed globally: npm install -g <path-to-tools_for_codewhale>');
+  console.log('Then type //tools or //history in any CodeWhale session.');
+} else {
+  console.log(`=== Installation finished with ${errors} error(s). ===`);
+}