This repository is the monorepo: the platform, the daemon, and the default GUI and TUI¶
Decision 666 · accepted · 2026-09-21
Decided by the team on 2026-09-21. Before it, a client was a separate
release from a separate repository and the daemon was built elsewhere by pinning
this one by git ref, which produced four repositories and three pins: the TUI and
the daemon each named a troupe-remote commit by hand, seventeen commits behind
main by the time anybody looked, and a protocol change was three or four pull
requests in three repositories with a version bump in the middle. The GUI and TUI
are now the defaults; a client somebody else writes against PROTOCOL.md is
exactly as supported as it was.
Three repositories came in with their history, each rewritten by git filter-repo
under its new prefix and merged as unrelated history: it-minds/troupe-gui under
clients/gui, it-minds/troupe-tui under clients/tui, and the umbrella
repository — daemon/ and the installers. Their GitHub-generated references to
their own pull requests, "Merge pull request #N" and a squash title's "(#N)", were
rewritten to name that repository, because a bare #N here links to this
repository's #N; the umbrella repository's are written as
it-minds/troupe-program#N.
The clients sit under clients/, not apps/. Mix treats every directory in
apps/ as an umbrella application and warns about any without a mix.exs, which
the GUI's pnpm workspace would be; and the TUI as an umbrella application would put
ExRatatui, Burrito and rustler_precompiled into the shared lock, into every image
build and into mix check. As its own Mix project it costs the server nothing. The
daemon is the opposite case: its dependencies are three umbrella applications and
nothing else, so it becomes one (667).
Governs: .github/workflows/ci.yml, mix.exs