zarazhangrui/lark-coding-agent-bridge

What it solves

This project provides a bridge between the Feishu/Lark messenger and local AI coding agents like Claude Code or Codex CLI. It allows users to interact with their local development environment and coding agents directly from a chat interface, eliminating the need to keep a terminal open for every interaction.

How it works

The bridge acts as a middleware that forwards messages from Feishu/Lark to a local agent process. It manages sessions, working directories, and file attachments. It uses a PersonalAgent app to connect to the messenger's API, which can be configured via a QR-code wizard during the first run.

Who it’s for

Developers who use Claude Code or Codex CLI and want to access their local coding agents via a mobile or desktop chat app (Feishu/Lark) for convenience, remote access, or team collaboration.

Highlights

• Real-time Streaming: Updates text replies and tool calls on a single Lark card in real time.
• Session Management: Maintains separate sessions for different chats, topics, or document comment threads.
• Workspace Control: Supports switching project directories using /cd and saving named workspaces with /ws.
• Access Control: Private by default, with granular permissions to invite specific users, groups, or admins.
• COT Process Visibility: Optionally displays the agent's "Chain of Thought" (COT) process, including tool calls and progress text, before the final answer.
• File Handling: Automatically downloads images and files sent via chat to the local agent's environment.
• Background Service: Can be run as an OS-managed daemon (systemd, launchd, or Windows Task Scheduler) for persistent availability.