/push docs

The manual for the terminal that remembers your agent sessions.

Browse the docs
Mac app

Settings reference

All eight Settings panes (⌘,) — every switch, in the order the app shows them.

Terminal

The runtime health table — one row per agent CLI with RUNTIME · STATUS · BYPASS PERMISSION. Statuses you'll see: Ready, Installed, Not installed, Sign-in needed, Rate limited, Usage limited. Below it, "I just installed a CLI" → Re-probe runtimes.

  • Bypass permission (per runtime) — flips that agent into unattended mode for future sessions. The confirmation says exactly what it does: "Push will start future X terminal sessions in unattended mode. Existing sessions and agent configuration files are unchanged."
  • Automatically update code agent runtimes — "Push runs each installed runtime's own updater in the background when that runtime is idle."
  • Run capacity → Session slots — how many agent sessions run at once.
  • Open new tabs at — new-tab placement in the strip.
  • Show details when hovering a tab · Show system sessions · Open localhost links in the artifact inspector · Open pasted images in the artifact inspector.

Account

Sign in with Apple, Google, or GitHub; shows "Signed in as …", manages Connected Accounts (link several providers to one account), Sign Out…. What an account is actually for: Account & relay.

Workspace

  • This Mac — host, server Running/Stopped, Restart Server.
  • Workspace identity — workspace name and the Issue prefix your issue references are built from.
  • Pairing Tunnel — connecting a phone or browser.
  • Devices — every paired device; Revoke, Block, or Disconnect All Devices.
  • File accessAllow file access; with Allow file publishing, human-only switches agents can never change.
  • Push CLI and skill — installs the bundled push command to ~/.local/bin and keeps the agent skill current, with a copy-paste PATH fix when needed. See The push CLI.
  • Your data — the on-disk inventory: local database, ~/.push/storage, logs/caches/secrets, pairing identity, recordings & media; plus Disk encryption (FileVault status).
  • Purged session history → Clear purged history — deletes the local session archive.

Always On

Never sleep while plugged in (even with the lid closed) and Never sleep on battery, with live sleep-management status. Uses a small system helper you approve as a background item — the honest details are in Permissions.

Notifications

  • Show notifications on this Mac — local banners.
  • Send push notifications to my devices — the phone leg.
  • Smart deliveryNotify my iPhone even when I'm active on this Mac (off means the phone stays quiet while you're at the keyboard), Count me away after (the delay before held alerts release), Bundle bursts (many finished agents become one summary).
  • Show agent status as a Live Activity on my iPhone.
  • Quiet hours — From / Until / Time zone. Urgent "needs you" kinds still come through.

A per-kind notification matrix exists behind Beta features → Advanced notification settings.

Meeting

Appears only while Meeting recording (Beta) is on — capture, transcription key, and storage controls, documented in Meeting recording.

Permissions

Live status and request buttons for Microphone, Contacts, Calendar, and Location, plus Telemetry → Send anonymous telemetry — the one switch covering the daily ping and crash reports, detailed in How Push handles your data.

Beta features

Three switches today: Meeting recording, Skills sidebar entry, Advanced notification settings. The pane's own words: "Beta features are off by default. They may misbehave, change, or be removed in a future update."

Verified against Push 1.10.197 · Updated 2026-08-08