Repository navigation
v0.42.0-beta
What this release carries
- Half the hand-written documentation, said once (#1010, #1013, #1014, #1016, #1017, #1018, Decisions 1028, 1031, 1032, 1033, 1042, 1043): the known-defects log is gone and its live items are issues; history, the retired console design, the prompt-prefix study and the gate pages are gone (the Stage 1 gate is an issue template plus
scripts/gate-check); the user landing page is 127 lines over owning pages for setup, sessions and the transcript; the admin pages explain upgrading, OpenBao policies and worker isolation once; component READMEs say how to build, user pages say what the product does;ARCHITECTURE.mdis a map; every admin method is on an admin page, held by a test. - A decision is forty lines about code (#1011, #1012, Decisions 1025, 1041):
mix troupe.decisions --checkenforces the shape for new decisions; superseded ones are deleted, paths are code only, 269 bodies were cut by deletion alone. - PROTOCOL.md's admin method table is generated (#1015, Decision 1035) and CI fails when it is stale.
- No dead code (#1019, #1020, #1021, #1027, #1029, Decisions 1026, 1029, TUI 0176): the TUI reads only the schema's event names; five never-emitted events and the unsent
fleet.getare gone; 29 unused functions, ten unset settings, four dependencies and the GUI's unused exports, CSS and an uninvoked Tauri command are gone; every view reaches the plane through a typed wrapper. - One way to say each thing (#1022, #1023, #1024, #1025, #1026, #1028, #1030, Decisions 1034, 1037, 1040): shared formatters in
troupe_protocol; one atomic state-file write; one budget rung server; no compile-connected cycle; one GUI vocabulary (KiB, "under a cent",Active/Asleep/Read only, alerts with a retry); one test-support package and oneeventually. - A person renames a session, keeps it at the top and changes its task list from the desktop app (#1032, Decision 1038);
/renameand/keepin the terminal too. - A profile sets how much output one model call asks for (#1080, Decision 1047):
spec.llm.maxTokens, narrowing alongextends; an agent may lower it; the cut-off note names the cap. - Publishing an HTML artifact says what the artifacts host will block (#1081, Decision 1048): the answer and the artifact's page in every client list the references; the publish succeeds.
- The maintainer's four fixes from
development-2026-11-17: folded sleep and wake notes, the profile page's skills, archiving a session, recovery from an overflowing turn and/compact(#1001, #1003, #1005, #1006).
Before you upgrade a plane
- One additive migration runs on start:
20261118001048_artifact_blocked_references(artifacts.blockedinteger, default 0). - The
WorkerProfileCRD gains an optionalspec.llm.maxTokens: apply the chart's CRDs before the operator. - The schema lost five events nothing emitted (
acl_granted,acl_revoked,session_archived,session_erased,session_read_only) and the methodfleet.get(session.listanswers the same rows).artifact.publishandartifact.putanswers gainblocked; list and get rows gainblocked_count. - No values change, no new setting, the artifacts host's policy is unchanged. plug is 1.20.4 (EEF-CVE-2026-120287).
- Behaviour to read: a pod session's output cap follows its profile (default still 8192); publishing an artifact lists what the host blocks; the console's reconnect sends the mode asked.
Installing
Everything in this repository at 5092414, as one release, after the full suite.
On a cluster — the chart, whose images are this version, from the registry:
helm upgrade --install troupe oci://ghcr.io/it-minds/charts/troupe --version 0.42.0-beta \
--namespace troupe-system --create-namespace --values my-values.yaml
or the same chart from this page:
helm upgrade --install troupe \
https://github.com/it-minds/troupe/releases/download/v0.42.0-beta/troupe-0.42.0-beta.tgz \
--namespace troupe-system --create-namespace --values my-values.yaml
Images, public and pulled without a credential: ghcr.io/it-minds/troupe-plane, troupe-operator, troupe-worker, troupe-a2a and troupe-gui, each tagged 0.42.0-beta. Installing has the CRDs, the values nobody can leave unset, and what the chart does not run for you.
On a machine — download the installer attached below, read it if you like, and run it. It installs this release: the daemon always, and it asks about the TUI and the desktop app.
Linux and macOS:
curl -fsSLO https://github.com/it-minds/troupe/releases/download/v0.42.0-beta/install.sh
less install.sh # optional: read it first
sh install.shWindows (PowerShell):
irm https://github.com/it-minds/troupe/releases/download/v0.42.0-beta/install.ps1 -OutFile install.ps1
notepad install.ps1 # optional: read it first
powershell -ExecutionPolicy Bypass -File .\install.ps1No questions: --tui --gui -y (-Tui -Gui -Yes). The VS Code extension: --vscode (-VSCode), or troupe.vsix below with Extensions: Install from VSIX…. Start over: --clean-install (-CleanInstall). Remove: --uninstall (-Uninstall). The desktop app's own installers are attached as well.
Then, in a new terminal, troupe config sets up a model (Enter at every question is Anthropic, with the key from ANTHROPIC_API_KEY) and troupe in a project directory opens a session; without the TUI, the desktop app sets the model up on This computer, under Models. The first run has both.