/push docs

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

Browse the docs
Capture context · Guide

Capture an idea by voice

Save a thought on your iPhone, review its text, and bring it into your Mac workspace.

Capture an idea while you are away from the keyboard and return to it as work in Push.

Before you start

Install the iPhone app, currently available through TestFlight, and allow microphone access when you choose to record. Connect your Mac when you want captures to reach its workspace. Capture can be used before a Mac is available.

On-device transcription may first need a speech-model download. Optional OpenRouter processing uses a key you configure and your provider account.

Record the idea

Hold Push to Talk and release to finish, or use Tap to Talk for a hands-free capture that you stop explicitly. Include the project and intended outcome in what you say. Review the text and attachments before treating them as the final instructions.

On a compatible iPhone, the Push to Talk App Shortcut can be assigned to the Action Button. Run it once to start and again to finish a hands-free capture. The visible recording activity tells you whether it is still recording.

See the result

Open the captured item on the phone. When your Mac is reachable and the capture syncs, find it in the intended workspace and folder. Capturing a thought and starting an agent are separate actions.

Once you open the work with your agent, you can ask:

Ask your agent
Read my captured note and explain the intended task. Ask me about any ambiguous words before starting.

What happens to your audio

Without your OpenRouter key, transcription runs on the iPhone; supported on-device features can help organize the text. A local recording can later sync to your paired Mac.

With OpenRouter configured, audio and relevant text or attachments can go to that provider for processing. Context may include language, vocabulary and project information used to organize the capture. Provider privacy and retention policies apply. Failed requests may fall back to local processing.

Offline captures stay on the phone until processing and sync are available. Review data handling before choosing provider processing.

Terminal voice input

Voice input inside a live terminal sends text to the selected conversation on your Mac. Check that you selected the right terminal before speaking. The Mac must be reachable for this live interaction.

If something stops

Check microphone permission, the local transcription download or your configured provider key. If the Mac is asleep, keep the capture and wait for it to reconnect. Do not delete unsynced captures or the account while trying to fix connectivity.

Next, use the iPhone companion or track and return to work. Current offering and provider-cost guidance are at pricing.

Updated