Alice

AI Local Interactive Cross-device Engine

Same AI session, anywhere. Terminal ↔ Feishu. No cloud lock-in.

Alice is a Feishu long-connection connector that turns CLI-based LLM agents into interactive bots inside Feishu. Works with OpenCode (DeepSeek V4), Codex, Claude, Gemini, Kimi.

The core idea

Your terminal agent and your Feishu bot are the same session. Start a refactor in your IDE, check progress from your phone, send the next instruction via Feishu. Alice bridges your local CLI agent to Feishu's WebSocket so you're never locked to one device.

What problem does Alice solve?

You have an LLM agent CLI installed — and it works great in your terminal. But:

  • Connects to Feishu's WebSocket for real-time message delivery
  • Routes incoming messages into chat (casual) or work (task-oriented) scenes
  • Calls your configured LLM CLI backend with the right prompt, model, and permissions
  • Sends progress updates, final replies, files, and images back to Feishu
  • Exposes a local HTTP API for bundled skills and automation tasks

Key Features

  • Multi-bot: One alice process, one config.yaml, multiple independent bots
  • Scene routing: Separate chat and work modes with per-scene LLM profiles
  • Six backends: OpenCode, Codex, Claude, Gemini, Kimi — switch per scene
  • Session persistence: Resumable threads, session aliases, usage counters
  • Live status cards: Real-time heartbeat showing backend activity and file changes
  • Automation: Cron-like scheduled tasks with send_text, run_llm, and run_workflow actions
  • Bundled skills: Extendable skill scripts that call the runtime API
  • Subprocess delegation: alice delegate lets OpenCode agents send subtasks to other backends
  • Zero cloud dependency: Everything runs on your machine

Who is Alice for?

  • Teams using Feishu that want LLM agent access without building custom integrations
  • Developers who already use CLI agents and want them accessible in group chats
  • Operators who need scheduled automation along with interactive LLM capabilities
SectionFor
TutorialsNew users — get Alice running in 5 minutes
How-To GuidesTask-focused recipes for specific goals
ExplanationDeep dives into concepts and design
ReferenceComprehensive config, API, and CLI docs
DevelopmentContributor-oriented architecture and guides

Quick Start

npm install -g @alice_space/alice
alice setup
# edit ~/.alice/config.yaml with your Feishu credentials
alice --feishu-websocket

See the Quick Start tutorial for detailed steps.

中文版 · GitHub