Skip to content

v0.24.0

Choose a tag to compare

@extractumio extractumio released this 28 Oct 19:34
· 1895 commits to main since this release

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's add_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.json into the agent's bookmarks of their sessions and
    projects, once, and keeps the file as notes.json.imported; done notes are not carried over.
    Your own bookmarks are not touched.
  • add_notes_for_user changed: a record is a title and a text (both required), with
    remind, kind (bug, deferred, followup, question, report) and file. 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.json was imported);
    rename notes.json.imported back to notes.json before 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 toolchain once; 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.