Repository navigation
Releases
v0.6.0
What's Changed
- feat(gateway): a brain's convention, with themes that grow by @lfoletti in #35
- fix(gateway): a rewrite under a convention keeps the stored metadata it does not send by @lfoletti in #36
- docs(upstream): fiche 12, what a brain's convention asks of the engine by @lfoletti in #37
- chore(release): 0.6.0 by @lfoletti in #38
Full Changelog: v0.5.3...v0.6.0
v0.5.3
What's Changed
Full Changelog: v0.5.2...v0.5.3
v0.5.2
What's Changed
- docs(upstream): fiches 10 and 11, find_nodes for a confined key and folded once a call by @lfoletti in #28
- chore(tests): the benches and the Makefile find the CortexDB clone through CORTEXDB_CLONE by @lfoletti in #29
- build(gateway): CortexDB v2.141.0 by @lfoletti in #30
- fix(gateway): wait for a brain that starts on demand by @lfoletti in #31
Full Changelog: v0.5.1...v0.5.2
v0.5.1
What's Changed
Full Changelog: v0.5.0...v0.5.1
v0.5.0
What's Changed
- docs: the working notes of a lot stay in a local archive by @lfoletti in #20
- chore: the folder on disk is thalamus by @lfoletti in #21
- fix/e2e local recall timeout by @lfoletti in #22
- docs/readme translations by @lfoletti in #23
- docs: the lot notes leave the repository for the local archive by @lfoletti in #24
- chore(hooks): a pre-commit hook refuses a commit on main; one worktree per session by @lfoletti in #25
- feat(version): th-gateway version, th-hook version and GET /v1/version name the release by @lfoletti in #26
Full Changelog: v0.4.0...v0.5.0
v0.4.0
Fourth release of Thalamus, a thin governance layer over CortexDB. Each person sees the brains in Claude Code and chooses them in one dialog.
Work in progress. The interfaces can change between versions before 1.0.
What is new in 0.4.0
/brains, a dialog of the brains. In Claude Code,/brainsopens a dialog laid out as/mcp. It shows one row per brain: a green ✔ when the brain answers, a red ✘ with the reason when it does not,onorofffor the automatic recall, and the access. Enter turns a brain on or off. Esc closes the dialog.- A checklist for
/th-recall. Without arguments,/th-recallasks with a checklist of the brains, then writes the choice. - The write brain is a setting of the project. The skill and
/th-addwrite into the brain that the project'sCLAUDE.md(orCLAUDE.local.md) names, and ask when none is named. th-hook brains --json. For each brain: the access,onoroff, and whether it answers. The reasons areno key,no file(a local brain) andgateway does not answer.
Upgrade
The gateway does not change: th-gateway 0.4.0 has the code of 0.3.0. Upgrade the plugin (claude plugin update thalamus@thalamus) and th-hook, then restart Claude Code.
Install
| File | Content |
|---|---|
thalamus_v0.4.0_<os>_<arch>.tar.gz |
th-gateway and th-hook, for macOS and Linux, amd64 and arm64 |
thalamus-plugin_v0.4.0_<os>_<arch>.tar.gz |
The Claude Code plugin, with th-hook in bin/ |
thalamus-extension_v0.4.0.zip |
The Chrome extension, to load unpacked |
checksums.txt |
The SHA-256 of each file |
go install github.com/lfoletti/thalamus/gateway/cmd/th-gateway@v0.4.0
docker run -p 8787:8787 -v /srv/thalamus:/etc/thalamus ghcr.io/lfoletti/thalamus:0.4.0Changes in the repository
/th-recallchecklist,th-hook brains --json, the write brain inCLAUDE.md, and the dialog of the brains (#16).- The dialog opens with
/brains(#17). - The gateway bench gives the fake identity provider a free port, and commits are signed with the GitHub noreply address (#18).
Full changelog: v0.3.0...v0.4.0
v0.3.0
Third release of Thalamus, a thin governance layer over CortexDB. A slow brain no longer stops the shared recall.
Work in progress. The interfaces can change between versions before 1.0.
What is new in 0.3.0
- A deadline for
th_recall.th_recalltakesdeadline_ms, from 0 to 60000. At the deadline, the gateway fuses the answers it has, and each brain still asked is inskipped, withno answer within N ms. Its call is cancelled. Withoutdeadline_ms, or at 0, the gateway waits for each brain, as before. The deadline is one per call, shared by the brains. - The hook keeps the brains that are ready.
th-hooksends the time left after its connection, less 400 ms. A slow brain is on theSkipped:line, and the gateway is no longer remembered as down for 5 minutes. If less than 600 ms is left after the connection, the hook does not askth_recall, keeps the local brains, and remembers the gateway as down. - Dependencies.
google.golang.org/grpcv1.83.2 andgolang.org/x/netv0.58.0.
Upgrade
The new th-hook works with a 0.2.0 gateway: that gateway ignores deadline_ms and waits for each brain, as before. Upgrade the gateway to get the answers of the brains that are ready.
Install
| File | Content |
|---|---|
thalamus_v0.3.0_<os>_<arch>.tar.gz |
th-gateway and th-hook, for macOS and Linux, amd64 and arm64 |
thalamus-plugin_v0.3.0_<os>_<arch>.tar.gz |
The Claude Code plugin, with th-hook in bin/ |
thalamus-extension_v0.3.0.zip |
The Chrome extension, to load unpacked |
checksums.txt |
The SHA-256 of each file |
go install github.com/lfoletti/thalamus/gateway/cmd/th-gateway@v0.3.0
docker run -p 8787:8787 -v /srv/thalamus:/etc/thalamus ghcr.io/lfoletti/thalamus:0.3.0Changes in the repository
th_recallanswers at a deadline with the brains ready, andgateway/mutate.pynever counts a mutant that does not build as killed (#13).golang.org/x/netv0.55.0 (#11) andgoogle.golang.org/grpcv1.83.2 (#12).
Full changelog: v0.2.0...v0.3.0
v0.2.0
Second release of Thalamus, a thin governance layer over CortexDB. It adds the entities across brains and moves to CortexDB v2.139.0.
Work in progress. The interfaces can change between versions before 1.0.
What is new in 0.2.0
- Entities across brains.
th_entity {entity, brains, skip_brains, max_depth, limit}finds one entity in each brain that the user may read, with the user's own key for that brain. It merges the neighbors by node id, and each neighbor names the brains that serve it.known_inlists the brains that know the entity. A key serves only its part of the graph. A neighbor is an entity, never a passage. Depth 1 by default, 3 at most. Each brain walks 20 nodes by default, 100 at most. - Audit of refused keys. A brain that refuses the caller's key during
th_recallorth_entitynow leaves a named audit line, as any refused read does. - One choice of brains.
th_recallandth_entitychoose their brains in one place. A brain named twice inbrainsis asked once. - CortexDB v2.139.0. The gateway imports v2.139.0, and the benches run against a server built from it. This version opens the graph tools to a key confined to one collection, which
th_entityneeds.
A brain filled through th_add has no entities: a confined key may not declare them, and the gateway has no extractor. The entities come from the producer of the brain.
Upgrade
Each CortexDB server behind the gateway must run v2.139.0 for th_entity. On v2.138.0, a confined key is refused the graph tools, and th_entity lists the brain in skipped. th_recall and the other tools work on both versions.
Install
| File | Content |
|---|---|
thalamus_v0.2.0_<os>_<arch>.tar.gz |
th-gateway and th-hook, for macOS and Linux, amd64 and arm64 |
thalamus-plugin_v0.2.0_<os>_<arch>.tar.gz |
The Claude Code plugin, with th-hook in bin/ |
thalamus-extension_v0.2.0.zip |
The Chrome extension, to load unpacked |
checksums.txt |
The SHA-256 of each file |
go install github.com/lfoletti/thalamus/gateway/cmd/th-gateway@v0.2.0
docker run -p 8787:8787 -v /srv/thalamus:/etc/thalamus ghcr.io/lfoletti/thalamus:0.2.0Changes in the repository
- CortexDB v2.139.0 (#7).
- A weekly watch of the GitHub topics, and the tests of
tools/in the CI and in the pre-push hook (#8). th_entity(#9).
Full changelog: v0.1.0...v0.2.0
v0.1.0
First release of Thalamus, a thin governance layer over CortexDB. Thalamus brings the knowledge of an organisation to each user and to their coding agent, within the rights of each person.
Work in progress. The interfaces can change between versions before 1.0.
What is in 0.1.0
- Rights and keys. One file,
rights.yaml, gives the readers, writers and curators of each brain. The gateway issues one confined key per person and per brain. A change of the rights applies at the next call, without a restart. - Federated recall.
th_recallsearches each brain that the user may read, with the user's own key, and merges the results. Each passage gives its brain, its document and its author.th_getreads a full document. - Proposals and review. A user proposes a document with
th_addor from a page in Chrome. A curator accepts or rejects it withth_pendingandth_review. - Login with OpenID Connect, from the command line (
th-gateway login) and from the extension. - The Claude Code plugin: the recall hook, the MCP tools and the
/th-addand/th-recallcommands. Local and shared brains in one recall. - The Chrome extension: propose a page or a selection. It keeps the main content of the page.
- A proportionate audit: named writes, reviews, logins and refusals. Reads counted per brain and per day, named only on a brain with
audit_reads: true. A retention period. - A pyramid of syntheses per brain, with
th_descend, and questions in several languages withalternate_queries. - REST endpoints (
/v1/brains,/v1/add,/v1/login,/v1/identity) for clients without MCP.
Install
| File | Content |
|---|---|
thalamus_v0.1.0_<os>_<arch>.tar.gz |
th-gateway and th-hook, for macOS and Linux, amd64 and arm64 |
thalamus-plugin_v0.1.0_<os>_<arch>.tar.gz |
The Claude Code plugin, with th-hook in bin/ |
thalamus-extension_v0.1.0.zip |
The Chrome extension, to load unpacked |
checksums.txt |
The SHA-256 of each file |
go install github.com/lfoletti/thalamus/gateway/cmd/th-gateway@v0.1.0
docker run -p 8787:8787 -v /srv/thalamus:/etc/thalamus ghcr.io/lfoletti/thalamus:0.1.0The gateway needs a CortexDB gRPC server for each brain. Thalamus 0.1.0 uses CortexDB v2.138.0. See the README, sections "Install" and "Try it".
Changes in the repository this week
- Review circuit closed to writers and readers (#1).
- CI, pre-push hook, contributing and security policies (#2), code of conduct and templates (#4).
- Release archives, Docker image and release workflow (#5).
Full changelog: https://github.com/lfoletti/thalamus/commits/v0.1.0