https://github.com/pink-tools/pink-agent
Remote terminal control via Telegram. WebSocket streaming, Cloudflare tunnel.
https://github.com/pink-tools/pink-agent
claude-code cloudflare go telegram terminal websocket
Last synced: 3 days ago
JSON representation
Remote terminal control via Telegram. WebSocket streaming, Cloudflare tunnel.
- Host: GitHub
- URL: https://github.com/pink-tools/pink-agent
- Owner: pink-tools
- Created: 2025-12-09T18:11:32.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-02-12T04:57:17.000Z (6 days ago)
- Last Synced: 2026-02-12T14:44:31.797Z (6 days ago)
- Topics: claude-code, cloudflare, go, telegram, terminal, websocket
- Language: Go
- Size: 98.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# pink-agent
Remote terminal control via Telegram with real-time WebSocket streaming.
## Installation
Install via [pink-orchestrator](https://github.com/pink-tools/pink-orchestrator) (recommended), or download binary from [Releases](https://github.com/pink-tools/pink-agent/releases) into `/Users/pink-tools/pink-agent/`.
## Requirements
- [cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)
- [pink-transcriber](https://github.com/pink-tools/pink-transcriber) (optional, for voice)
## Configuration
Create `/Users/pink-tools/pink-agent/.env`:
```bash
TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_USER_ID=your_user_id
# Named tunnel (request from admin)
TUNNEL_NAME=pink-yourname
TUNNEL_ID=your-tunnel-uuid
# + place credentials file: ~/.cloudflared/{TUNNEL_ID}.json
```
Get credentials:
1. Bot token: [@BotFather](https://t.me/botfather)
2. User ID: [@userinfobot](https://t.me/userinfobot)
3. Named tunnel — setup:
```bash
cloudflared tunnel create pink-yourname
cloudflared tunnel route dns pink-yourname pink-yourname.yourdomain.com
```
Then set `TUNNEL_NAME=pink-yourname`, `TUNNEL_ID={uuid from create output}`
## Usage
```bash
pink-agent # Start daemon
pink-agent send "message" # Send to Telegram
pink-agent send -f file.png # Send file
pink-agent store list # List project files
pink-agent store add file.md "content" # Add file
pink-agent store get file.md # Read file
pink-agent --version # Show version
pink-agent --health # Check configuration
```
## Build from Source
```bash
git clone https://github.com/pink-tools/pink-agent.git
cd pink-agent
make build
```