Skip to main content
History is the place to find Tasks you have worked on before, and the messages inside them. Press ⌘Y / Ctrl+Y to open it. Open History when you want to return to earlier work, find a shared Task, organize Tasks with labels and groups, or clean up Tasks you no longer need.

​
What History Shows

Each row is a Task. From left to right, a row shows:
  • An icon that shows when the Task’s agents are working or need your attention.
  • The Task’s own icon and color, if you set a Task appearance.
  • The title, with an Open badge when the Task is already open in a tab.
  • The Task’s group and up to two labels (one when it’s in a group), with “+N” for the rest.
  • When it was last updated. Hovering a row whose worktrees have pull requests swaps the time for PR pills.
Hovering a row also reveals its actions: pin, rename, Sweep (“Sweep this task’s worktrees”), and delete. Opening a row opens that Task. The search box looks through Tasks and the messages inside them. Three tabs choose what you see, each with a count while you’re searching: Task search matches:
  • The Task’s title and repositories.
  • The branch of any of its worktrees, and its pull request number (84, #84, or PR #84).
  • A worktree’s folder name, or its full path when the query contains /.
Branch, pull request, and worktree matches come only from worktrees on the active host. Message search looks through the chats stored on the active host, across all your Tasks, and needs at least 2 characters. Click a result to open that chat at the message. History’s filters don’t apply to messages; when a filter is on, the Messages section says “Filters apply to tasks only.” Use Refine in chat search to continue in Search chats. Press Esc to clear the search. The arrow keys move from the search box into the results and back.

​
Filter And Sort

Click Filter to narrow the Task list: When you pick more than one label, repository, host, or workspace, an OR / AND toggle appears next to that filter: OR matches Tasks with any of them, AND only Tasks with all of them. Clear removes every filter. The sort menu orders Tasks by Most recent, Last viewed, Relevance, Oldest, Title A → Z, or Title Z → A. Typing a search switches to Relevance unless you picked a sort yourself.

​
Pin Tasks

Hover a row and click its pin icon to pin the Task to the top. Pinned Tasks stay above the others in every sort. Click the pin again to unpin it. Pinning needs a confirmed sign-in, and some Tasks can’t be pinned; the pin’s tooltip explains why.

​
Labels, Groups, And Appearance

You can organize Tasks with labels, groups, and a personal icon and color. Right-click a row to reach them: Clicking a row’s group or label chips also opens “Task organization”. To rename, recolor, or delete your labels across every Task, open the ⋯ menu in the History toolbar and choose Manage Labels. Who sees what: Imported and Automation are system labels that Traycer adds. They’re marked “System” and can’t be edited or removed. Labels, groups, and appearance need a confirmed sign-in. Changes that haven’t reached the cloud yet show “Waiting to sync”, or “Sign in to sync your changes” when you need to sign in again.

​
Open And Manage Tasks

Viewers of a shared Task can’t rename or delete it. Renaming, deleting, and pinning also need a confirmed sign-in.

​
Delete Tasks

Deleting asks for confirmation and can’t be undone. If the Tasks you’re deleting have worktrees on the active host that no other Task uses, the confirmation adds Remove local worktrees too?, listing each worktree with anything that would be lost, such as uncommitted changes or commits not on the default branch. Worktrees proven safe to remove are checked for you; check or uncheck the rest. Checked worktrees are removed the same way Sweep removes them, including their teardown script. Unchecked worktrees stay on disk; find them later in Settings › Worktrees.

​
What History Is Not

History is not the same as the Agents panel.
  • Use History to find and open Tasks.
  • Use Agents to continue an agent inside an open Task.
  • Use Artifacts to find specs, tickets, stories, and reviews inside a Task.
History helps you get back to the right Task. The Task’s panels hold the actual work surfaces and documents.