Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
Run local Codex CLI from Feishu/Lark chat with sessions, attachments, and background service support
triggers
["how do I set up the Feishu Codex bridge","configure feishu codex bridge for my team","run codex commands from Lark chat","manage Feishu bot sessions and workspaces","troubleshoot feishu-codex-bridge connection","set up background service for Lark Codex bot","use codex CLI through Feishu messages","configure reasoning effort for Feishu Codex bridge"]
A local bridge that connects Feishu/Lark chat to your local Codex CLI. Send messages in Feishu/Lark and the bridge runs codex exec on your machine, streaming results back to chat with session persistence, file attachments, and background service support.
What It Does
Chat-to-CLI Bridge: Converts Feishu/Lark messages into local codex exec commands
Session Management: Maps each chat/topic to a persistent Codex session
Attachment Support: Downloads images and files for Codex to process
Workspace Management: Switch between named project directories
Background Service: Runs as a macOS launchd service
Access Control: Allowlist users, chats, and admin commands
Lark-CLI Integration: Gives Codex API access to Lark messages, docs, calendars
Installation
Global NPM Install
npm i -g feishu-codex-bridge
feishu-codex-bridge --version
First-Time Setup
feishu-codex-bridge start
This interactive setup will:
Find or install Codex CLI (@openai/codex)
Check codex login status and prompt if needed
Show a QR code for Feishu/Lark app creation
Create PersonalAgent app and save config
Install and initialize lark-cli with the same App ID
Start listening for chat events
After setup, test in Feishu/Lark DM:
/status
Help me inspect this repo
Requirements
Node.js >= 20
Network access to npm, OpenAI/Codex, and Feishu/Lark platform
/status # Show cwd, session, agent, reasoning effort
/help # Show help card with all commands
/stop # Stop current Codex run
/reconnect # Reconnect WebSocket
/ps # List bridge processes
/exit <id|#> # Stop a bridge process (admin)
/doctor [description] # Diagnose bridge issues with Codex
Session Management
/new # Reset current chat's session
/reset # Alias for /new
/resume [N] # List and resume recent sessions in cwd
/timeout [N|off|default] # Set idle timeout for current session
Workspace Management
/cd <path> # Change working directory (resets session)
/ws list # List named workspaces
/ws save <name> [path] # Save workspace (defaults to current cwd)
/ws use <name> # Switch to workspace
/ws remove <name> # Delete workspace
Example workspace workflow:
/cd ~/projects/api-server
/ws save api-server
/cd ~/projects/frontend
/ws save frontend
/ws list
/ws use api-server
Configuration
/config # Open interactive config menu
/account # View or change Feishu/Lark app (admin)
Background Service
Install and Manage (macOS launchd)
# Complete foreground setup first
feishu-codex-bridge start
# Test with /status in chat, then Ctrl+C# Install service
feishu-codex-bridge service install launchd
# Check status
feishu-codex-bridge service status
# View logs
feishu-codex-bridge service logs --follow
# Restart
feishu-codex-bridge service restart
# Uninstall
feishu-codex-bridge service uninstall
# Check process state
feishu-codex-bridge ps
feishu-codex-bridge service status
# Follow logs
feishu-codex-bridge service logs --follow
# Check today's structured logstail -f ~/.feishu-codex-bridge/logs/$(date +%Y-%m-%d).log
If process is running but bot doesn't respond, verify:
Permission scopes in Developer Console
Event subscriptions are enabled
Long-connection mode is active
Codex CLI Issues
# Auto-diagnose
feishu-codex-bridge doctor
# Rerun setup
feishu-codex-bridge start
Common fixes:
Codex not in PATH: Bridge auto-installs to ~/.feishu-codex-bridge/codex-cli
Not logged in: Setup prompts for codex login
App mismatch: Ensure bridge and lark-cli use same App ID
// Save workspaces for quick switching
/cd ~/work/backend-api
/ws save backend
/cd ~/work/frontend-app
/ws save frontend
/cd ~/work/docs
/ws save docs
// Switch between projects
/ws use backend
Help me add rate limiting to the auth endpoint
/ws use frontend
Update the login form to show better errors
/ws use docs
GenerateAPI docs from the OpenAPI spec
Session Resume After Restart
# List recent sessions in current directory
/resume
# Resume specific session (shows last 10)
/resume 3
Per-Chat Reasoning Effort
# High effort for complex refactoring
/config
# Select "Reasoning Effort" > "xhigh"
# In different chat, use default
/config
# Select "Reasoning Effort" > "default"
