Repository navigation
v0.13.0 “Járngreipr”: MCP tools a seat grips through Brokkr's own broker, a journal read a page at a time, and one folder for Brokkr in every repository
Gloves are not done when they fit the carving. They are done when the
hand that will use them can approach, greet, grip and release.
Járngreipr are Thor's iron gloves, which, the Edda says, he cannot do
without when he lays hold of the hammer's haft. v0.12.0 “Gleipnir” bound
capabilities to the realm. In this release a seat actually grips a granted
tool: on Linux, a realm can grant a Claude seat an MCP server, and the seat
calls it only through Brokkr's own broker. The release also reads the
journal a page at a time, keeps an adopter's Brokkr in one .brokkr/
folder, and adds a run queue, journal backups and boxed hands for dsh. It
includes the changes merged since
v0.12.0.
This release refuses an adopter repository still in the 0.12 layout,
stops seats on Linux from starting your own MCP servers, and parks a
timed-out attempt instead of retrying it. Read
Upgrade and compatibility before you install
it over a working setup.
What changed
-
MCP tools, through Brokkr's own broker (decision 0065, slice two).
- Granting a server. Write a tool dialect of kind
mcp(a stdio
server's argv, its pinned version and its tools), and grant it in the
realm map'scapabilities. For each capability a seat holds, the
engine adds acap-<capability>server beside the box'sworkspace
hands. The harness starts it asbrokkr broker serve, Brokkr's broker
(decision 0077).brokkr doctorshows each seat's whole capability
plan. - Each server in its own box. The broker runs the real server in a
box of its own: its program read-only, a private home and temp
directory, no workspace, a cleared environment, and only the network
its egress class allows. - The broker is the gate. It lists only the granted tools, refuses
any other call by name, and masks every bound secret in a response.
Each call is in the attempt's ledger before it is forwarded or
refused, and lands in the journal as aseat-record.v6checkpoint when
the attempt settles. - Kept responses. A dialect may keep its responses, and the realm may
veto that withretain: false(forge.realms/v8).
brokkr inspect --run <run> --capability-call <id>opens a kept
response, verified against its digest. - No ambient MCP on Linux. Every model seat is launched with only the
servers Brokkr names: none, the box's hands, or its brokers. Your own
MCP configuration no longer reaches a seat. A harness not measured to
shut it out is refused at compile, and the final launch check refuses
a server set that differs from the sealed one. - A real seat, end to end. A real Claude seat holding a grant
completed a run, and its call's response read back through
brokkr inspect. On the way, the broker learned to answer any MCP
initializewith its own version (2025-06-18), a brokered Claude
launch allows each broker asmcp__cap-<capability>, and the broker
closes its ledger on SIGINT or SIGTERM. - Host checks.
brokkr driversetsno_new_privsbefore a brokered
harness, and refuses where it cannot. MCP servers refuse to start where
/proc/sys/dev/tty/legacy_tiocstiis absent or not0. - One run per worktree, for every run. Every dispatched attempt
reserves its sites, whether or not it brokers anything. A second run
whose writers would reach a worktree that a standing attempt writes is
refused until the first is proven settled.brokkr operator release
journals your attestation that a run's ended attempts left no process,
and frees the worktree. Where HOME does not resolve to a protected
coordination root, an attempt that protects no evidence proceeds
unreserved, and one that does refuses. - Harder boxes. Every workspace box hides the secrets store and opens
in a user namespace that can make no further one. - Limits. Linux only: on macOS every
mcpgrant still refuses at
compile. Claude only: a brokered grant on a Codex or dsh seat refuses
at compile. The seat needs workspace hands undernamespace, with the
network off. A server may bind a secret on a Claude work seat: Claude
Code 2.1.316's boxed replacement session is measured
(#958). URL
connections, secrets in the argv and nonempty restrictions refuse. - Documented. The guides, the status page and the security model say
what this slice built, and what it did not.
#956 - Audited. Before this release, every slice-two unit was checked
against its removals, its proofs and the frozen contract bytes. The
audit changed no production code; it corrected one evidence citation
in Codex's shipped adapter declaration. The proofs it found missing
are repaired by slice two's remaining units, after this release.
#963
#524,
#552,
#640,
#745,
#804,
#827,
#834,
#853,
#875,
#924,
#933,
#940,
#952,
#955 - Granting a server. Write a tool dialect of kind
-
dsh seats get boxed hands (decision 0098). A seat whose office
declares boxed hands runs dsh 0.2.1 with its ten effectful tool rows
disabled, so Brokkr'sworkspaceserver is its only effectful tool.- The driver checks dsh's composed configuration before the session and
refuses an unexpected row by name. A hand that did not activate fails
the seat closed. - On Linux the seat runs on an engine-only dsh home, measured to shut out
ambient MCP. - An office may declare
access: read-onlyorwrites; one that
declares neither reads aswrites. - Brokkr reads dsh 0.2's session transcripts, plain and compressed.
- The driver checks dsh's composed configuration before the session and
-
A journal read a page at a time (decision 0089). On a 1.1 GB journal,
0.12.0's console held 2.6 GB andbrokkr runs --jsontook 6.7 s. A page
now costs the same at any journal size.- Projections. The writer keeps a summary row per run, a seat row per
participant and an index row per event, in each append's transaction.
brokkr doctorchecks them against a fresh fold. - The fleet. The console (
brokkr tui),brokkr runsand
/api/runsread a page of summary rows at a time;brokkr runstakes
--limitand--after. The console refreshes only what landed since,
off the input loop (decision 0088). - One run. A run is opened by verifying its chain one event at a
time, and a corrupt run is refused as before.inspect,seats,
watch,transcript,costs,compareand/api/viewread through
the pages and print the same bytes. The run view's first screen costs
15 ms and 250 KB at any journal size. - The console's run screens read pages too. A movement key pressed
while a page loads is held, in order, and applied when that page
arrives, so the cursor moves exactly as it would on a whole read. A
held key belongs to the view it was pressed on, and is dropped if that
view leaves the frame (a narrower or shorter terminal, or another run,
seat or tab). The queue holds 64 runs of keys; an overflow drops the
oldest and says so.
#964
- Projections. The writer keeps a summary row per run, a seat row per
-
One folder for Brokkr in every repository (decision 0083).
brokkr init <dir>writes.brokkr/and nothing else, with a
.gitignorethat keepsstate/out of git.--cli <claude|codex|dsh>
picks the agent CLI instead of PATH's order.- Every verb finds the folder from anywhere in the repository, and keeps
the journal, secrets and results under.brokkr/state/. The folder is
the default bundle, sobrokkr run --feature "…"needs no--bundle. brokkr doctor's first line names the folder. In a dsh folder it says
whether dsh reaches a key for each route the folder pins.- The guides place a personal realms map outside the repository, at
$XDG_CONFIG_HOME/brokkr/realms/<name>.json, selected with--realms
(decision 0101).
-
Recipes that travel.
- Shelves. A folder keeps named recipes at
.brokkr/recipes/<name>.
recipes add --personalinstalls onto a personal shelf at
$XDG_CONFIG_HOME/brokkr/recipes, and a name on both shelves refuses.
A personal recipe may extend a project recipe, never the reverse.
recipes add --pathinstalls from a subdirectory of a git source. - Portable recipes (decisions 0087 and 0091).
fastandnode
install into a fresh folder. A recipe seat may say"from": "folder"
to run the folder's own declaration, sofast's verify and ship are
now the folder's own. Brokkr's own verifier moves tobrokkr-fast, and
its own offices are namedbrokkr-*. - Composition (decision 0078).
review-first,nodeand
panel-reviewextendfast, and Brokkr's own bundles are now
recipes/selfandrecipes/verify.
- Shelves. A folder keeps named recipes at
-
A run queue (decision 0068).
brokkr queuekeeps runs waiting in the
journal's own database. Only your commands move them, each journaled with
its reason.queue addtakesbrokkr run's arguments, plus--priorityand
--after <entry>:<completed|ended>.move,hold,releaseand
dropmanage entries.queue listsays why each entry waits or is held. An entry whose realm
changed under it is held until yourepin, re-queue or drop it.
Capacity comes from the machine's ownhost.json(forge.host/v1):
concurrency ceilings per provider and route, free-space floors and a
boxed-build ceiling.- Nothing starts a queued run yet. The
brokkr dispatchcommand is a
later slice.
-
Cheaper recovery.
brokkr operator retry --member <name>reruns only the named panel
members, and carries the others' settled verdicts while what they
judged is unchanged (decision 0093).brokkr run --enter <gate> --continues <run>starts a run at a gate
over work already on the branch. Review seats judge the branch from its
merge-base (decision 0094).- An environment block parks for you instead of stopping the run
(decision 0092). brokkr operator acknowledgeanswers a quarantined run whose journal
does not fold, and it lists under "older" until its journal moves.- A run whose stop was accepted but which has no ending reads
stopping, files under "needs you", and namesbrokkr conclude
(decision 0102).
-
An attempt ends only on evidence.
- Timeouts park. A deadline kill, a protocol violation after start
and a lost result end the attemptindeterminateand park the run, so
no retry repeats an effect nobody read (decision 0006's addendum). - A bounded transport (decision 0079). A driver is held to a 16 MiB
stdout line, 100,000 checkpoints and 64 MiB of checkpoint lines, and
endsindeterminatepast any of them. Past 1 MiB, its stderr keeps a
head and a tail. The loopback UI holds each request to named limits
too. - Attempt correlation (decision 0096). Driver evidence is admitted
only for the attempt its start carried. - The tracker's tick (decision 0099). On Linux an idle run driver
walks only the engine's own process tree, instead of the host's whole
process table every 100 ms: about 0.25% CPU. - Exec boxes in RAM. A single-shot exec box writes its overlays to
RAM, so a finished step no longer parks while the box tears down.
- Timeouts park. A deadline kill, a protocol violation after start
-
Journal backup and restore (decision 0100).
brokkr backup --to <dir>takes one consistent snapshot while writers
run, and writes its versioned inventory last.brokkr restore --from <dir> --to <path>restores into a new path
only, once size, digest, SQLite integrity, every chain, the counts and
the projections all agree with the inventory. It starts nothing.- Git objects, the
refs/forgeanchors and kept artifacts are not backed
up yet, and no secret value is copied. - Each verb binds its paths to one literal path before SQLite sees them,
so a destination such asfile:x?yis a directory of that name, never
a SQLite URI. - Decision 0100 is accepted.
-
Bundles: their own files, within bounds. A bundle's identity skips
.gitand git-ignored trees. A bundle past 5,000 files or 64 MiB per
pinned layer is refused by name before any run starts. Every exec script
pinned in a compiled layer is re-walked at spawn, hands or none, so a
script edited after the compile never runs.
#934,
#836 -
Policy proves what it promises (decision 0050).
- Compile refuses a table that cannot rule as written: a dead rule, an
unreachable phase, a dead end, an unread hard input, an unruled
valuation, or more than 65,536 valuations to sweep. - Every shipped delivery table names a park for a residual rated none
(REVIEW-RESIDUAL-NONE), and the fold's transitions are one table. - A sequence's endings are compiled. Each step but the last pins the
words that end the sequence (ends_on): its seat's words no reachable
later step can emit, and every hard word it can emit. A hard word, such
as a panel'ssecurity-hold, ends the sequence wherever it is
reported. Compile refuses a table arm no reachable step can emit. A
judge cannot overrule a deterministic check's failure, whether the
sequence ends early or at its last step.
- Compile refuses a table that cannot rule as written: a dead rule, an
-
Seats and providers.
brokkr probe harness --adapter <claude|codex|dsh>runs an agent
CLI in a scratch repository and HOME, and reports each fact its adapter
must declare (decision 0075). It spends the CLI's credentials: host
only, never CI.- The provisional tier. A provisional model is seated only in the
offices the world's map lists underprovisional_offices
(forge.realms/v7), and never at a gate. - Claude accounting. A Claude seat's tokens no longer read two and a
half times over, cache writes count as misses, and a resumed attempt
counts only its own cost. - Fallbacks.
fast,nodeandverifyseats fall back from Fable to
Opus at high instead of parking. - A local route.
night-shiftandwager-harness-dshseat their dsh
implement lanes on GLM-5.3 Flash on a local route, so they run only on
a host that serves it.
-
The DSH console. A plugin under
extensions/dsh/brokkr-console/,
installed by hand, opens Brokkr as a tab in each DSH conversation. It
paints Brokkr's--jsonreadouts and presses retry, stop, resume and
conclude after re-reading the run's head. Two new read-only verbs feed
it:brokkr analytics(what the runs did over a range) and
brokkr graph(one recipe's state machine and its traffic).
#660,
#685,
#731,
#813 -
Contracts have a lifecycle (decision 0082). Every contract version
has one row in the versioning guide, checked against its loader and
minted under an accepted decision.
#937 -
Dependency security fixes for RUSTSEC-2026-0344 (ruzstd),
-0346 to -0349 (rustls), and -0381 and -0382 (webpki).
#664,
#677,
#806 -
Code health (#330). The engine, the bundle compiler, the agent loader
and the CLI are split into named modules under the complexity ceiling,
and refusals and run states are typed. Every output keeps its bytes. The
status page and the security model say what decision 0065 enforces.
#656,
#727,
#669,
#671,
#518 -
CI. Merge groups run on hosted runners, and the suite and the exact
coverage gate on parallel machines. An unreadable coverage profile is
left out and named, and the long jobs may run 90 minutes.
#710,
#947,
#944
Upgrade and compatibility
An adopter repository in the 0.12 layout is refused. A repository that
0.12's brokkr init scaffolded, with its bundle and .forge/ at the root,
is refused, and the refusal lists the moves into .brokkr/. It lists them
only for a clean tree, and none when a symbolic link stands under
.forge. Make the moves, commit, and run brokkr doctor. Until then,
--db still reads the old journal in place. A recipe library keeps its
layout.
On Linux, seats no longer start your own MCP servers. Every model seat
(Claude, Codex and dsh; not an exec seat) is served only its isolated set:
nothing, its hands, or its brokers. So the servers in your Claude Code or
Codex configuration, or your dsh home, never start, grant or no grant. A
seat whose shape is not measured on Linux (an unmeasured shape, or a dsh
route outside the measured ones) now refuses with the isolation check's
cause instead of running. A driver you run by hand, with no sealed intent,
is served as before. If a seat relied on one of your servers, grant it
through the realm instead; today that works for a Claude seat with
workspace hands and the network off, including a server that binds a
secret. A Codex seat refuses on a host that holds /etc/codex/config.toml
or /etc/codex/managed_config.toml.
Linux hosts need bubblewrap 0.11 and Linux 5.11. A seat that binds an
overlay, as the shipped recipes' cache binds do, needs bubblewrap 0.11.
Every boxed launch needs Linux 5.11, for close_range with
CLOSE_RANGE_CLOEXEC. A nested unshare -U or bubblewrap inside a box now
fails.
Timed-out attempts park. A deadline kill or a lost result parks the run
indeterminate instead of retrying. Check what the attempt did, then
brokkr operator retry it or brokkr conclude the run.
Two endings announced in 0.12.0 arrive.
- A hands tree with no lock file is kept. A tree under the temporary
directory that holds no lock file is now kept and reported, never
reaped. The report reads: "hands: kept : its lock cannot be
probed: it holds no lock file; trees from before #415 are no longer
reaped (0.13.0)". Once no older engine is using such a tree, remove it
yourself. (#415) brokkr_protocol::hands::box_argvis removed. It was deprecated in
0.12.0, and its retirement this cycle made it refuse every call. A Rust
caller runs a box throughhands::run_boxedorhands::execute.
#969
Your own policy tables must rule every case. Compile now refuses the
tables above, naming the ruling. Add a named park for a residual rated
none, as the shipped REVIEW-RESIDUAL-NONE does, before you move a host to
0.13.
Recipes moved. bundles/self and bundles/verify are now
recipes/self and recipes/verify, and brokkr recipes list lists the
library only. Outside a folder, fast's verify fails closed and runs no
check; Brokkr's own verifier is brokkr-fast.
Finish or conclude 0.12 runs with 0.12. Every compiled bundle's digest
moved, so a pinned resume of a run started under 0.12.0 refuses.
brokkr conclude closes one from its journal alone.
The journal migrates itself. The first 0.13 writer to open a journal
backfills the projections, one run at a time; on journals of over a
gigabyte this took seconds. A read-only open migrates nothing.
event_schema, database_schema and driver_protocol all stay 1.
Before a run that keeps MCP evidence, let older engines finish. An
engine older than 0.13 takes no worktree lease, so 0.13 cannot see it.
Also changed in this cycle:
- The secrets store must stay owner-only, as
brokkr secrets setcreates
it; a workspace box refuses a store with group or other permission bits. - An office that declares no
accessbeside its hands reads aswrites. /api/run/<id>is retired; read/api/view. Scripts that read--json
seeview_version28, where 0.12.0 wrote 15.
#623
New contracts. realms.v7, realms.v8, run-manifest.v12 to v14,
seat-record.v6, host.v1 and panel-carry.v1 sit beside their earlier
versions; no earlier frozen bytes changed. The binary remains brokkr,
with Rust 1.88 as the minimum build version.
Verifying a download. Check it against SHA256SUMS, and its build
provenance with gh attestation verify <asset> -R feedback-loop-ai/brokkr.
Accepted, not yet in this build
- Decision 0064: a run says how it ended. Runs still end
completedor
stopped. - Decision 0065, slice three, and slice two's remaining units.
- Decision 0068: the dispatcher. The queue is here; nothing starts a
queued run yet. - Decision 0103: a provider's rate limit becomes a cool-down, not a
park. It is a design only. - Decisions 0067, 0072, 0074 and 0080: the plan as the schedule, full
access as the box's to give, many hands, and an attempt as its own
cgroup. - Decision 0101 beyond the guides' personal map.
Built here but still proposed: decisions 0086 (dsh's session version
four), 0090 (another build's reservation), 0092 (an environment block
parks) and 0094 (a run enters at a gate). Decisions 0066, 0070 and 0076
remain proposed too.
Known issues
- On macOS, seats still start your own MCP servers. The MCP fence is
set per host at build time: it stands on macOS, where everymcpgrant
refuses, and no shape is measured there, so a seat is served as in 0.12
and starts your user-scope servers. On every host, a Claude seat loads your settings,
CLAUDE.mdand hooks.
#467 - Seats can receive cross-session messages from other interactive
Claude Code sessions on the host.
#505 - A boxed dsh hands seat has not run end to end through
brokkr driver
on a measured route, because the driver's route grammar refuses that
route as configured.
#953 - A large panel that keeps MCP evidence can park under load. Each
member surveys the host inside one 30-second startup bound; a 32-member
panel parked at a load near 6. - A boxed exec attempt can still park
indeterminate, rarely: one in
40 stressed runs. Retry it.
#504 - A journal path that begins
file:is read as a SQLite URI by
--dband a map'sjournal. Give journals absolute paths.
#954 - dsh seats still cannot commit, and keep dsh's own web search and
fetch. #282,
#462