The terminal browses a person's artifacts by who can see them, in the desktop app's words and glyphs, through the daemon's sign-in: it opens one in the browser through the plane's one-time address and reads a Markdown one in its own frames, past 500 lines offering the browser; /memory is what a new session starts knowing, entry by entry per level with what is in effect for each team, Only you's changed on the screen over the version edited; troupe artifacts is the same on the command line, and HQ has a line per invitation and one for what is shared¶
TUI decision 167 · accepted · 2026-10-27 · issue #62
Issues #62 and #55, chunk 45's "a person's things, in a person's apps", the maintainer's word on #765 of 2026-10-26: the console is the administrators' panel, and what is a person's own — their artifacts, what is shared with them, their memory — is seen and edited in the desktop app and the terminal. The desktop app's half is root Decision 954; this is the terminal's.
Artifacts¶
Through the daemon, never the terminal's own sign-in. /artifacts, troupe artifacts
and HQ's shared line ask this computer's daemon: artifact.list, and the methods root
Decision 954 forwards to the plane as the person (artifact.get, artifact.open,
artifact.share), to which this adds artifact.read (observe), one text file of a version.
So the terminal and the desktop app see the same list, and Local only is the daemon's to keep
as for every artifact.*; the terminal under local_only asks nothing at all and says
"Local only: the plane is not asked".
Grouped by who can see it, in the desktop app's words. The maintainer's design for the
gallery names four audiences with a glyph each: ◉ Everyone at the organisation, ◎ Your
teams (a team's and, under it, a profile's), ◐ Shared with you (through a link) and ○
Only you; the tabs are those and All. The plane says a row's scope (root Decision 953), which
the tab follows. The slot named the tabs Mine, Organisation, Teams, Profiles and Shared;
the design's four replace them, a person's own shown under who it is for, by you on its
row. New to you marks a version not opened on this machine, kept in the state directory
(artifacts-seen.json), never on the plane: it is this machine's reading, not the person's.
Shown where it can touch nothing. Enter asks artifact.open and opens the one-time
address in the browser, which the artifacts host redeems for its own cookie, as the console's
Open does (root Decision 948); the terminal never fetches a page. A Markdown one is also read
here (m): its source through artifact.read, drawn with the transcript's Markdown parser in
a frame (TUI Decision 161); a source past 500 lines is cut there, its last line offering
Enter for the whole in the browser, the viewer's limit Decision 161 left. v lists the
versions to open one; l asks a view link for one of the person's own and copies it through
the terminal with OSC 52 where its environment says it takes it (Windows Terminal, iTerm2,
WezTerm, kitty, Alacritty, foot, Ghostty), else with the clipboard command, and shows it
either way, since no terminal says whether it took it; p publishes a file of the workspace
with /publish's line, for Only you where nothing is named, the design's default.
On the command line, troupe artifacts list [--scope …] [--json], open, show
(the text on standard output), publish FILE [--to …] [--title …] and link, from the same
client module, in the command table so the reference regenerates. --version there names a
version; anywhere else it is the program's, so the subcommand parses its own options, as
troupe update does.
Memory¶
Entries, per level, and what is in effect. The maintainer decided on 2026-10-26 that
memory is entries: a document's ## Topic sections, the closest level's entry on a topic
replacing the lower ones'. /memory is the terminal form of the design's page: In effect
(for one of the person's teams, t another: the winning entry per topic and what it
replaces), then ◉ the organisation's, ◎ each team's and ○ Only you, a level the person
cannot change here marked · read. Until the plane answers entries, the client reads them
from each level's text (Troupe.Client.MemoryEntries) and saves Only you's whole text over
its version — a shim to go when it does. (It went with root Decision 957: the page reads the
plane's entries and memory.in_effect, and saves entries.) It reads the levels from the daemon's me.memory
(documents) and the history from me.memory.history and me.memory.rollback, root
Decision 954's; the daemon's me.memory.status now carries the copy's texts (held), which
is all the page reads under Local only, where it is read-only.
Only you's, changed on the page. a takes the topic on the page — refused where Only you
has it, said to replace a lower level's where one has — and the words in the person's editor
(VISUAL, then EDITOR), or, with neither set, in a box here, rather than Notepad or vi
uninvited; e edits and f forgets after a confirm line. A save names the version it was
made on: a conflict shows the person's text beside the version saved since, and l
reloads it. h lists the versions, two side by side, r rolls back to one (a version of its
own); b is who wrote each line, troupe memory --blame's column; s is --status's
lines. A memory_changed in the session, or the daemon's config.changed for memory, reads
the page again. The organisation's and a team's are read-only here in this slice: a team
admin's and a platform admin's saves go through the console until the daemon forwards
theirs. (It does, by root Decision 957: now a, e and f change the organisation's for a
platform admin and a team's for its admins, as me.memory's roles say, through the
forwarded admin.memory.preview and admin.memory.put, memory_levels_screen_test.exs.) /memory facts is the brief's page as /memory was (this amends root Decision
839, which put the facts at /memory alone), refresh and forget as before; /memory
no longer needs a session on this machine, so the command table drops its local.
HQ¶
One line per invitation (invites.list at the plane HQ looks at), Enter opening the session
to follow it — a private session's is the desktop app's to read, with its key, and says so —
and one for how many artifacts are shared with the person when any are, Enter opening
/artifacts on Shared with you. They are a column of their own while there are any.
Governs: clients/tui/lib/troupe/ui/tui/artifacts_page.ex, clients/tui/lib/troupe/ui/tui/memory_page.ex, clients/tui/lib/troupe/client/artifacts.ex, clients/tui/lib/troupe/client/own_memory.ex, clients/tui/lib/troupe/cli/artifacts.ex, clients/tui/lib/troupe/cli/memory.ex