Changelog
All notable changes to this project are documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Changed
Section titled “Changed”- The npm package is
hopback-tui. The commands it installs are stillhopbackandhb.
0.2.0 - 2026-11-13
Section titled “0.2.0 - 2026-11-13”The relaunch of aiz as hopback.
hb, a short command installed next tohopback. Both are the same program.- First-run import of aiz pins, local renames, hidden sessions and the
permission setting. The old
~/.cache/aizdata is left in place. - Packaging for every install channel: cargo-dist (release archives for
macOS and Linux on arm64 and x86_64 with checksums, a shell installer, a
Homebrew formula for
avgvi/homebrew-tap, an npm installer and the release workflow), apyproject.tomlfor maturin wheels, and a Nix flake. Every channel installs bothhopbackandhb. --agent-contextprints a bundled Agent Skill (skills/hopback/SKILL.md) that tells a coding agent how to search, page, resume and fork withhb.hopback completions bash|zsh|fish(also elvish and powershell) andhopback man; the generated man page is inman/hopback.1.llms.txt.hopback pin,unpin,rename,hideandunhide <selector>, each with--jsonto print the session after the change.hopback fork --jsonprints the new session, itsresume_commandand thelaunch_commandinstead of starting the agent.- Search-line editing: ← → Home End,
Ctrl+A,Ctrl+E,Ctrl+W,Ctrl+Uand Delete, with a real cursor. - Mouse support: click selects, double-click resumes, the wheel scrolls the list or the preview under the pointer.
- Adapters for Antigravity (
agy), Kimi Code, Pi, Cursor CLI, Grok Build and Gemini CLI, each with its own id, badge color and resume command. --json: the matching sessions as one JSON object on stdout, with a versioned schema (schema_version: 1), local metadata (pinned,hidden,original_title,forked_from) and the exactresume_command. Paging with--limit,--offsetand--all. Seedocs/json.md.- Quick continue:
hb .resumes the most recently used session of the current folder, whatever the agent, or of the closest parent folder that has one.--agentnarrows it; with no session it exits 1 with a clear message. --printprints the folder and the resume command instead of running it.--no-refreshto answer from the existing index, and--include-hidden.- CI on Linux and macOS:
cargo fmt --check,cargo clippywith warnings denied, andcargo test. - Kiro CLI sessions are indexed, in both layouts it keeps under
~/.kiro/sessions, and resume withkiro-cli chat --resume-id <id>. - Goose sessions are indexed from its SQLite store and resume with
goose session --resume --session-id <id>;Ctrl+Fforks one with Goose’s own--fork. When the Goose desktop app is installed butgooseis not onPATH, hopback runs the copy inside the app. Ctrl+Tpins or unpins the selected session,Ctrl+RorF2renames it, andCtrl+Xhides it, straight from the list. The footer shows the pin and rename keys.- Filter keywords in the search line are colored: the keyword, an agent’s name in that agent’s color, other values in green, and a value hopback does not know in red and struck through.
- While an agent or date value is being typed, the rest is suggested after the
cursor.
Tabor→takes it, and the list already shows the suggested filter. - Right-click on a session opens the actions menu for it.
- The rename box has a cursor and the same editing keys as the search line.
--json --include-messagesaddsmessages, the prompts and replies of each session, to the output.- hopback reads the permission mode Claude Code records in a session, so a session that ran with skipped permissions is known as one.
Changed
Section titled “Changed”-
Long titles in the table are cut with
…instead of being clipped, and a translated fork’s title is cleaned like any other. -
The README is rewritten around the install commands,
hb ., translated forks, the supported agents and the keys. -
New keys. Typing always goes to the search;
Ctrl+Oopens an actions menu for the selected session (ffork,ppin,rrename,hhide,ycopy);Ctrl+Pnow toggles the preview;F1lists every key;Escclears the search and quits only when it is already empty. -
Removed
Ctrl+`and the directCtrl+Ppin,Ctrl+Rrename andCtrl+Xhide bindings. Pin, rename and hide are in theCtrl+Omenu. -
New TUI layout: a status line with the refresh summary and “shown / indexed” counts, a framed search box with a syntax hint, agent tabs with session counts in each agent’s color, a table with Agent, Title, Directory, Turns and Age columns plus pin (★) and fork (↳) marks, a preview to the right of the table, and a footer with each key in a chip. Narrow terminals drop the Directory column first, then the preview.
-
The preview shows the session’s title, folder and local date above the conversation, and colors the user’s prompts apart from the replies.
-
Removed the Ctrl+Up / Ctrl+Down preview resize; the preview now takes a fixed share of the width.
-
The index is rebuilt once after an upgrade that changes how sessions are read. Pins, renames and hidden flags are kept.
-
An unknown
--agentvalue is now an error instead of being ignored. -
The project is renamed from aiz to hopback: crate, binaries, help text and the store location (
~/.cache/hopback/hopback.db). -
Tabwrites the agent into the search line asagent:<name>instead of keeping a separate, invisible tab filter. A typedagent:filter fills in the matching tabs, and--agenton the command line shows up there too. -
Every pop-up (actions, fork, rename, hide, help) is drawn on one frame with the same selection bar and hint line.
-
Resuming and forking no longer ask about permissions. A session starts in the mode it was started with: with the agent’s skip-permission flags when it ran that way, without them otherwise.
--yoloandhb config permission set normal|yolo|inheritstill override that. -
A translated fork holds the conversation as it was. It no longer starts with a notice telling the new agent to treat the transcript as untrusted history, tool calls keep their names, and Codex’s instructions are not replaced. The one addition is
[hopback]in front of the title the target agent shows. -
A fork into Codex is listed with the sandbox and approval settings of your latest Codex session in that folder (or anywhere, when the folder has none) instead of being forced to read-only. It is recorded for the model provider Codex is configured with, where it used to say
openai, which made Codex refuse to open it on any other provider. -
A fork into Codex shows the earlier replies in Codex’s transcript, not only the prompts.
-
A fork into Claude Code leaves out the instructions Codex gave itself, which used to appear as prompts you had typed.
-
A Codex session counts as started with skipped permissions only when it ran with approvals off and no sandbox. Runs with approvals off inside a sandbox, which is what
codex execdoes, resume normally. -
The agent skill and
llms.txtno longer tell agents to ask for approval before resuming, forking, pinning or renaming. -
The actions menu lists each action with the key that runs it directly, in the order pin, rename, fork, copy, hide. Its single-letter keys are gone.
-
Key chips and hint text use fixed colors instead of the terminal’s own grays, which were too light or too dim depending on the terminal theme.
-
The footer drops chips on a narrow terminal instead of running off the edge, and no longer lists
TabandCtrl+P(they are in theF1help). -
A footer message such as “pinned” clears on the next key press.
- Codex sessions written by current Codex builds are indexed. Prompts are now
read from
response_itemmessages, the session id comes from the rollout file name, and subagent rollouts (reviews, guardian checks, spawned threads) are skipped, ascodex resumedoes. - Titles are readable: paste wrappers (
<pasted_content …>), slash-command envelopes, injected context blocks, image labels and leading slash commands are stripped, and the title falls back to the first meaningful line a user wrote. Titles are one line, at most 80 characters. - Claude Code sessions use the name Claude Code itself shows: the
/renamesidecar, thencustom-titlerecords, the sessions index andai-titlerecords, before the first prompt. - Codex sessions are titled from the prompt as typed, not from the model input with its image labels and context blocks.
- OpenCode sessions are found again: the adapter reads the
session_v2andsession_messagetables of current OpenCode as well as the older schema, and skips subagent child sessions. - A Codex thread rename in
session_index.jsonlupdates the indexed title. - Saving an empty name in the rename box brings the original title back at once, not only after a restart.
- A half-typed
agent:value no longer empties the list.
0.1.0 - 2026-06-19
Section titled “0.1.0 - 2026-06-19”- Initial release as aiz: a TUI that indexes Claude Code, Codex, Copilot CLI, Copilot in VS Code, Crush, OpenCode and Vibe sessions, searches them with SQLite FTS5 and fuzzy matching, and resumes or forks the selected session.
- Pins, local renames and hidden sessions, kept in hopback’s own store.
- Native forks, and translated forks between Claude Code and Codex.