# Pontia

> Install Pontia and turn your device into an agent cloud you can control from anywhere.

## Documentation

- [Agent Clients](https://pontia.dev/docs/agent-clients.md): Choose and configure the coding-agent clients supported by Pontia.
- [pi Agent Client](https://pontia.dev/docs/agent-clients/pi.md): Install and use the pi Agent Client integration with Pontia.
- [CLI reference](https://pontia.dev/docs/cli.md): Reference for Pontia local service, remote access, update, and Workflow commands.
- [Codex](https://pontia.dev/docs/codex.md): Set up the Codex daemon for Pontia on Linux and macOS.
- [Configuration](https://pontia.dev/docs/configuration.md): Configure Pontia state, Dashboard access, Workspaces, file search, and Agent Clients.
- [Dashboard guide](https://pontia.dev/docs/dashboard.md): Create and control coding-agent sessions from the Pontia Dashboard.
- [Device and account management](https://pontia.dev/docs/device-management.md): Manage Pontia remote devices, encryption identities, sign-in methods, and sessions.
- [Frequently asked questions](https://pontia.dev/docs/faq.md): Answers to common questions about Pontia sessions, data, remote access, and operation.
- [Getting started](https://pontia.dev/docs/getting-started.md): Install Pontia and initialize your local agent cloud.
- [How Pontia works](https://pontia.dev/docs/how-it-works.md): Understand where Pontia runs agents and how local and remote access work.
- [Initialization](https://pontia.dev/docs/initialization.md): Initialize Pontia interactively, or set up clients, the local service, and remote access with commands an agent can run one at a time.
- [Linux](https://pontia.dev/docs/platforms/linux.md): Linux requirements and service management for Pontia.
- [macOS](https://pontia.dev/docs/platforms/macos.md): macOS requirements and LaunchAgent management for Pontia.
- [Remote access](https://pontia.dev/docs/remote-access.md): Connect your Pontia device and control agent sessions remotely.
- [Security](https://pontia.dev/docs/security.md): Understand Pontia's trust boundaries, encryption, credentials, and local permissions.
- [Self-host an Edge](https://pontia.dev/docs/self-hosted-edge.md): Deploy and operate a self-hosted Pontia Edge on a public Linux server.
- [Troubleshooting](https://pontia.dev/docs/troubleshooting.md): Diagnose Pontia service, Dashboard, Agent Client, and remote-access problems.
- [Updating Pontia](https://pontia.dev/docs/updating.md): Update Pontia and self-hosted Edges using verified stable releases.
- [Workflows](https://pontia.dev/docs/workflows.md): Run and monitor durable multi-agent Workflows with Pontia.
- [Workspaces](https://pontia.dev/docs/workspaces.md): Configure project directories and file discovery in Pontia.

## Blog

- [Get a phone notification when Codex or pi needs you](https://pontia.dev/blog/coding-agent-phone-notifications.md): Push a notification to your phone when Codex CLI asks for approval or finishes a turn, and when pi is waiting for input. Tested Codex hooks and a pi extension that send through ntfy, with the privacy and trust details that trip people up.
- [Tailscale vs Cloudflare Tunnel: reaching a coding agent server from your phone](https://pontia.dev/blog/tailscale-vs-cloudflare-tunnel-for-coding-agents.md): How to reach Codex or pi on a home server or VPS from a phone without opening ports. Compares Tailscale, Cloudflare Tunnel with cloudflared, and Cloudflare's browser SSH terminal, with setup steps and the pitfalls, including conflicts with other VPNs and proxies.
- [How to use Codex CLI from your phone](https://pontia.dev/blog/control-codex-cli-from-your-phone.md): Follow, steer, and approve Codex CLI sessions from a phone, on Linux or macOS. Compares Pontia, OpenAI's ChatGPT remote control and Codex Cloud, and a do-it-yourself SSH and tmux setup.
- [How to use pi coding agent from your phone](https://pontia.dev/blog/pi-coding-agent-remote-control.md): Follow and steer pi coding agent sessions from your phone while keeping the native pi TUI. Compares Pontia with do-it-yourself SSH and tmux, and pi in Termux, plus tmux key setup and safety notes.
- [Running Codex and pi on a VPS: a setup checklist for always-on coding agents](https://pontia.dev/blog/run-coding-agents-on-a-vps.md): How to set up a Linux VPS for long-running coding agents like Codex and pi and reach them from your phone, covering user accounts, systemd lingering, headless sign-in, session persistence, and remote access without open ports.