POCOX

POcket COdeX · Every device, in your pocket.

English · 中文

Warning

POCOX is under active development: APIs, on-disk layout and protocols can change without notice. Bug reports and design feedback are welcome.

POCOX puts every device you own in your pocket. Keep using your agents the way their makers ship them; POCOX follows their sessions on each computer and lets your phone, tablet or another machine pick them up.

Works with

Codex native app-server

Claude Code ACP adapter

OpenCode native server

Grok Build ACP with Grok extensions

Any other ACP agent can be hosted from a program and its arguments (ACP agents).

What it does

• Image attachments — send images inline and keep a project-scoped host copy for the agent's image tools (attachments).

• Every session on the machine — list and follow live the sessions Codex, Claude Code, Grok Build and OpenCode run, including ones started in their own apps and CLIs (native history, with its platform limits).

• Any service, on every device — reach each computer's agents from your other devices and share a dev server or an API; agents can share ports and connect ports or APIs themselves through the pocox tools (agent tools).

• Agents on any desktop — macOS, Windows and Linux host several agents side by side, each with its own model service (hosting).

• Reach from anywhere — iOS, Android, desktop apps and a CLI steer turns, answer approvals, browse history and review changes (app).

• Share a subscription — publish a computer's Codex login as an OpenAI-compatible Responses API for devices without Codex (CLI).

• Manage your other computers — add, configure and stop another desktop's services from your phone (remote management).

Planned: agents that work with your other devices' shells and files directly.

How it works

Each computer runs the POCOX app or CLI beside its agents, and devices reach each other's services through a pb-mapper relay, with a shared key (self-host) or a GitHub sign-in (hosted account). Settings can opt into P2P direct connections with relay fallback and show the actual path; existing installations remain relay-only by default (connection paths). See architecture.

Get started

Download the apps from Releases, or install the CLI:

curl -fsSL https://raw.githubusercontent.com/acking-you/POCOX/main/scripts/install.sh | sh

pocox login     # on every device, with the same GitHub account
pocox serve     # on the computer that has Codex
pocox connect   # on another device, then run the printed codex --remote command

Windows install, self-host and every command: CLI · step by step: usage guide · your own backend: deploy. Releases after 0.6.0 start fresh: settings from earlier releases are not migrated (changelog).

Documentation

Use	Usage guide · CLI · Deploy · Architecture
Agents	Codex protocol · ACP agents · OpenCode · Grok Build · Hosting
Sessions	Native history · History cache · Guardian · File links · Images · Voice
App	UI · Composer · Agent tools · Galaxy · Updates
Devices	Remote management · Relay recovery · Connection lifecycle
Releases	macOS · Linux AppImage · Changelog

All pages: docs index.

Contributing

Build, test and PR steps are in CONTRIBUTING.md; coding and design rules for people and agents are in AGENTS.md.

License

Apache License 2.0. Submodules under deps/ keep their own licenses.