Understand your workspace
A small vocabulary for finding work, following an agent, and returning to a result.
Start with the first-session walkthrough if you want to learn by doing. These terms help when you move between the terminal, board and other devices.
Push Sessions and conversations
A Push Session is a piece of tracked work with a title, reference, thread, files and a place on the board. Older screens may call this an issue.
A conversation is your discussion with a coding agent. A tab is the terminal where you see and interact with it. Tracking connects the conversation to its Push Session so you can find the work again.
Folders and agents
A folder agent gives a project folder a home for assigned work. It is distinct from the coding runtime, such as Claude Code or Codex, that performs that work. Choose the folder and runtime deliberately when starting work.
For teams, access is granted to people using their own accounts. Filing work, running agents, watching terminals and controlling terminals are separate permissions. See team setup.
The board
Todo is captured work waiting to be started. Active is work that has started. Completed is finished work. Creating a Todo does not by itself start an agent.
The work's control describes the next available action:
| Control | What you do |
|---|---|
| Run | Start the assigned work in an agent terminal on the host Mac. |
| Open | Go to its existing terminal. |
| Reopen | Return to an earlier conversation when it can be resumed. |
| Waiting | Check the pending start or capacity explanation. |
Follow the button's current explanation if access, availability or capacity prevents starting.
Needs you
Needs you means an agent is waiting for input or a tool permission. Read the request before replying. A question can be answered in the conversation or work thread; a permission prompt requires its approval controls. See work and approvals.
Artifacts
Artifacts are selected results and files attached to the work. Ask an agent to surface the final result instead of searching its terminal output for a path. Adding a file to the work and creating a public share link are different actions. See use your results.
One workspace, several entry points
The Mac hosts the work. Slack, the browser and iPhone let permitted people request, follow and review it. A sleeping or offline host cannot execute new work or provide a live terminal until it returns.
Use the Push skill to act from a conversation, or read where Push runs to choose a setup.