cursor-cp-cli: Attach Telegram to Local Cursor CLI Agent Sessions
cursor-cp-cli is an open-source daemon that bridges Telegram to local Cursor CLI chats via agent -p --resume. It features a real-time web dashboard, SQLite session persistence, multi-workspace support, and mode switching for headless agent execution.
Impact: Medium
Why it matters
Monitor, queue, and interact with running local Cursor CLI agents remotely from your mobile Telegram app.
TL;DR
- 01Remotely manage and resume local Cursor agent sessions from Telegram.
- 02Run background execution daemons on macOS and Linux via systemd or LaunchAgents.
- 03Switch between autonomous agent execution and read-only plan/ask modes remotely.
Key facts
- Default HTTP Port
- 8747
- Supported Node.js Version
- 22.x
- Local Chat Storage Path
- ~/.cursor/chats
- Database Engine
- SQLite
Bridging Local Cursor CLI to Mobile Telegram
cursor-cp-cli links mobile messaging to local CLI agent sessions in ~/.cursor/chats. Running the /cli command inside Telegram lists local chats, allowing remote attachment via agent -p --resume <chatId> --workspace <cwd> --trust --force.
Execution Modes and Background Processing
The bridge supports execution modes via agent --mode: default agent mode with automated code edits, alongside read-only plan and ask modes. Output is streamed live into Telegram via inline message edits, while jobs are processed through a per-chat FIFO queue.
Single-Line Installation and User Service
Deploying requires Node.js 22.x and the local agent CLI binary. Installation handles user-space setup under ~/.local/share/cursor-cp without requiring sudo privileges.
Try it in 2 minutes
curl -fsSL https://raw.githubusercontent.com/xabaras/cursor-cp-cli/main/install.sh | bashbash
✓ When to use
- When you need to send instructions and monitor local Cursor CLI agent jobs away from your workstation.
✕ When NOT to use
- Do not use when simultaneous access to the same CLI chat from both the terminal TUI and Telegram is required.
- Not supported for background daemon execution on Windows.
What to do today
- Install cursor-cp-cli via the official one-line install script.
- Configure enable_cli_bridge in ~/cursor-cp/config.yaml and pair your Telegram bot token.
Sources