Fox Gateway

Fox Gateway connects Feishu (Lark) chat with a local coding agent runtime.

At the moment, the only coding agent backend supported is Claude Code.

Install

curl -fsSL https://raw.githubusercontent.com/hulz413/fox-gateway/main/scripts/install.sh | bash

This installs the latest GitHub Release binary to ~/.local/bin/fox-gateway. The installer script itself is fetched from the repository raw URL, while the binary payload is downloaded from GitHub Releases.

Supported platforms:

• Linux amd64 / x86_64
• macOS Intel (x86_64)
• macOS Apple Silicon (arm64)

If fox-gateway is not available in your current shell after install, run:

source ~/.profile

Or open a new shell session.

Upgrade

Upgrade to the latest release:

fox-gateway upgrade

Upgrade to a specific tag:

fox-gateway upgrade v0.1.1

The upgrade command prints the current version and target version before replacing the currently installed fox-gateway binary in place. If they are already the same, it skips the update entirely. GitHub Releases remain the source of truth. If the gateway service is running, stop it first:

fox-gateway stop
fox-gateway upgrade

Quick start

1. Run setup

fox-gateway setup

This writes local runtime config to ~/.fox-gateway/fox-gateway.json by default. Pairing state is stored in the local database.

During setup, you will be asked for:

• LARK_APP_ID
• LARK_APP_SECRET

2. Start the gateway

fox-gateway start

3. Pair the first user

After setup, start the gateway once and use the printed pairing message in the Feishu bot chat from the account you want to use as the first user.

4. Talk to the bot in Feishu

After pairing, send messages to the Feishu bot and Fox Gateway will forward them to the local Claude Code worker.

Each Feishu chat keeps a continuous Claude Code conversation context for that chat. Follow-up messages in the same chat reuse the previous Claude session.

To reset the chat context and start a fresh conversation, send either command in Feishu:

/clear
/new

Both commands clear the current chat's stored Claude session. The next message in that chat starts a new context from scratch.

Notes

• Local config lives in ~/.fox-gateway/fox-gateway.json
• Pairing state lives in ~/.fox-gateway/data/fox-gateway.db
• Runtime logs are written under ~/.fox-gateway/logs/
• The gateway currently uses Feishu websocket connection delivery mode
• The worker currently runs Claude Code only