/push docs

Useful work, from your first session to your whole team.

Browse the docs
Organize your work · Guide

Work comfortably in the terminal

Find the right tab, group related conversations, and return to your work later.

Use Push as your everyday terminal while keeping agent conversations easy to find and return to.

Before you start

Open Push on your Mac. Agent-specific naming, history and resume require a supported coding agent; ordinary shell commands work in terminal tabs too.

Open and find a tab

Use ⌘T for a new tab and choose the project folder and runtime you want. Tab titles help you recognize the conversation. Use the tab menu to rename a tab or return to its automatic title.

Folder chips filter the strip to a project's tabs. The Active filter helps locate current activity. Use ⌘1–⌘8 to select a tab, ⌘9 for the last, or ⌘⇧[ / ⌘⇧] to move between tabs.

To make work independently findable from the board, ask:

Ask your agent
Track this conversation in Push and tell me where to find it later.

Use that request on an untracked conversation. Already tracked work keeps its existing home.

Use New Group… or Add to Group in the tab controls to organize related tabs. A folder or group's theme colour helps distinguish the scope you are viewing. Grouping tabs organizes the view; it does not start agents or assign new work.

See the result

Select the folder or group and confirm that the intended tabs are visible. Open tracked work from its board card to return to the associated conversation. Use ⌘I for its inspector and results.

Push can restore supported conversations after reopening the app. Terminal scrollback may clear while the conversation's history remains available. Before quitting, read any warning about running work, foreground processes or recording.

Appearance and shortcuts

Use the app's appearance controls and the folder or group colour controls. The coding runtime may also have its own theme settings. Use ⌘/ for the current keyboard shortcuts; the shortcut reference collects the common ones.

If something stops

A hidden tab may simply be outside the selected folder or filter. Return to the wider tab view before assuming the conversation disappeared. For a failed resume, preserve the work reference and use Copy Session Information… from the tab menu for support.

Changing layout, reloading a terminal and closing a tab are your UI choices. Avoid using reload as a generic repair while an agent is performing work.

See tracking or troubleshooting.

Updated