Spring til indhold

Snart

Dine sessioner bliver til viden.

pks-brain

Gør Claude Code-sessioner til en søgbar graf, wiki, ADR’er og commit-grunde du ejer.

Illustration af pks-brain

Du har bygget alt det — og din historik ligger og rådner.

Hver gang du koder med en agent, vokser der en perfekt log: hver prompt du skrev, hvert værktøj den kaldte, hver fil den rørte. Den ligger som JSONL på din disk og bliver aldrig læst igen. Så når nogen spørger “hvorfor ser den her fil sådan ud?”, eller du skal skrive en commit-besked, eller projektet mangler den wiki og de ADR'er rigtige projekter har — så starter du forfra, fra hukommelsen, som om de tre måneders arbejde aldrig blev gemt. Det blev det. Vi vendte logen til et grafindeks, du kan spørge — og lod den skrive artefakterne selv.

  • Hver session er allerede gemt som JSONL — og bliver aldrig læst igen.

  • “Hvorfor ser denne fil sådan ud?” kan ingen svare på, selvom svaret står i en prompt, du selv skrev.

  • Wiki, ADR'er og commit-beskeder med rigtige grunde skriver ingen — så vibe-kode bliver aldrig til et rigtigt projekt.

Fem faser. Genkør kun den, du har brug for.

  1. Ingest — det deterministiske dump

    `pks brain ingest` dumper hver session-JSONL til kompakte firehose-filer: prompts, tools, files, errors. 100% deterministisk, kører på 1-2 sekunder, koster nul tokens og kan genkøres gratis når som helst.

  2. Extract — ét AI-resumé per session

    `pks brain extract` skriver et markdown-resumé per session, drevet af en redigerbar brain-extract-skill. Tolkningen er din at forme — og holdes adskilt fra den deterministiske sandhed.

  3. Synth & wiki — temaer bliver til sider

    `pks brain synth` klynger sessioner tematisk på tværs af projekter; `pks brain wiki` skriver én wiki-side per klynge. Automatisk wiki-generering ud af det arbejde, du allerede har lavet.

  4. ADR & refresh — destillér og kæd det

    `pks brain adr` destillerer arkitektoniske klynger til ADR'er. `pks brain refresh` kæder alle fem faser; ellers genkører du bare den ene fase, der trænger. Hver fase er sin egen kommando og sit eget checkpoint.

Se det køre

pks brain refresh
# Harvest every session that's already on disk.
❯ pks brain ingest
scanned 312 sessions in ~/.claude/projects/
  prompts.jsonl   6,984    tools.jsonl   88,102
  files.jsonl    46,217    errors.jsonl     431
ingest complete in 1.7s — 0 tokens spent
❯ pks brain extract
wrote 2,940 session extracts -> .pks/brain/extracts/
❯ pks brain synth && pks brain wiki && pks brain adr
clustered 19 themes -> 19 wiki pages, 6 ADRs
brain refreshed — your history is now queryable.

Deterministisk dump først (gratis, nul tokens), så AI-laget ovenpå — alt sammen rene filer i .pks/brain/.

Det kan den

  • Deterministisk firehose, nul tokens

    `ingest` dumper hver session til prompts-, tools-, files- og errors-filer på 1-2 sekunder uden at bruge en eneste token — og kan genberegnes gratis når som helst.

  • En graf, ikke en log

    Fire node-typer — Session, Prompt, ToolCall, File — og kanter som drove og wrote/edited/read. Firehoserne deler sessionId og timestamp, så joins er gratis.

  • Automatisk wiki og ADR'er

    `synth` klynger temaer på tværs af projekter; `wiki` skriver én side per klynge og `adr` destillerer de arkitektoniske til beslutningsdokumenter — artefakterne rigtige projekter har, uden at du skriver dem.

  • Commits, der forklarer hvorfor

    `commit-plan` grupperer dine working-tree-ændringer i commits med rigtige grunde — taget fra de faktiske prompts, der drev hver redigering. Beskeden forklarer hvorfor, ikke bare hvad.

  • Søg hele din historik

    `search` gør al historik søgbar: pej på en fil og find den prompt, der drev ændringen, og hvorfor. Den kan også vise dine tilbagevendende dårlige vaner og coache dig på dem.

  • To scopes, rene filer

    En bruger-bred firehose i ~/.pks-cli/brain/ er maskinrummet på tværs af projekter; ./.pks/brain/ i hvert repo holder wiki, ADR'er og specs for det projekt. Ingen database, ingen graf-motor, ingen SaaS.

  • Sandhed og tolkning er holdt fra hinanden med vilje. Den deterministiske kerne kan genkøres gratis og koster nul tokens; AI-laget er fortolkning ovenpå — aldrig blandet ind i det, der bare er sandt.

  • Det er JSONL og markdown, hele vejen ned. Ingen database, ingen graf-motor, ingen managed control plane, ingen SaaS — bare filer på din disk, du kan læse, flytte og eje.

  • Det høster det, du allerede har. Dine sessioner ligger der i forvejen; pks-brain henter en formue af viden ud af dem uden at du ændrer en eneste arbejdsgang.

  • Start vibe, bliv pro. Vibe-kod frit — hjernen konvergerer stille dit kaos til wiki, ADR'er og commit-grunde, så et legeprojekt umærkeligt vokser til et rigtigt et.

Bygger sammen med

Hver session, du allerede har kørt — nu som viden.

Hver Claude Code-session ligger allerede som JSONL i ~/.claude/projects/ og bliver aldrig læst igen. pks-brain høster den: ét rigtigt repo gav ~7.000 prompts, 88.000 tool-kald og 46.000 fil-operationer. En deterministisk kerne, der koster nul tokens og kan genkøres gratis — og et AI-lag, der gør den til wiki, ADR'er og commit-beskeder med rigtige grunde. Start vibe, bliv pro.

Udforsk hele suiten