agex
Docs menuHistory

Workspace

History

Find and resume past agent sessions in a project, search them, and see how interrupted agents fit in.

History, pinned to the bottom of the sessions sidebar, lists every past agent session in the project, newest first. Click one to pick up where you left off.

Where sessions come from

agex reads them from each agent's own session store. History includes sessions from:

  • Claude Code
  • Codex
  • Copilot CLI, including VS Code's Copilot agent
  • Kiro CLI
  • OpenCode
  • Crush

Each session is titled by the agent, or by your first prompt.

Sessions of agents running elsewhere are left out while those agents run.

Open the list

History starts folded to its heading, which shows the number of sessions. Click the heading to unfold it. It stays the way you left it.

Resume a session

Click a session to resume it in a new tab.

When an agent already has that session open, in agex or elsewhere, clicking it shows that agent instead of opening the session twice.

Right-click a session to:

  • Resume it here, or in a split.
  • Copy its resume command, its session ID or its title.

Click the magnifier in the heading to open a search box. The list narrows by title, branch or agent as you type.

TypeTo
login bugKeep sessions whose title, branch or agent matches.
agent:copilotKeep one agent's sessions, by its id or the start of its name.
agent:kiro,codexKeep several agents' sessions.
-agent:claudeHide one agent's sessions.

In the search box:

  • ↵ resumes the top match.
  • Esc clears the search; press it again to close the box.

Interrupted sessions

Agents that were still running when agex quit or crashed are listed separately, under their project, as Interrupted. While they're listed there, they're left out of History. Resume or dismiss them from that list. See Interrupted agents.

From the command line

CommandWhat it does
agex historyLists the project's past sessions, numbered, newest first.
agex history login bugLists only the sessions that match those words.
agex resume 3Reopens session 3 in agex, or shows the agent that has it open.
agex resume 3 --printPrints the command that resumes it instead.

agex history and agex resume --print work even while agex is closed; agex resume starts it. See Command line for every flag.