Codegate

ccbot

A Feishu (Lark) bot that lets you interact with [Claude Code](https://docs.anthropic.com/en/docs/claude-code) sessions from your phone through a Feishu group chat.

**Use case:** You have Claude Code running on a remote server. You step away from your desk. With ccbot, you can monitor progress, send follow-up instructions, and switch between projects — all from the Feishu app on your phone.

Features

• Multi-session support — Discover and switch between multiple Claude Code projects
• Full context continuity — Uses --continue to maintain conversation history with each project
• Streaming output — No hard timeout; streams Claude's response as it works
• Progress notifications — Reports which tool Claude is executing during long tasks
• Stop hook notifications — Automatically posts Claude's final response to the group when a task finishes
• Session discovery — Auto-detects running Claude Code processes via /proc and JSONL file timestamps
• Request queue — Track, inspect, and cancel pending requests

Architecture

┌──────────┐  WebSocket   ┌──────────────┐  claude --print  ┌─────────────┐
│  Feishu  │◄────────────►│ bot_service  │────────────────►│ Claude Code │
│  Group   │              │   .py        │◄────────────────│   CLI       │
└──────────┘              └──────────────┘  stream-json     └─────────────┘
     ▲                                                            │
     │ HTTP POST          ┌──────────────┐   Stop hook (stdin)    │
     └────────────────────│  notify.py   │◄───────────────────────┘
                          └──────────────┘

• bot_service.py — Long-running service. Connects to Feishu via WebSocket, receives messages, forwards them to claude --print --continue, and replies with results.
• notify.py — Lightweight script called by Claude Code's Stop hook. Reads the last assistant message from stdin and posts it to the group