/push docs

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

Browse the docs
Organize your work · Guide

See what needs your attention

Find running work, open the right conversation, and act on questions or stalled progress.

Use Push to get back to the work that needs a decision without opening every terminal.

Before you start

Open your workspace in Push, or use a coding agent with the Push skill. You see only work your account can access. The host Mac must be reachable for a current view of its activity.

Ask for the workspace picture

Ask your agent
What is running in Push, what needs my attention, and where should I open it? Explain anything that is waiting before starting more work.

For a direct lookup, run in a shell:

Run in your shell
push status

For items that need attention:

Run in your shell
push attention

These commands inspect work; they do not answer questions or approve actions for you.

See the result

Use the work reference or link in the answer to open the Push Session. Its thread provides the request and latest result; its terminal shows the live conversation. Read needs you, pending starts and offline notices as different situations.

For one item, give its reference to the agent and ask for that work's status. You can also use push status SESSION_REF in the shell, replacing SESSION_REF with the reference displayed on its card.

Answer the right request

Reply to a question in its conversation or thread. For a permission prompt, inspect the requested tool action and use the available approval controls. If you want an agent to change direction, say what should change and which work it belongs to.

If something stops

An old answer can describe an earlier state. Refresh the work view or ask for a new lookup. If the Mac is offline, reconnect it first; a visible request does not establish that new instructions have executed.

For missing access, contact the workspace owner. For connection or runtime problems, follow troubleshooting. See work and approvals for the full decision path.

Updated