explaingit

qqqingyu/feishu-codex-bridge

22TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A bridge that connects the Feishu or Lark chat apps to OpenAI Codex so you can type coding instructions in chat and have Codex run terminal commands and edit files on your local machine in real time.

Mindmap

mindmap
  root((feishu-codex-bridge))
    What it does
      Chat to terminal bridge
      Run Codex via chat
      Stream output to chat
    Tech stack
      TypeScript
      Node.js
      OpenAI Codex
      Feishu Lark API
    Use cases
      Team coding assistant
      Remote file editing
      Background service
    Setup
      QR code login
      Auto installer
      macOS launchd
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Send coding tasks in a Feishu or Lark chat and have Codex execute terminal commands and edit files on your local machine without switching windows.

USE CASE 2

Share a coding assistant with a small team through a Feishu group, with each conversation keeping its own isolated Codex session.

USE CASE 3

Run the bridge as a persistent macOS background service using launchd so it stays active after you close the terminal.

USE CASE 4

Attach files and images in chat for Codex to receive locally as context when working on coding tasks.

Tech stack

TypeScriptNode.jsOpenAI CodexFeishu APILark CLI

Getting it running

Difficulty · moderate Time to first run · 30min

Requires a Feishu or Lark developer account and creating a bot app through the guided setup wizard.

No license information is provided in the explanation.

In plain English

This tool connects the Feishu and Lark chat apps to OpenAI's Codex coding assistant, letting you send messages in chat and have Codex run commands and edit files on your own computer in response. Instead of switching to a terminal window, you type instructions to a bot in a Feishu or Lark conversation, and the bot runs Codex locally and streams the output back to the chat. The first-run setup is designed to minimize manual installation. The bridge checks whether Codex and a companion tool called Lark CLI are installed, and if either is missing, it installs them into a private folder in your home directory rather than a system-wide location. This avoids permission problems on managed company machines. You scan a QR code to link to a Feishu or Lark account and create a bot app through a guided wizard. Once running, each chat conversation or topic group gets its own Codex session. You can switch which folder on your computer the bot works in, send files and images as attachments that Codex receives locally, and resume previous sessions if a conversation is interrupted. Slash commands control the main behaviors: /new resets the current session, /cd changes the working folder, /config adjusts concurrency, tool visibility, and reasoning settings, and /stop halts a running task. On macOS, the bridge can be installed as a background service using the system's built-in launchd mechanism, so it keeps running after you close the terminal. Logs are stored in a standard folder under your home directory. Access control settings let you restrict which users or chat groups can interact with the bot, which is useful when you want to share the assistant with a small team while keeping control over what runs on your machine.

Copy-paste prompts

Prompt 1
I just installed feishu-codex-bridge. Walk me through creating a Feishu bot app and scanning the QR code to link it to my local machine.
Prompt 2
I'm using feishu-codex-bridge and want to use /config to restrict which tools Codex can call. What settings should I change for a read-only code review session?
Prompt 3
Show me how to set up the launchd service for feishu-codex-bridge on macOS so it restarts automatically after a reboot.
Prompt 4
I want to restrict feishu-codex-bridge so only specific Feishu users can send commands. How do I configure the access control settings?
Prompt 5
Help me use the /cd command in feishu-codex-bridge to switch my working folder and start a fresh Codex session for a different project.
Open on GitHub → Explain another repo

← qqqingyu on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.