ccc-knowledge

$ccc-knowledge — search what we learned

CC Commander · $ccc-knowledge · past lessons from ~/.claude/commander/knowledge/, searchable in one step.

Placeholders like ~~knowledge base refer to connected tools. See CONNECTORS.md.

When to use / when not to

• Use to recall lessons before a similar task, review outcomes by category, or record a lesson by hand.
• Use $ccc-recall to search past session transcripts, and $ccc-memory for project memory in CLAUDE.md and memory/. This skill reads only the Commander knowledge directory.

What the directory holds

File	Written by	Used here
kl-<epoch-ms>.json	the CC Commander CLI (commander/knowledge.js) after a dispatched task, or "Add a lesson" below	lessons: timestamp, task, outcome, category, keywords, patterns.{techStack, successPatterns, errorPatterns}
session-*.json	the plugin SessionEnd hook	session stubs (sessionId, startedAt, endedAt); counted, not shown as lessons
auto-captures.jsonl	the knowledge-capture PostToolUse hook	one line per Write/Edit (timestamp, tool, file); counted in stats

The directory can hold thousands of files, so never glob it with ls *.json (the shell fails with "argument list too long"). Every read goes through the query command in step 1.

What happens

1. Run the query command

All modes use this one command. Replace MODE with recent, search, category or stats, and ARG with the count, topic or category name (quote topics).

node -e '
const fs=require("fs"),path=require("path"),os=require("os");
const dir=path.join(os.homedir(),".claude","commander","knowledge");
const [mode="recent",arg=""]=process.argv.slice(1);
let names=[];try{names=fs.readdirSync(dir)}catch{console.log("EMPTY dir-missing");process.exit(0)}
const L=[];for(const f of names){if(!f.endsWith(".json")||f.startsWith("session-"))continue;
  try{const l=JSON.parse(fs.readFileSync(path.join(dir,f),"utf8"));if(l&&l.timestamp)L.push(Object.assign({file:f},l))}catch{}}
L.sort((a,b)=>String(b.timestamp).localeCompare(String(a.timestamp)));
const sessions=names.filter(f=>f.startsWith("session-")).length;
let captures=0;try{captures=fs.readFileSync(path.join(dir,"auto-captures.jsonl"),"utf8").split("\n").filter(Boolean).length}catch{}
if(mode==="stats"){const by=k=>L.reduce((m,l)=>{const v=l[k]||"unknown";m[v]=(m[v]||0)+1;return m},{});
  console.log(JSON.stringify({lessons:L.length,outcome:by("outcome"),category:by("category"),sessions,captures}));process.exit(0)}
if(!L.length){console.log("EMPTY lessons=0 sessions="+sessions+" captures="+captures);process.exit(0)}
const q=String(arg).toLowerCase();
const hits=mode==="search"?L.filter(l=>JSON.stringify(l).toLowerCase().includes(q))
  :mode==="category"?L.filter(l=>(l.category||"general")===q):L;
const n=mode==="recent"?(Number(arg)||3):10;
const p=l=>l.patterns||{};
for(const l of hits.slice(0,n))console.log(JSON.stringify({date:String(l.timestamp).slice(0,10),category:l.category||"general",
  outcome:l.outcome||"unknown",task:String(l.task||l.description||"").slice(0,120),worked:p(l).successPatterns||[],
  failed:p(l).errorPatterns||[],stack:p(l).techStack||[],file:l.file}));
if(!hits.length)console.log("NO-MATCH "+mode+" "+q);
' MODE ARG