claudeers.
// Data & Analytics

pocketctl

Your AI coding agents, in your pocket — monitor and manage Claude Code, Codex, and OpenCode from your phone or browser.

// Data & Analytics[ cli ][ api ][ desktop ][ web ][ mobile ][ claude ]#claude#data◷ MIT$open-source⚠ not recently updated
Actively maintained
100/100
last commit 13 days ago
last release 13 days ago
releases 77
open issues 0
// star history
★ 11 github ↗

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up pocketctl (release-binary project) into my current project.
Found on https://claudeers.com/pocketctl
Repo: https://github.com/pocketctl/pocketctl
Homepage/docs: —
Detected install method: release-binary → inspect the README
Category: data. Platforms: cli, api, desktop, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (release-binary)

Grab the latest release asset from GitHub.

# download a build from https://github.com/pocketctl/pocketctl/releases
// or clone
git clone https://github.com/pocketctl/pocketctl

// compatibility

Platformscli, api, desktop, web, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageGo

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

pocketctl

Your AI coding agents, in your pocket.

Monitor and manage Claude Code, Codex, and OpenCode sessions from your phone or browser.

Features

  • 🤖 Multi-agent — Claude Code, Codex, and OpenCode, behind one unified "zero-config discovery + live sync + cross-device continue" model. Run an agent in your terminal; the daemon discovers it and syncs it to your client where you can keep chatting. (OpenCode is a client/server agent — the daemon hosts a shared opencode serve and drives it over its HTTP API. To add a new agent, register a Provider — see docs/adding-an-agent.md.)
  • 🖥️ Real-time Monitoring — Watch your AI coding sessions live from anywhere
  • 📱 iOS App — Native SwiftUI app: hosts dashboard, session list/detail (backward-paginated history), new-session sheet (model & permission picker, locale-aware auto titles), agent management with one-tap upgrade, token usage analytics, scan-to-authorize web login
  • 🖧 Hosts Dashboard — System resource monitoring (CPU / Memory / Disk) with remote daemon restart
  • 📌 Session Management — Pin, rename, export, and delete sessions with inline editing
  • 📊 Token Analytics — Usage dashboard (daily / model / host breakdown); deleting a session never shrinks historical totals
  • 🔔 Push Notifications — Get alerted when your agent needs attention
  • 🔄 Self-updating — One command to update to the latest version
  • 🌐 Web Dashboard — Full-featured Vue 3 SPA with dark/light theme, daemon & session management
  • 🔐 Secure — OAuth 2.0 Device Authorization Grant (RFC 8628) + email verification fallback
  • ⚡ Lightweight — Single binary, zero dependencies, runs on macOS and Linux

Architecture

┌─────────────┐   HTTP/WS   ┌─────────────┐     WebSocket      ┌─────────────┐
│  iOS App +  │◄───────────►│    Relay     │◄──────────────────►│   Daemon    │
│  Web App    │             │   (Server)   │                    │  (Desktop)  │
└─────────────┘             └─────────────┘                    └─────────────┘
                                                                         │
                                                                   ┌─────┴─────┐
                                                                   │ AI Agents  │
                                                                   │ (Claude,   │
                                                                   │  Codex...) │
                                                                   └───────────┘
  • Daemon — Runs on your development machine, discovers and monitors AI coding agent sessions
  • Relay — WebSocket server that bridges mobile/web clients with daemons
  • Web — Vue 3 SPA dashboard for browser-based monitoring, served at /app
  • iOS — Native SwiftUI app (iPhone) for real-time session monitoring & management on the go

Quick Start

Install

# Install the latest version (production)
curl -fsSL https://raw.githubusercontent.com/pocketctl/pocketctl/master/scripts/install-daemon.sh | bash -s -- --prod

# Or install for local development
curl -fsSL https://raw.githubusercontent.com/pocketctl/pocketctl/master/scripts/install-daemon.sh | bash

Login

# Desktop: OAuth 2.0 Device Flow (opens browser)
pocketctl login --prod

# Headless server: email verification code
pocketctl login --prod --email

Start the Daemon

pocketctl daemon start --prod

Check Status

pocketctl daemon status

Commands

CommandDescription
pocketctl login [--prod]Login via browser (OAuth 2.0 Device Flow) or email code (--email)
pocketctl daemon start [--prod]Start the daemon
pocketctl daemon stopStop the running daemon
pocketctl daemon statusShow daemon status and active sessions
pocketctl daemon logsView daemon logs
pocketctl daemon doctorDiagnose connection issues
pocketctl daemon updateUpdate to the latest version
pocketctl uninstall [--yes] [--keep-binary]Remove daemon, config, and data directories
pocketctl versionPrint version

Environment Variables

VariableDescription
POCKETCTL_RELAY_URLRelay WebSocket URL (e.g. wss://your-domain.com/ws)
POCKETCTL_TOKENJWT token for authentication
SES_FROM_EMAILSender email address for verification emails
SES_REGIONTencent Cloud SES region (default: ap-hongkong)
DEV_EMAILDev mode test email address
DEV_EMAIL_CODEDev mode test verification code
ZHIPU_API_KEY智谱 GLM API key for session title generation
WEB_APP_URLPublic base URL for OAuth device authorization redirect

Build from Source

git clone https://github.com/pocketctl/pocketctl.git
cd pocketctl
make build

Self-Update

# Update to the latest version
pocketctl daemon update

# Update to a specific version
pocketctl daemon update --version v0.1.0

Project Structure

pocketctl/
├── cmd/pocketctl/main.go          # CLI entry point
├── internal/
│   ├── adapter/                   # Agent output parsers (Claude Code JSONL)
│   ├── api/                       # HTTP API client (auth)
│   ├── config/                    # Config management (~/.pocketctl/auth.json)
│   ├── daemon/                    # PID file, daemon state, machine ID
│   ├── discovery/                 # Agent CLI auto-discovery
│   ├── notify/                    # Terminal notifications
│   ├── protocol/                  # WebSocket message type definitions
│   ├── session/                   # Session lifecycle management
│   ├── sysinfo/                   # System resource collection (CPU/Memory/Disk via gopsutil)
│   ├── update/                    # Self-update (version check, download, verify)
│   ├── watcher/                   # Session file monitoring (fsnotify, JSONL tailing)
│   └── ws/                        # WebSocket client with auto-reconnect
├── relay/
│   └── src/
│       ├── server.ts              # Fastify HTTP + WebSocket server
│       ├── router.ts              # WebSocket message routing
│       ├── auth.ts                # JWT sign/verify with jti revocation
│       ├── db.ts                  # PostgreSQL queries
│       ├── push.ts                # Push notification service
│       ├── title.ts               # LLM title generation (智谱 GLM)
│       └── config/
│           ├── clients.ts         # OAuth 2.0 client registry
│           ├── auth-sessions.ts   # Device authorization session store
│           ├── email.ts           # Tencent Cloud SES email client
│           └── verification.ts    # Shared verification code store
├── web/                           # Vue 3 web dashboard
│   └── src/
│       ├── views/                 # DashboardView, SessionDetail, TokenUsage, HostsView, SettingsView, LoginView, DeviceAuthView
│       ├── composables/           # useAuth, useWebSocket, useCountdown, useRelativeTime, useSessionRename
│       ├── components/            # SessionActions, SessionTimeline, NewSessionDialog, SubAgentCard, MarkdownRenderer, etc.
│       └── assets/                # Design system CSS, logo SVGs
├── ios/Pocketctl/                 # Native iOS app (SwiftUI, iOS 17+)
│   ├── Models/                    # Daemon, Session, WebSocketEvent, ModelOption, ChatMessage, SubAgent, ...
│   ├── Services/                  # APIClient, WebSocketService, KeychainStorage
│   ├── ViewModels/                # DaemonListVM, SessionListVM, SessionDetailVM, AgentManageVM, TokenUsageVM
│   ├── Views/                     # DaemonListView, SessionListView, SessionDetailView, NewSessionSheet, AgentManageView, TokenUsageView, SettingsView, LoginView, ScanLoginView
│   ├── Theme/ Utils/              # Design tokens, AgentDefaultsStore
│   └── App/                       # App entry
├── scripts/
│   ├── install-daemon.sh          # One-line installer
│   └── sync-github.sh             # Sync to GitHub
├── go.mod
└── go.sum

Tech Stack

ComponentTechnology
DaemonGo 1.25, gorilla/websocket, fsnotify, gopsutil
RelayTypeScript, Fastify v5, @fastify/websocket, PostgreSQL
Web UIVue 3, Vue Router 4, Vite 6, TypeScript
iOS AppSwift, SwiftUI, iOS 17+, @Observable

License

MIT

// faq

What is pocketctl?

Your AI coding agents, in your pocket — monitor and manage Claude Code, Codex, and OpenCode from your phone or browser.. It is open-source on GitHub.

Is pocketctl free to use?

pocketctl is open-source under the MIT license, so it is free to use.

What category does pocketctl belong to?

pocketctl is listed under data in the Claudeers registry of Claude-compatible tools.

4 views
★ 11 stars
unclaimed
updated 3 months ago

// embed badge

pocketctl on Claudeers
[![Claudeers](https://claudeers.com/api/badge/pocketctl.svg)](https://claudeers.com/pocketctl)

// retro hit counter

pocketctl hit counter
[![Hits](https://claudeers.com/api/counter/pocketctl.svg)](https://claudeers.com/pocketctl)

// reviews

// guestbook

0/500

// related in Data & Analytics

🔓
CLIProxyAPI

Wrap Antigravity, ChatGPT Codex, Claude Code, Grok Build as an OpenAI/Gemini/Claude/Codex compatible API service, allowing you to enjoy the free Gemini 3.1 P…

// datarouter-for-me/⟨Go⟩★ 54,158◷ MIT[ claude ]
🔓
marketingskills

Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.

// datacoreyhaines31/⟨JavaScript⟩★ 52,036◷ MIT[ claude ]
🔓
airflow

Apache Airflow - A platform to programmatically author, schedule, and monitor workflows

// dataapache/⟨Python⟩★ 47,013◷ Apache-2.0[ claude ]
🔓
claude-code-templates

CLI tool for configuring and monitoring Claude Code

// datadavila7/⟨Python⟩★ 32,352◷ MIT[ claude ]
→ see how pocketctl connects across the ecosystem