A private knowledge base of coding errors, how-tos and reference docs — on your PC, served by your machine. kbcode finds it automatically once installed, and backs it up with one command.
How many times have you solved an error — then hit the same error weeks later, with the answer buried in a chat log or a closed tab? Re-searching the internet for something you already figured out is the most expensive habit in coding — the fix you found once should be yours forever.
Capsule fixes that. Every error, fix and how-to you save lives in a private knowledge base on your own PC — searchable in seconds, never uploaded, never lost. kbcode finds it automatically, answers from it, and one command backs it all up.
/capsule backup & restore commands
appear on their own. kbcode talks to Capsule over a local WebSocket
(ws://127.0.0.1:8765) via the installed exe.
Windows 10/11. One self-contained installer — nothing else to install.
Run capsule-setup.exe and click through the installer. It places
the Capsule server under Program Files\Capsule and registers it
with Windows — no admin shell, no PATH edits.
Inside any kbcode session on the same PC, run the slash commands. No setup — kbcode finds Capsule on its own once it's installed.
/capsule status
Shows whether Capsule is installed and where the server lives.
/capsule-backup D:\backups\my-knowledge.capsule
Snapshots everything — every error, fix and how-to — into a
single .capsule bundle file (the extension is added for you if you
leave it off). No destination given? kbcode picks one and tells you where it
saved it. Keep that file somewhere safe — it's your whole knowledge base
in one file.
/capsule-restore D:\backups\my-knowledge.capsule
Brings a backup back in. By default it merges into whatever is already
there — nothing is lost. Add --replace to wipe the current KB
and restore the backup exactly as it was:
/capsule-restore D:\backups\my-knowledge.capsule --replace
Only .capsule files are accepted — other files are
rejected with a clear message.
Capsule is a standalone local server too. From its install folder:
capsule-server.exe --serve --port 8765
It answers read/write requests over WebSocket on
ws://127.0.0.1:8765 — search, get, list, add, update —
so any local script or agent can query your knowledge base directly.
Your Capsule KB is searchable by any local AI or script — so your past fixes answer your future questions, instead of re-asking the internet for answers you already found.
“Search my Capsule KB for how I fixed <paste the error>”.
kbcode answers from your own knowledge base.“Before answering, search ws://127.0.0.1:8765 for anything I already solved about this”.search, get, list, add, update)
and feed the hits into your next prompt.Prompt tip: make “check Capsule first” a standing instruction to your AI — you'll stop re-buying answers you already paid for.
← Back to docs