Repository navigation
v0.24.0
v0.24.0 — the agent's records as bookmarks, going through bookmarks, long paths shown short
A minor release: a new feature (a coding agent keeps its reports, findings and questions as
your bookmarks and reminders, replacing the Plan pane's notes; going through a session's
bookmarks) and a changed MCP tool. Read Before you upgrade first.
New
- The agent keeps what must not get lost in the scroll. A coding agent hands you a final
report, a next step, a gap it saw elsewhere in the project, deferred work or a question
through terminum'sadd_notes_for_user, and each becomes a bookmark of its session with the
agent's mark: a title and a text written to read without the chat (Markdown). It is a
reminder, coming up at each turn's end, only when you must act or decide. Open goes to where
the agent made it (the line where its call was printed, found by its title); Insert into
chat pastes its title and text. The agent's records have limits of their own (50 open a
session or project, 500 in all) and never count against your 300 bookmarks; the same title
is not kept twice; the text is cleaned and redacted as sent history is. Seen with Claude
Code: a task asking for a final report kept it as a bookmark, a choice left to the user
became a question, a routine edit kept nothing. - Going through a session's bookmarks. The bookmarks' button (its count: bookmarks and open
reminders) lists the session's bookmarks and open reminders top to bottom, the agent's with
its mark and reminders with a bell. Press one, or ↑ ↓ on a computer, and the session goes
there while the list stays open; ✓ or Delete settles one (a reminder resolved, a bookmark
deleted) with Undo for 5 seconds; Enter or Esc closes it. The bar over the terminal has the
same Done. - The Plan pane in sections: a larger title, "Now" with the current step set apart, the
progress as "3 of 9 done", a percent and a bar with the ETA under it, the steps with round
marks and the current one highlighted, when it was updated, and how many records the agent
kept for you (a press opens the bookmarks' list). It takes the theme's text colors, so it
reads in light themes too. - A long path shows short. A path of 84 characters or more in a row of output shows its
first 36 and last 40 characters with "[...]" between; a click or a tap (or Enter) on
"[...]" shows it whole while the page is open, and Find opens it when a match is in its
middle. Copy, ⌘-click and underlines always take the whole path. Not folded in the cursor's
row, an agent's input box or footer, or a full-screen program; a path broken over two rows
is shown as it is.
Before you upgrade
- The Plan pane's notes become bookmarks. At its first start, terminumd turns the open
notes of~/.terminum/state/notes.jsoninto the agent's bookmarks of their sessions and
projects, once, and keeps the file asnotes.json.imported; done notes are not carried over.
Your own bookmarks are not touched. add_notes_for_userchanged: a record is atitleand atext(both required), with
remind,kind(bug, deferred, followup, question, report) andfile. Restart running
Claude Code and Codex sessions: they read terminum's tools and their descriptions only when
they start, and an old session's call in the old shape is refused as a tool error ("notes[0].title is
required"), nothing kept.- Rolling back to 0.23 keeps the agent's records as bookmarks, but 0.23 does not know
they are the agent's: they lose the agent's mark and count against your 300. The Plan pane of 0.23 shows no notes (notes.jsonwas imported);
renamenotes.json.importedback tonotes.jsonbefore rolling back to keep them.
Fixed
- No notice for Claude Code's question in a narrow pane. A session waiting on its
question (AskUserQuestion) showed no question mark, no waiting line and sent no notice
after 2 minutes when its pane was narrow (an agent team's panes beside it): Claude Code
breaks "Esc to cancel" over two rows there, and terminum read the screen as finished. The
footer's words are now read as one line. - Image buttons alone on a line. The image buttons after a row as wide as the view stood
alone on the line below it; they stay with the row's last word. - A warning in every Linux build (zig's linker on rustc's
-Wl,-O1): cargo-zigbuild
0.24.0 filters it out. Building from source:make toolchainonce; an older cargo-zigbuild
is refused with that advice.
Verified
At release, on a clean tree: make test (cargo 632 + 1, the Panel's 38 and the Page's 136
unit tests, the scripts' 34), clippy clean, the Panel's browser check (157), the Page's 1485
browser checks (Chromium and WebKit, a wide and a phone size), the live check against a
private tmux 3.6a (177), scripts/e2e_remote.py (32 of 32), the agents on a host (21 of 21)
and scripts/security_check.sh pass. Interactive Claude Code in a private tmux and terminumd,
four tasks naming neither terminum nor its tools, two runs: a final report kept as a bookmark
both times, a choice left to the user kept as a question both times (once a reminder), a
routine edit kept nothing; a bug the agent only read was told in its answer, not kept. Claude
Code 2.1.311 in a 22-column pane breaks its question's footer over two rows; that screen is
now read as waiting. Not verified: Codex's records, an iPhone, a real Linux host.
Install or upgrade: curl -fsSL https://github.com/extractumio/terminum/releases/latest/download/install.sh | sh
SHA256SUMS is signed with the release key SHA256:Zt1tUwAnt4BQ1/hU8QCphhm+43bV5W0k55KwYz4vw9s.