Skip to content
pushmanhqPublic

About

Send push notifications from your terminal to your iPhone

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

18 Commits

Folders and files

Repository files navigation

Pushman

Pushman

Send push notifications from your terminal, scripts, servers, and AI agents to your iPhone.

Website · Get started · ChatGPT and MCP · CLI source · Agent skills · Support

$ pushman push "Production deploy finished" --title "Acme API"
Accepted msg_01M0W2RDPVGEVX7D6ZWFK907B2 for 1 device

Pushman connects terminals and AI clients to your iPhone. Install the receiving app, authorize the CLI or connect hosted OAuth, and turn a requested result into a native notification through the hosted service.

Note

Pushman is in public beta and free to try. The iPhone app is preparing for its first App Store release; the download badge will appear here when the public listing is available.

Highlights

  • One command for terminals, shell scripts, servers, CI jobs, and local AI agents
  • Title, subtitle, body, URL, HTTPS image, sound, group, update key, and monospace presentation
  • Browser login or approval from the signed-in iPhone app
  • Multiple receiving devices with explicit targeting
  • Seven-day synchronized history and delivery diagnostics
  • Hosted OAuth MCP for ChatGPT and compatible native clients, plus local stdio MCP
  • Native credential storage in the operating-system keyring

Install the CLI

Homebrew is recommended on macOS and Linux:

brew install whitekiwi/tap/pushman
pushman login
pushman push "Hello from Pushman"

See Getting Started for pairing, device selection, updates, and troubleshooting. Source code, release archives, checksums, provenance, and contributor documentation live in pushmanhq/pushman-cli.

On Windows, download the x64 or ARM64 installer from CLI v0.5.2, verify its checksum and build provenance, then install it for your Windows user. Go and administrator access are not required. See the CLI installation guide for verification, updates, removal, and the optional ZIP channel. The native pushman.exe sends to the iPhone app and also provides local stdio MCP.

Public interfaces

  • api/openapi.yaml documents the supported HTTP interface used by the CLI.
  • Hosted OAuth MCP connects through account consent without a CLI.
  • pushman mcp exposes 17 local stdio tools for compatible AI clients in CLI v0.5.2.
  • The production service is hosted at https://api.pushman.io/v1.

CLI v0.5.2 defaults to the current API origin. For older published releases, set PUSHMAN_API_URL=https://api.pushman.io/v1 in every CLI and local MCP process. Log in at the new endpoint after updating. Credentials remain separate for each endpoint; the old login is not copied. Changing the hosted MCP URL requires a new OAuth connection. Existing installed iPhone apps also retain their compiled endpoint until updated.

The iPhone app and hosted service are maintained as private implementations. Publishing the CLI and public contract does not publish service credentials, mobile signing material, or private operational configuration.

Free beta

During the initial free release, each account can submit up to 200 accepted push requests per UTC calendar month, plus any current-month support credits. Messages remain available in synchronized history for seven days. See usage and limit notices for counting, reset times, and the quiet limit notification. Future paid plans may change allowances without changing the MIT license of the CLI.

Support and security

Use Support for product help and issue routing. Never post notification content, tokens, OAuth data, pairing codes, account identifiers, or unredacted logs publicly. Report suspected vulnerabilities according to Security Policy.

Repositories

  • pushmanhq/pushman — product documentation, public API, support, and roadmap
  • pushmanhq/pushman-cli — open-source CLI, MCP server, packaging, and releases
  • pushmanhq/skills — maintained skills, hosted OAuth plugin ZIP, and local Codex/Claude marketplaces
  • pushmanhq/pushman-ios — private iPhone app implementation
  • pushmanhq/pushman-server — private hosted-service implementation

Documentation and the public API specification in this repository are available under the MIT License.

About

Send push notifications from your terminal to your iPhone

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages