convez.ai
Agente
pocketctl

pocketctl

pocketctl/pocketctl

Ver no GitHub
InicialPluginScore · de 0 a 100

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

Instalação

$npx convez-ai pocketctl/pocketctl

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
13
Forks
2
Acompanhando
0
Saúde
50%
Último commit
há 1 dia
Versão
v0.5.19
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

pocketctl

Your AI coding agents, in your pocket.

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

Features

  • 🖥️ Real-time Monitoring — Watch your AI coding sessions live from anywhere
  • 📱 Mobile Control — Send messages, create sessions, and manage agents from your phone
  • 🔔 Push Notifications — Get alerted when your agent needs attention
  • 🔄 Self-updating — One command to update to the latest version
  • 🔐 Secure — JWT authentication with phone number verification
  • ⚡ Lightweight — Single binary, zero dependencies, runs on macOS and Linux

Architecture

┌─────────────┐     WebSocket      ┌─────────────┐     WebSocket      ┌─────────────┐
│   iOS App   │◄──────────────────►│    Relay     │◄──────────────────►│   Daemon    │
│  (Mobile)   │                    │   (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 clients with daemons
  • Web — Web dashboard for browser-based monitoring

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

pocketctl login --prod

Start the Daemon

pocketctl daemon start --prod

Check Status

pocketctl daemon status

Commands

CommandDescription
pocketctl login [--prod]Login via phone number (SMS verification)
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 versionPrint version

Environment Variables

VariableDescription
POCKETCTL_RELAY_URLRelay WebSocket URL (e.g. wss://your-domain.com/ws)
POCKETCTL_TOKENJWT token for authentication

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, SMS)
│   ├── config/                    # Config management (~/.pocketctl/auth.json)
│   ├── daemon/                    # PID file, daemon state management
│   ├── discovery/                 # Agent CLI auto-discovery
│   ├── notify/                    # Terminal notifications
│   ├── protocol/                  # WebSocket message type definitions
│   ├── session/                   # Session lifecycle management
│   ├── update/                    # Self-update (version check, download, verify)
│   ├── watcher/                   # Session file monitoring (fsnotify)
│   └── ws/                        # WebSocket client with auto-reconnect
├── relay/
│   └── src/                       # Fastify + WebSocket relay server
├── web/                           # Vue 3 web dashboard
├── 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
RelayTypeScript, Fastify v5, @fastify/websocket, PostgreSQL
Web UIVue 3, Vue Router 4, Vite 6, TypeScript

License

MIT

Ver o original no GitHub

Bom para

Relacionados