Pocket Server provides a local runtime for AI agents, enabling mobile control and collaboration with codebases. It targets developers seeking a fast, secure, local-first OS experience for their AI agents directly on their phone, offering seamless integration with their development environment.

How It Works

Employs a server-authoritative architecture with an event-driven protocol over WebSocket and REST (Hono). It bundles Node.js, exposing APIs for mobile interaction with agent runtime, terminal, file system, and background jobs. This approach ensures state consistency and a responsive mobile interface, making AI agents feel native to a mobile device.

Quick Start & Requirements

Installation is via a one-liner script (curl -fsSL https://www.pocket-agent.xyz/install | bash). Supports macOS (arm64, x64) and Linux (x64), bundling Node v22.18.0. Optional remote access uses Cloudflare tunnels. Official installer link: https://www.pocket-agent.xyz/install.

Highlighted Details

• Agent runtime with bash, editor, and web-search tools.
• Native, touch-optimized mobile terminal with multi-tab sessions.
• In-app file system browsing, editing, and diffing.
• Fuzzy code search across repositories.
• Background agent execution for autonomous coding jobs and PR management.
• Local-only PIN pairing and short-lived tokens for secure remote access.
• Desktop client for attaching and resuming terminal sessions.

Maintenance & Community

README does not detail contributors, sponsorships, or community channels (Discord/Slack). Versioned releases and multi-architecture support suggest ongoing development.

Licensing & Compatibility

Licensed under Apache-2.0, a permissive license suitable for commercial use and integration with closed-source projects.

Limitations & Caveats

Official releases target macOS and Linux; Windows support is not specified. The system relies on a companion mobile application for its primary interface. Uninstalling removes local session data.