Repository navigation
Releases
Bothy v2026.11.2
What's Changed
- docs(plans): a Bothy website, served by the box and published (later) by @YehudaBriskman in #387
- chore(installer): pin v2026.11.1 and its checksums hash by @YehudaBriskman in #388
- docs(plans): website follows WindoM's model; domain bothybox.com by @YehudaBriskman in #389
- fix(release): put the manifest line into the published checksums.txt by @YehudaBriskman in #390
- test(lab): bothy install against the real v2026.11.1 release by @YehudaBriskman in #391
- fix(cli): accept the real manifest schema; classify gh attestation results by @YehudaBriskman in #392
- chore(release): 2026.11.2 by @YehudaBriskman in #393
Full Changelog: v2026.11.1...v2026.11.2
Bothy v2026.11.1
What's Changed
- docs(plans): record the owner's acceptance of D15-D28 by @YehudaBriskman in #368
- chore(installer): pin v2026.11.0 by @YehudaBriskman in #369
- docs(plans): native-package distribution (deb, rpm, apk, repo, keys), D29-D39 proposed by @YehudaBriskman in #370
- feat(ops): the operation catalog and a read-only /v1 API (slice 1, Python side) by @YehudaBriskman in #371
- docs(plans): measured Go-vs-Rust reassessment of the CLI language (D15) by @YehudaBriskman in #372
- docs(plans): spikes S5d, S6b, S16 from the VM lab by @YehudaBriskman in #373
- docs(plans): record D15 kept, D29-D39 decided, and D40-D43 for /v1 exposure by @YehudaBriskman in #374
- feat(ops): Caller object and per-op exposure as catalog data (D41, D42) by @YehudaBriskman in #375
- feat(cli): the bothy CLI and a read-only stdio MCP server (slice 1) by @YehudaBriskman in #376
- feat(release): CLI release binaries, checksums, attestation and bothy.sh --binary by @YehudaBriskman in #380
- test(cli): run the CLI and MCP server against the real API; fix five defects by @YehudaBriskman in #381
- feat(release): publish own images to GHCR by digest and attach release-manifest.json (D34) by @YehudaBriskman in #382
- feat(cli): bothy install and uninstall for Bivvy from an embedded stack (prototype, lab-proven) by @YehudaBriskman in #383
- chore(portal)(deps): bump framer-motion from 14.13.0 to 14.14.0 in /apps/bothy-web/web in the bothy-web-minor-and-patch group by @dependabot[bot] in #379
- chore(deps): bump traefik from v3.7.18 to v3.7.19 in /edge by @dependabot[bot] in #378
- feat(ops): bearer-token authentication for the read-only /v1 API (slice 2A, D43) by @YehudaBriskman in #384
- feat(cli): file-provider edge, files module and bothy update with rollback (lab-proven) by @YehudaBriskman in #385
- chore(release): 2026.11.1 by @YehudaBriskman in #386
Full Changelog: v2026.11.0...v2026.11.1
Bothy v2026.11.0
What's Changed
- fix(upgrade): our own images are rebuilt on upgrade - and CI proves it by @YehudaBriskman in #182
- release: the installer serves v2026.9.0 by @YehudaBriskman in #183
- pins, Dependabot coverage, and --wait on every up (updates step 1) by @YehudaBriskman in #184
- updates step 3: discovery on the host + read-only Settings > Updates by @YehudaBriskman in #186
- fix(updates): read the KSM chart pin from Chart.yaml (main is red without it) by @YehudaBriskman in #192
- rename socket-proxy.yml -> compose.socket-proxy.yml so Dependabot bumps the boundary image by @YehudaBriskman in #185
- updates step 2: backups that match reality, and restore recipes by @YehudaBriskman in #187
- chore(deps): bump traefik from v3.7.9 to v3.7.12 in /edge by @dependabot[bot] in #191
- chore(deps): bump postgres in /auth by @dependabot[bot] in #193
- bothy-files: accept the reviewed bootstrap.sh survey hit by @YehudaBriskman in #194
- updates step 4: the host updater - deploy what main pins, from Settings by @YehudaBriskman in #195
- chore(deps): bump grafana/loki from 3.7.7 to 3.7.8 in /monitoring by @dependabot[bot] in #196
- chore(apps)(deps): bump python from 3.13-alpine to 3.14-alpine in /apps/bothy-files by @dependabot[bot] in #197
- chore(apps)(deps): bump python from 3.13-alpine to 3.14-alpine in /apps/bothy-ops by @dependabot[bot] in #198
- updates step 7: automatic patches in the night window, pause on failure by @YehudaBriskman in #200
- updates step 5: Grafana and Keycloak - one-way updates with snapshot and restore by @YehudaBriskman in #201
- dependabot: hold React below 19.3 until @react-three/fiber supports it by @YehudaBriskman in #202
- chore(portal)(deps): bump the bothy-web-minor-and-patch group in /apps/bothy-web/web with 2 updates by @dependabot[bot] in #203
- design batch 1: the accessibility blockers from the Apple-design audit by @YehudaBriskman in #204
- updates step 6: Bothy updates itself to a green release, with a rollback timer by @YehudaBriskman in #205
- minikube: keep the cluster node's fixed IP free at boot by @YehudaBriskman in #206
- design batch 2: tokens and shared primitives - press states, one Button, rem type scale, 44px touch by @YehudaBriskman in #207
- updates step 8: cluster add-ons and the Postgres major, through the updater by @YehudaBriskman in #208
- design batch 3: overlays and motion - spring dialogs, anchored popovers, no blank page changes, theme follows the OS by @YehudaBriskman in #209
- design batch 4: one type scale, one spacing and radius set, every icon through ui/Icon by @YehudaBriskman in #210
- Control: a real landing page - health strip, needs attention, quick links, cluster, edge, activity by @YehudaBriskman in #211
- one loader: a thinking-orbs orb behind seven semantic states, and no hand-made spinner comes back by @YehudaBriskman in #212
- design batch 5: tables become cards on a phone, five shared states, and confirmation that follows reversibility by @YehudaBriskman in #213
- SECURITY.md counts its own role-gated routers, and a check holds the number by @YehudaBriskman in #214
- bothy-collector: from system:masters to list on five kinds by @YehudaBriskman in #215
- a loader over content gets a plate, every skeleton reserves its own page, and Prometheus stops being offered by @YehudaBriskman in #216
- kb: fence the cloud node off the tailnet (proposal + runbook, not applied) by @YehudaBriskman in #217
- kb: the ACL proposal carries placeholders, not four personal machines' addresses by @YehudaBriskman in #219
- two more statuses: a one-shot that finished is Done, a project nobody runs is Dormant by @YehudaBriskman in #237
- the documents that count things now count what the tree counts by @YehudaBriskman in #218
- chore(portal)(deps): bump node from 26.9.0-alpine to 26.10.0-alpine in /apps/bothy-web by @dependabot[bot] in #220
- chore(deps): bump postgres in /auth by @dependabot[bot] in #222
- chore(apps)(deps): bump python from
016508bto9e9fde4in /apps/bothy-files by @dependabot[bot] in #221 - chore(apps)(deps): bump python from
016508bto9e9fde4in /apps/bothy-ops by @dependabot[bot] in #224 - chore(k8s)(deps): bump kube-state-metrics from 8.5.0 to 8.6.0 in /k8s/monitoring by @dependabot[bot] in #223
- chore(deps): bump traefik from v3.7.12 to v3.7.13 in /edge by @dependabot[bot] in #225
- chore(deps): bump oauth2-proxy/oauth2-proxy from v7.15.4 to v7.15.5 in /apps/headlamp by @dependabot[bot] in #228
- chore(deps): bump keycloak/keycloak from 26.7.4-0 to 26.8.0-0 in /auth by @dependabot[bot] in #229
- chore(deps): bump oauth2-proxy/oauth2-proxy from v7.15.4 to v7.15.5 in /auth by @dependabot[bot] in #230
- chore(deps): bump victoriametrics/victoria-metrics from v1.152.0 to v1.153.0 in /monitoring by @dependabot[bot] in #231
- chore(deps): bump grafana/alloy from v1.19.2 to v1.20.1 in /monitoring by @dependabot[bot] in #232
- chore(deps): bump grafana/grafana from 13.2.2 to 13.2.3 in /monitoring by @dependabot[bot] in #233
- chore(portal)(deps): bump nginx from
62ff208todf221dbin /apps/bothy-web by @dependabot[bot] in #234 - chore(k8s)(deps): bump grafana/alloy from v1.19.2 to v1.20.1 in /k8s/monitoring by @dependabot[bot] in #235
- chore(portal)(deps): bump the bothy-web-minor-and-patch group across 1 directory with 9 updates by @dependabot[bot] in #236
- dependabot: the duplicates collapse, the frozen rollback targets stop being offered, and one check holds Alloy's four pins by @YehudaBriskman in #238
- chore(portal)(deps): bump lucide-react from 1.50.0 to 1.51.0 in /apps/bothy-web/web in the bothy-web-minor-and-patch group by @dependabot[bot] in #239
- chore(portal)(deps): bump framer-motion from 13.5.1 to 14.0.0 in /apps/bothy-web/web by @dependabot[bot] in #240
- the cluster e2e's constants track the tree's pins, and a check says which one you forgot by @YehudaBriskman in #241
- two checks counted a generated file, so they passed in CI and failed on the box by @YehudaBriskman in #242
- Settings > Updates: check now, run the night job, and a reason for every command that got no button by @YehudaBriskman in #243
- the e2e stops racing the default ServiceAccount, and nine dead aliases leave the console's warning map by @YehudaBriskman in #244
- /system/df comes off the ten-second loop, because it was making the box look sick by @YehudaBriskman in #245
- Bothy Files loads a folder at a time, so the 4,000-file cap and the 15,000 files behind it are gone by @YehudaBriskman in #246
- batch A: the strip stops spanning, a primary tile you pick, one tablist, the Control landing on the tile unit, icons bound to their box, and the Updates row behind a disclosure by @YehudaBriskman in #247
- batch B: the ConfigMap allowlist goes 3 keys to 22, every locked key says why, and the confirm levels stop being retyped by @YehudaBriskman in #248
- oauth2-proxy depends on the seeding, which was true and unstated by @YehudaBriskman in #249
- a group applies a whole recipe at once, because 'by hand' took Grafana down for eight hours by @YehudaBriskman in #250
- the mark had two geometries, three comments saying it had one, and a second generator that would have overwritten three live icons by @YehudaBriskman in https://github....
Bothy v2026.9.0
What's Changed
- docs(plans): the master plan for all fourteen open issues by @YehudaBriskman in #111
- fix(settings): say that a theme you wrote is a file, not a browser key by @YehudaBriskman in #112
- fix(files): the IDE opened on the one root that aliases every other by @YehudaBriskman in #113
- fix(doctor,monitoring): a true statement about a new box is not a fault by @YehudaBriskman in #114
- feat(theme-editor): the raw-CSS pane types in the real code editor by @YehudaBriskman in #115
- chore(socket-proxy): rename portal-socket-proxy to bothy-socket-proxy by @YehudaBriskman in #116
- feat(installer): scripts/bothy.sh - clone at a pinned release, verify the commit, stop by @YehudaBriskman in #117
- docs(monitoring): record what the cAdvisor flags actually did by @YehudaBriskman in #118
- feat(brand): the wordmark's dot is --brand, not the UI accent by @YehudaBriskman in #119
- docs(themes): --brand in the theme author's README by @YehudaBriskman in #120
- fix(installer): the curl-path job's two first-run findings by @YehudaBriskman in #121
- fix(checks): shellcheck and the bash 3.2 rule skipped the CLI entirely by @YehudaBriskman in #122
- fix(monitoring): cap how big fifteen days is allowed to be by @YehudaBriskman in #123
- fix(overview): the disk panel said "no volumes" when it meant "I could not tell" by @YehudaBriskman in #124
- docs(security): what a browser shell would cost, before one exists by @YehudaBriskman in #125
- design(settings): group the page by what a setting is about by @YehudaBriskman in #126
- feat(discover): a system's identity, separated from where it is shown by @YehudaBriskman in #127
- feat(reader): diagrams and non-image media in the docs reader by @YehudaBriskman in #129
- docs(guide): the corpus for people who are not this repo's author by @YehudaBriskman in #130
- fix(docs): three screenshots were deleted and ARCHITECTURE.md kept naming them by @YehudaBriskman in #131
- fix(docs): repair the sentences the name-layer scrub left ungrammatical by @YehudaBriskman in #132
- docs(readme): lead with what it is, then how to run it by @YehudaBriskman in #133
- fix(diagrams): the picture on the front page described a box that no longer exists by @YehudaBriskman in #134
- fix(docs): the data chapter still described services retired months ago by @YehudaBriskman in #135
- fix(auth): the realm described three roles by capabilities they never had by @YehudaBriskman in #136
- fix(settings): a token can be out of date with respect to the account by @YehudaBriskman in #137
- feat(reader): Files opens on Start, and Bothy's docs are one click from it by @YehudaBriskman in #138
- feat(control): start the declared services the console could already act on by @YehudaBriskman in #139
- fix(grants): the socket-proxy sweep walked agent worktrees and the trash by @YehudaBriskman in #140
- feat(cli): bothy self-update, because upgrade updates the box and not the tool by @YehudaBriskman in #141
- feat(services): a collapsed group stays collapsed, keyed on what a system IS by @YehudaBriskman in #143
- docs(plan): a shell in the browser, and the second factor in front of it by @YehudaBriskman in #142
- fix(reader): one stretching width for a document, and backlinks that are actually after it by @YehudaBriskman in #159
- feat(reader): Files opens on the guide, and the index is a tree by @YehudaBriskman in #160
- feat(reader): reading size is a setting, and the scope is a control by @YehudaBriskman in #162
- docs(guide): the eight pages the guide was missing by @YehudaBriskman in #163
- chore(deps): bump prom/prometheus from v3.13.2 to v3.14.0 in /monitoring by @dependabot[bot] in #166
- chore(deps): bump oauth2-proxy/oauth2-proxy from v7.15.3 to v7.15.4 in /auth by @dependabot[bot] in #164
- chore(deps): bump grafana/loki from 3.7.6 to 3.7.7 in /monitoring by @dependabot[bot] in #170
- chore(deps): bump grafana/grafana from 13.1.4 to 13.2.1 in /monitoring by @dependabot[bot] in #172
- chore(deps): bump keycloak/keycloak from 26.7.1 to 26.7.3-1 in /auth by @dependabot[bot] in #174
- chore(portal)(deps): bump the portal-minor-and-patch group across 1 directory with 14 updates by @dependabot[bot] in #175
- Bothy reorg: 5 services, cluster console, VictoriaMetrics/Alloy, Settings v2, stability by @YehudaBriskman in #176
- chore(deps): bump keycloak/keycloak from 26.7.3-1 to 26.7.4-0 in /auth by @dependabot[bot] in #177
- chore(deps): bump grafana/grafana from 13.2.1 to 13.2.2 in /monitoring by @dependabot[bot] in #178
- chore(portal)(deps): bump the bothy-web-minor-and-patch group in /apps/bothy-web/web with 9 updates by @dependabot[bot] in #179
- plans: updates - keep every part of Bothy current from the UI (design) by @YehudaBriskman in #180
- release: v2026.9.0 + automatic CI-gated tagging by @YehudaBriskman in #181
Full Changelog: v2026.8.1...v2026.9.0
Bothy v2026.8.1
The first tagged release. Bothy is a self-discovering console for one machine — it shows you what is running by asking Docker, never by reading a list somebody remembered to update.
Install
git clone https://github.com/YehudaBriskman/Bothy.git && cd Bothy
cp .env.example .env
just upThere is nothing to fill in. The five credentials the stack uses — two database passwords, the SSO cookie secret, the OIDC client secret and your login password — are generated by just bootstrap, which just up runs. It prints which keys it wrote, never their values, and never touches a value you set yourself.
Then just urls prints every address, and just doctor health-checks the box.
Requires Docker with the Compose plugin, just, curl, python3, openssl. The bothy CLI in this release installs just for you.
What is in it
- The console — Overview, Control and Files on
:80, discovered from Docker rather than configured. Five themes, a theme editor, wikilinks and backlinks, and a markdown reader that renders images and code. - Identity — a local Keycloak with four non-composite roles (
viewer,editor,operator,shell), enforced at the edge. Nothing leaves this machine. - The
bothyCLI —init,download,upgrade,version, plus a dispatcher over the box's own recipes. - CI that installs it from nothing on every pull request: clone into an empty directory,
cp .env.example .env,just up, then ~600 assertions against the running stack. Plus nightly jobs that install at awkward paths and prove an upgrade keeps your data.
Versioning
YYYY.M.PATCH. A date, because how old is this box is the question people actually ask about something they install — and also valid semver, so tooling stays happy. VERSION at the repo root is the source of truth; a check refuses to let it drift behind the newest tag.