Mobile Shrimp: WeChat/Feishu Control PC using LLM

Mobile Shrimp contains two local messaging-bot adapters that bridge mobile chat messages to local AI coding agents.

Projects

Directory	Purpose
llm-wechat-cli/	WeChat iLink bot powered by cc-connect, Codex, or a local DeepSeek shim.
lark-cli/	Feishu IM listener powered by lark-cli, Codex, or DeepSeek.

Repository Policy

This repository must not contain real API keys, bot tokens, chat ids, user ids, or local auth files. Checked-in configuration should use placeholders such as:

<OPENAI_API_KEY>
<DEEPSEEK_API_KEY>
<WEIXIN_BOT_TOKEN>
<WEIXIN_ACCOUNT_ID>
<FEISHU_CHAT_ID>
<FEISHU_USER_OPEN_ID>

Provide real values at runtime with environment variables or local credential stores that are excluded from version control.

Quick Start

For WeChat:

cd llm-wechat-cli
export WEIXIN_BOT_TOKEN="<real weixin bot token>"
export WEIXIN_ACCOUNT_ID="<real weixin account id>"
export OPENAI_API_KEY="<real OpenAI API key>"
./start.sh codex

For Feishu:

cd lark-cli
export FEISHU_CHAT_ID="<feishu chat id>"
export FEISHU_USER_OPEN_ID="<feishu user open id>"
./run-feishu-bot.sh codex

DeepSeek mode is also supported by both subprojects. See the subproject README files for the required environment variables and startup commands.

Documentation

• WeChat Codex/DeepSeek Bot
• Feishu CLI Bot Listener

Upstream Links

• Lark/Feishu CLI
• OpenAI Codex CLI
• cc-connect
• DeepSeek TUI

Runtime Data

Both subprojects write local state during operation. Treat these paths as machine-local runtime data:

• llm-wechat-cli/config.toml
• llm-wechat-cli/data/
• lark-cli/.event-bot.lock

These files can contain credentials, session ids, message history, or local machine paths after a real run.