Repository navigation
Releases
v0.45.0-beta
What this release carries
- The desktop's profile page has the shape its design laid out (#1142, Decision 1070): Start first in a rail of panels, a meter of places, a system's tools as lines of work with the tool's name on hover, one list of what the profile cannot do under its banner.
- Artifacts: no sidebar; Open and Info on a card, Info a dialog of four tabs (#1143, Decision 1071): the gallery takes the width, a click opens the artifact, hover and focus show Open and Info, and Info is a native dialog with Overview, Access, Versions and Comments, counts on the tabs, a touch variant, owner controls only for owners.
- A session no pod holds is found and put to sleep (#1141, Decision 1072): the sweep marks dormant an active session that has sat on no pod for a minute; every pod is asked what it holds each minute and a session it does not name goes dormant; a drain marks a session before it releases its place;
admin.sessions.listshows the pod and a profile's overview says how many sessions it counted on no pod. A profile at zero no longer stays at one pod for a session nothing runs. - The plane says when a profile's calls are unpriced (#1137, Decision 1073): usage records say whether a call was priced; the profile's page and the console's Overview say how many calls and tokens of the period had no price and what to do; the desktop's rail says it in one sentence. Budgets still count unpriced calls as free.
- The command palette takes Enter pressed right after typing (#1129): an Enter that arrives before the command list is held and runs once the list comes; the row Enter runs is the row the text names.
- A Markdown artifact with an image from another site is told at publish and says so on the page (#1091, Decision 1074): the publish check names each such image as it names a blocked reference in HTML, and the rendered page shows "An image from is not shown: this page shows only its own files" in its place; the host's policy is unchanged.
- The terminal's profile page shows the bundle author's words (#1135, TUI Decision 0177): the sentence first, a server's subtitle, and a described tool as a row with its name after it.
- A flaky plane test checks the field it means (#1109).
Before you upgrade a plane
- One migration:
usage_records.priced(boolean, default true; existing rows read as priced). - No CRD change, no new setting; three new timings have defaults (
adrift_after_ms,index_every_ms,index_grace_ms). profile.getgainslimits.unpriced;admin.overviewandadmin.teams.listgainunpriced_calls;admin.sessions.listrows gainpod; profiles gainsessions_without_podand its note. Nothing is removed.- A pod of this release sends
pricedin its usage records; a plane of the last reads them as before (the flag is ignored); a pod of the last against this plane is read by its cost. - Every pod is now asked what it holds once a minute; a pod that does not answer is left alone.
Installing
Everything in this repository at 6668a1b, 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.45.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.45.0-beta/troupe-0.45.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.45.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.45.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.45.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.
v0.44.0-beta
What this release carries
- The desktop's profile page leads with what a profile can and cannot do (#1120, #1121, Decisions 1060 and 1062): one sentence on what it is for, a rail with room right now, the model, the budgets, who it acts as, whether it asks first and Start; a card per server and one for Troupe's own tools, the refused ones struck through; what it cannot do, from the rules, the withheld servers and the hosts it reaches; the agents and skills as guidance; the configuration's tables folded away. The rail says the limits a session is held to in plain words: the output cap per model call, the model calls, working time and tokens before an agent asks to go on, how deep it delegates, when it sleeps, and the GitHub push caps.
profile.getstates them all; the harness's defaults live in one protocol module the harness reads too. - A bundle's author can write the profile's sentence, a server's subtitle and a line per tool (#1122, Decision 1063): an
aboutkey in the bundle, validated at publish, shown on the page in place of the defaults. - The console's "What a member sees" shows the same limits (#1131), in its own tables.
- "Troupe is better in the app" moves to the app's browser build (#1118, Decision 1061): the web app opens
#/session/<id>and#/artifact/<id>, writes the place to its address, and offers the installed app at that place; the console shell loses the line and keeps Open in the app per row; copied links name the web app beside thetroupe://line. - Archive from the session row's menu (#1116) and one control that folds every turn's working (#1117, Decision 1064), first in the session's menu, the same choice
/detailmakes. - The profile's room is counted the same in the listing and on the page (#1119): a gone pod counts for nothing in either.
- A pod's streamed calls behind a LiteLLM gateway are priced (#1133, Decision 1065): the stream's
usage.costreaches the ledger, and the adapter asks the gateway for it; a profile needs nollm.pricesfor the gateway's aliases.
Before you upgrade a plane
- No migration, no CRD change, no new setting.
profile.getgains fields (limits, GitHub caps, harness tools, the two switches,about); nothing is removed, and older clients ignore them. - The bundle gains the optional
aboutkey; bundles without it publish as before. Upgrade the pods before adding a top-levelaboutto a bundle: a worker from before this release refuses a bundle with an unknown top-level key; a server'saboutit ignores. - The console's shell no longer shows the "better in the app" line; the desktop app's browser build does. Links copied from the apps now name the web app (
plane.app) beside thetroupe://line. - The desktop app's web build at
/appnow reads#/session/<id>and#/artifact/<id>from its address. - A pod behind a LiteLLM gateway sends
x-litellm-include-cost-in-streaming-usage: trueand charges the stream's cost;spec.llm.pricesstill applies to models the gateway does not price.
Installing
What this release carries
- A profile's page says what it can and cannot do (#1124, #1130, Decisions 1060 and 1062): the desktop app's profile page leads with the room right now, the model, and what a session there can reach and use, instead of the configuration's seven sections in order. Its Limits say each limit a session is held to in a sentence ("Each model call writes at most 8,192 tokens.", "Delegates at most 3 levels deep.", "Pushes at most 20 times, then stops and says so on its pull request."), Troupe's own defaults included, and Troupe's card lists the harness's tools with the refused ones struck through.
- The console shows an administrator the same limits (#1132): What a member sees gains Limits, the agents' own limits and GitHub tables, each limit with where it comes from.
- A bundle's author can say what a profile and its tools are for (#1134, Decision 1063): a new
aboutkey, a sentence for the profile (200 characters at most) and, per MCP server, a subtitle and a line per tool (120 each). It is checked at validate, preview and publish, a tool the server does not carry is refused by name, it diffs in the preview, and the profile page shows it. The bundle schema stays 1, and a worker never sees it. - Calls behind a LiteLLM gateway are priced on the ledger (#1136, Decision 1065): a pod's streamed calls used to cost 0 unless the profile copied the gateway's prices into
llm.prices. The OpenAI adapter now asks the gateway for the cost in the stream's usage and reads it from there, and the gateway needs no setting for this. - One control folds and unfolds every turn's working (#1128, Decision 1064): the desktop session view's ⋯ menu starts with "Fold every turn's working" or "Unfold every turn's working". It writes the same level
/detaildoes, so moving one moves the other. - Archive from the session list (#1127): a row's ⋯ offers Archive session, and under the Archived filter it offers Unarchive session instead of a separate button.
- The profiles list and a profile's page agree on the room (#1126): a gone pod no longer counts on the profile's page while it waits for the sweep, and a draining pod's running sessions count against the ceiling in both. All three counts come from one place now.
- "Troupe is better in the app" moved to the desktop app's browser build (#1125, Decision 1061): the console has no twin in the app, so the line left it. The browser build at the plane's
/appshows it and opens#/session/<id>and#/artifact/<id>addresses, and its link opens the same place in the app. - A flaky worker test got a longer budget for the plane's answer, though pods still wait two seconds (#1115).
Before you upgrade a plane
- No migration, no CRD change, no values change, no new setting.
profile.getgains fields and removes none:about,harness_tools,github,personal_tools,memory_proposals,limits.max_tokens,limits.session,limits.idle_seconds,limits.budgets.team_period,max_turnsandmax_tokenson an agent, andabouton an MCP server.profiles.list's fields keep their shape, butactive_sessionsnow counts a draining pod's sessions. PROTOCOL.md has both.- A bundle may now carry
about. A bundle that uses it cannot be published to a plane older than this one, so upgrade the plane first. - Behind a LiteLLM gateway the ledger starts showing what streamed calls cost, so team and profile budgets now count spending that read 0 before. A gateway is sent
x-litellm-include-cost-in-streaming-usage: trueeven when a profile hasidentify: false, because it does not say who is calling. Vendor APIs and OpenRouter are not sent it.
Installing
Everything in this repository at afc5b5c, 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.44.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.44.0-beta/troupe-0.44.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.44.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.44.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.44.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.
v0.43.0-beta
What this release carries
- The console's first group is the whole plane (#1096, Decision 1049): Oversee opens the console; Artifacts shows every artifact for an administrator with Mine as a tab and take-down beside each; Memory shows the organisation's, the teams', the profiles' and, for a platform administrator, every person's own memory, read only and audited on every read. The Mine group is gone; its addresses redirect.
- An artifact's address lands on the artifact after one sign-in, with no page to click (#1097, #1101, Decision 1054): a signed-out address goes straight to the identity provider when the plane names one, and the artifacts host's sign-in lasts an hour from the last page or file read instead of an hour from signing in.
- A session is one link away (#1099): Copy link in the console's session view and on the artifact it published, Open session from the desktop's gallery, the session id on the terminal's artifact row.
- A person in two teams is listed each team's own grants (#1064): entitlements union over each team's resolved names; the enrolment prefix follows the live policy; grants record who granted.
- A session whose log cannot be replayed can be woken (#1053, Decision 1053): "Wake it anyway" in the desktop app and the terminal (
troupe resume ID --repairheadless) skips the events the agent cannot read, keeps the log whole with alog_repairedrecord per skip, and says in the transcript what was skipped. Erasure leaves nothing behind: a daemon restart no longer forgets dormant sessions,session.erasesaysnot_foundwhen nothing was deleted, and a team session whose key is gone is cleaned up by the five-minute pass. - The attach size limit applies to an artifact's files (#1090).
- katex 0.18.10 (#1098); the two remaining GUI alerts are documented as not reachable.
Before you upgrade a plane
- No migration, no CRD change. The schema gains
session.repairandlog_repaired. - New admin methods
admin.artifact.get,admin.memory.peopleandadmin.memory.person, and audit actionsartifact.readandmemory.read: a platform administrator may now read any person's own memory, audited; tell people (the apps say so). - The console's navigation changes: Oversee first, Mine gone; bookmarks to
#/mine…and#/publishedredirect. - No values change, no new setting, no CRD change.
Installing
Everything in this repository at 6ef909e, 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.43.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.43.0-beta/troupe-0.43.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.43.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.43.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.43.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.
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.
v0.41.0-beta
What this release carries
- A pod session asks when its budget is spent, unless its terms set a limit (#986, Decision 1010): a session with no turn or time limit in its terms asks the people attached instead of stopping; with nobody attached the question waits and the pod sleeps on it. A trigger's terms still stop. Defect D32 is closed.
- The wall clock counts working time (#985, Decision 1011): it runs during a turn and pauses while the agent rests or waits on a person. The question reads "working time 24m/30m". Time worked is forgiven on restart.
- The clients say what happened after a stop (#987): "Your message was not taken: the session had stopped (its 30-minute working limit is spent). Start a new session to continue." The desktop's composer is replaced by that sentence and the terminal's input line sends nothing.
- The terminal reads a session idle once its start question is answered, and offers no edit on an enforced settings row (#967, #970).
- A comment on an artifact reaches a laptop's session, and a comment can be deleted or edited (#980, #979, Decisions 1015, 1016): the daemon's five-minute memory poll carries the comments; the session's log gets
artifact_commented, never input. Delete is the author's, an owner's or a takedown; edit is the author's, marked edited; both audited without the text. openbao.md's role lines keep every policy, plane-light's backups name all ten volumes, and a worker profile can switch memory proposals off (#971, #972, #965, Decision 1012):memoryProposals: falseon aWorkerProfileis restrict-only alongextends; a pod session on it is refused in the platform setting's words with the profile named.- The finish's changed line is each client's own sentence, and
troupe updatefrom an install elsewhere leaves the default install's desktop app alone (#968, #969, Decision 1013). - A person keeps an artifact at the top of their own gallery and narrows it by team and by published days (#978, Decision 1018): "Keep at the top" lives on the plane and follows the person; team chips inside Your teams when two or more show; "Published since … until …".
- A new session on a profile two of the person's teams may use asks which team (#992, Decision 1017): both new-session screens ask, the choice is remembered per profile on the client and shown,
troupe run --team <name>for headless, and the plane logs the refusal. - An administrator sets how long old versions and unopened artifacts are kept (#981, Decision 1019):
artifacts_keep_versions_daysandartifacts_keep_unopened_days, off by default; an hourly pass removes what they say, audited asby: retention, never the newest or the pinned version; cards say "Goes 3 Dec unless opened". Per-team retention is left. - A gallery card shows the picture its publisher sent with the version (#977, Decision 1020):
thumbnail {content_type, bytes}on publish (png, jpeg or webp, at most 256 KiB), served by the artifacts host on a signed address; nothing on the plane renders a page. The terminal's/publishflag and a renderer are left.
Before you upgrade a plane
- Four additive migrations run on start:
20261116001016_artifact_comment_edits,20261116001018_artifact_keeps,20261116001019_artifact_opened_at,20261116001020_artifact_thumbnails. - The
WorkerProfileCRD gains an optionalmemoryProposalsboolean: apply the chart's CRDs before the operator. - Two new settings under Policy and settings, both off by default:
artifacts_keep_versions_days,artifacts_keep_unopened_days. - The console image's CSP
img-srcgainshttps:and the desktop'shttps: http://127.0.0.1:*, for a card's picture from the artifacts host. - The worker's behaviour changes: a pod session whose terms set no limit now asks instead of stopping, and its wall clock no longer counts idle time. Sessions already stopped stay stopped.
openbao.md's role lines changed shape: a plane whosetroupe-planerole was last written from the old GitHub App section may be missingtroupe-plane-invites; run the page's fulltoken_policiesline once.- No values change, no new dependency.
Installing
Everything in this repository at 152fdf2, 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.41.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.41.0-beta/troupe-0.41.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.41.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.41.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.41.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.
v0.40.0-beta
What this release carries
Looks finished from the outside (#983: chunk 48): what a stranger meets, and the oldest partial issues finished and closed.
- Code at width, highlighted, Mermaid drawn (#960 for #936 and #659, Decisions 998, 999, tui/0174): prose keeps 78ch; code, diffs, tables and tool output run to the column and scroll in their frame; the desktop highlights code in palette roles; Mermaid is drawn as an image in strict mode; Afterglow dark's frame surface steps; a
transcript.detailcontrol; reasoning on replay in both clients. - The front page and a shared link's card (#961 for #189, Decision 1000): the landing page with the one-line install, screenshots, three downloads, self-hosted Figtree, a generated card on every page, JSON-LD and
llms.txt. The domain and analytics are the maintainer's. - Names, units and gone pods in the plane's answers (#962 for #957 and #870, Decision 1001): owner names in the erase preview, Connections and the memory table; limit refusals and the Audit page in the setting's unit;
goneinprofiles.list; adry_runonadmin.clients.put;max_sessionsweighed against what the pods could run; SCIM's ServiceProviderConfig and ResourceTypes served. - Deep links (#963 for #959, Decision 1002): the desktop app owns
troupe://(a plane, a session, an artifact; a link is an address and nothing more; a plane confirmed in words before first sign-in); every web surface offers to open or install the app in one dismissable line; "Open in the app" on sessions and artifacts. - The clients' leftovers (#964 for #956, Decisions 1003, tui/0175): the terminal's Always allow with scope and artifact attach; the desktop asks the scope; "answered by ";
/hqwithout a plane; the brand once; the signed-in name instead of "you". - Signing wiring (#966, refs #656): the key file the macOS job writes is removed; a page names which step reads each secret.
- Memory proposals (#973 closes #55, Decision 1004):
remember level=team|organisationproposes; administrators accept or decline in the console; the session is told; a setting switches it off; a profile'sextendschange reaches running sessions. - Dependency sweep (#974 for #958): audits clean; the nightly runs the Hex audit.
- The gate, desk half, on 0.39 (#975 closes #767, refs #955): rows 1, 3, 5, 6 pass; row 7's items fixed or filed (#967 to #972);
gate-checkgains the bench line. - PROTOCOL.md stays one page (#976 closes #422, Decision 1009).
- Artifacts shared with picked people, roles and comments (#982 closes #62, Decision 1007): share with a person at view, comment or edit; one thread per artifact the session hears; the daemon forwards, refused under Local only.
Before you upgrade a plane
Two migrations, 20261116001004_memory_proposals and 20261116001007_artifact_people_and_comments, both adding tables; the chart's migration job runs them. No CRD change, no values change, no hand step. One new setting, memory_proposals (on by default). The discovery document gains plane.downloads, plane.console and plane.dry_run; older clients ignore them. New desktop dependencies in the regenerated licence inventory: lowlight, highlight.js, mermaid 11, tauri-plugin-deep-link 2.6, and khroma (MIT without a licence field, recorded as an exception).
Installing
Everything in this repository at d6beea3, 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.40.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.40.0-beta/troupe-0.40.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.40.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.40.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.40.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.
v0.39.0-beta
What this release carries
The first hour and the first week (#949: chunk 47), with the plane and daemon joining the clients.
- The desktop app on a phone (#934 for #924, Decision 987): below 720 px the rail is a one-line top bar with a menu sheet that carries the "waiting for you" count; the session head is one line, the backstage and scratchpad are sheets, every control is 44 px, and the conversation has 70% of a 375×812 screen. The sessions list's filters sit behind one Filter button there (#951 for #950).
- The session column widens from 760 px on a laptop to 1200 on a wide monitor; the palette's
//headers keep the eyebrow colour, command names take the text colour, and the detail pane gets the room the area column took (#935 for #926). - The session view's voids are real (#938 for #920, Decisions 988 to 990): the context ring reads
context_statusfrom the harness; "Always allow" on an approval writes the person's own rule on their computer (allow_always, refused under managed rule sets and on a pod, whose rules are the profile's); an artifact attaches to a message with the daemon or plane fetching its files, never through the client. - Console: one button recommends this plane's version for every client, previewed and confirmed, platform admin only (#937 for #925).
- Settings carry a label and a unit written once in the plane's table (#939 for #933, Decision 991): the console names rows by label and asks in dollars and minutes; the preview and the audit note speak the unit. The two sleep settings say asleep (#948).
- People are shown by name (#940 for #931, Decision 992): every event and row that names a person carries the name; the desktop, console and terminal draw initials and the name; a plane from before falls back.
- The reader's words at the source (#942 for #927, Decision 993): the plane, worker and harness no longer write "worker profile", "activation", "on a pod" or "dormant"; sentences that send someone to the console name the page; the console's nav reads Profiles and Pods.
- A pod the operator removed is forgotten (#941 for #928, closes #883, Decisions 994 and 995): a pod no longer run and quiet past its lease reads gone and is dropped after the drain deadline; a team limit's refusal is one sentence in words in the plane and the console; a pod session's approval in the console offers what the desktop offers.
- The relayed laptop session (#947 for #932, Decision 997): the plane heartbeats the relay and tells steerers when the laptop is away and back; the daemon sends the approval's folder to every client;
allow_sessionis honoured over the relay. - The first run, walked and fixed (#944 for #930): the theme screen names Appearance; the plane-choosing first run says sign-in is next and asks for the theme once; the artifacts empty state's dead button; a failed folder chooser says so;
troupe loginprints sentences for a bad address. - The window remembers its size and place (#945 for #943): first launch centred; a place on a screen that is gone opens on the primary.
- Small leftovers (#946 for #929, Decision 996): palette rows the desktop cannot run are the terminal's; "CURTAIN UP · 18:54"; the Loading note, the update download and the first-run wait lead with a status line; the TUI's typed-in boxes fit their key line at 80 columns.
Before you upgrade a plane
One migration: 20261115000997_remote_sessions_paused adds paused_reason to the relayed sessions table; the chart's migration job runs it. No CRD change, no values change, no hand step. The plane now heartbeats relayed laptop connections every 15 s (relay_heartbeat_ms). Older clients ignore the new fields and events; an older daemon answers invalid_params to allow_always and its clients keep the old buttons. One new desktop dependency, tauri-plugin-window-state 2.4.1 (Apache-2.0 or MIT), in the regenerated licence inventory.
Installing
Everything in this repository at 767aa77, 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.39.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.39.0-beta/troupe-0.39.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.39.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.39.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.39.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.
v0.38.0-beta
What this release carries
The first hour with Troupe, made production-ready (#917: chunk 46, from three read-only walks of the desktop app, the console and the terminal client).
- The desktop session view reads as a chat (#922 for #919, Decision 986). One centred column: your messages on the right, the troupe's replies on the page with the mask; a reply's tool use folded into one line that opens; cost in a hover row with Copy, Retry and Publish. A one-line head with the session's team, profile and agent as tags; the goal is
/goal; the backstage and scratchpad are under ⋯. One-box composer:+to upload, drop or add files (from artifacts on this computer; a folder on this computer),/for the commands menu, the agent chip, a context ring and Send that becomes Stop. The command palette shows a command's detail beside the list, so a long command body never squeezes the list. What the backend does not yet report is present and says so: the context window, Always allow from an approval, attaching an artifact on the platform (#920). - The terminal client's
/newsends no agent on the platform unless you picked one, so a session wakes as the profile's default (#905 for #892, the TUI's twin of #884); a dropped or unknown--remoteprofile, an expired sign-in and a plane error are said on the page; the daemon chip switches on when the daemon comes up. A typed digit types; recents are picked from their own row; Ctrl-J makes a new line; the page scrolls; Esc during a start keeps one start and says how it ended (#918 for #893). Key lines fit 80 columns and what leaves them is shown under them (Decision tui/0173); every console page a sentence names is real, checked by a test against the console's own navigation (#912 for #894, closes #768). - The desktop session screen keeps room: a minimum transcript height, every panel's buttons visible with the body scrolling, prose wrapping between words (#906 for #895). The start screen credits only your own starts, its action row holds still, a
#agenttoken follows an@profileswitch (#913 for #896 and #908); the agent dialog offers only what it can do (Decision 981). "The plane at did not answer" replaces the CORS instruction; the reader's words replace pod, worker profile and activation; the phone-width rail wraps (#910 for #897). An offer is not a wait and wears none of the reserved colour (983); the palette's words are per client,/quitand/uploadare the terminal's alone (984); the list redraws itself when nothing is typed (985) (#921 for #898). - The console honours a follow-only grant (no composer; a refusal keeps your text), shows a relayed approval's command, folder, diff and rule, records the answer and says "Waiting for you" (#904 for #899). Setting rows stack below 1120 px, a table's actions stay at its edge, no page scrolls sideways at 1024 or 375 (#909 for #900). Confirms say Cancel, money is dollars and time is minutes everywhere, ids keep their case, a role-gated address says so (#914 for #901). A trigger form names what it still needs, Mine's rows say where a session opens, pods are counted and named plainly, artifacts' empty states explain links and publishing (#915 for #902).
- One written set of status lines (#916 for #911, Decision 982):
docs/design/lines.json, 194 lines in 15 lists, generated readers for both clients with a check in CI, a seeded per-turn order that never repeats within a turn, a long-turn list past five minutes. The curtain lines, the casting screen,/new,troupe login,troupe update, setup and the console's slow loads read it. - The fakes start a session from its message and honour the chosen agent, so
pnpm fakeshows the last releases' headline changes (#907 for #903). - Two soak flakes held (#889, in this release's own second commit): the logout tests wait for the daemon to drop the token, and the doctor's transport timeout no longer undercuts its own first-byte wait, so a slow connect under load reads as the model sending nothing, not as the connection failing.
Before you upgrade a plane
Nothing by hand. No CRD change, no migration, no values change. The upgrade from 0.37.0 is the chart alone. Two plane and harness sentences changed (the read-only-agents refusal no longer says "pod"; the identity admin answer counts people in words), and the commands table a client reads gained per-client summaries and a tui availability, which older clients ignore.
Installing
Everything in this repository at 8153287, 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.38.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.38.0-beta/troupe-0.38.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.38.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.38.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.38.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.
v0.37.0-beta
What this release carries
- A bundle's skill says which agents may load it, the built-ins included (#887, for #886, Decision 980). A skill entry in a bundle manifest may carry
agents:all, or a list of agent names such asbuildandplan. An agent loads a skill if its ownskills:opens it or the skill'sagentsnames it; the team's grant narrows first, as before. Without the key nothing changes. A child profile's composed bundle carries it. An organisation's shared skills now reach the profiles that run Troupe's own agents without overriding those agents. admin.bundle.validate, preview and publish refuse an unknown agent name, by name. A version already published is not re-checked against a later release's built-ins, so an upgrade stops nothing from loading.admin.profile.agentssays per agent which of its bundle's skills it loads (loads), and the answer lists the bundle's skills; the console's profile agents table and the bundle version page ("Opened to") show it. The mid-turn hold carries the key, so an agent restarted mid-turn keeps the skills opened this way.PROTOCOL.mdanddocs/admin/bundles-and-triggers.mdsay so.
Before you upgrade a plane
Nothing. No CRD change, no migration, no values change, no hand step. The upgrade from 0.36.x is the chart alone. Existing bundles need no change; add agents to a skill when you want the built-in agents to load it.
Installing
Everything in this repository at 7543a51, 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.37.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.37.0-beta/troupe-0.37.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.37.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.37.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.37.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.
v0.36.1-beta
What this release carries
- A session runs as an agent its profile offers (#884, for #882, Decision 979). On 0.36.0-beta a session started from the prompt-first screen without naming an agent, or woken from dormant, was activated as
build, which a profile that allows only its bundle's own agent refuses; the session waited for a place for ever, or its epoch climbed on every wake. Now the start screens send the profile's default agent (buildif offered, else its first), the plane fills that default on a create without one and keeps it on the row, a create naming an agent the profile lacks is refused with the agents there are, every activation sends the row's agent, and a pod's refusal fails the session visibly (read_only,failed_reason: agent_not_here; a waiting session is parked, a wake answersforbidden).PROTOCOL.mdsays so. - A profile scaled to zero reads as idle, not "full right now", and the auto-pick counts it as having room. The console's stale "draining" pod is a separate cause, tracked as #883.
Before you upgrade a plane
Nothing. No CRD change, no migration, no values change, no hand step. The upgrade from 0.36.0-beta is the chart alone.
Installing
Everything in this repository at 0c253d0, 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.36.1-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.36.1-beta/troupe-0.36.1-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.36.1-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.36.1-beta/install.sh
less install.sh # optional: read it first
sh install.shWindows (PowerShell):
irm https://github.com/it-minds/troupe/releases/download/v0.36.1-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.