Larkin

Quick start · Requirements · What it does · Installation · Usage · Setup and configuration · Details · Development

Larkin is a local Runtime Host that connects Codex, Claude Code, and Pi agent runtimes to Feishu (Lark). It keeps sessions, reminders, interactive messages, and a local dashboard close to the machine that runs them.

Requirements

• A supported macOS, Linux, or Windows (x64) system
• Official @larksuite/cli >= 1.0.80 (lark-cli) (Larkin product policy)
• At least one supported agent runtime and its authentication
• Bun 1.3.14 when running the npm package or building from source (standalone binaries bundle their own runtime)

Quick start

npx larkin@latest setup
npx larkin@latest start
npx larkin@latest status

What it does

**Runtime host** Connect supported coding-agent runtimes to Feishu from one local process.	**Persistent workflow** Keep sessions and reminders available across runs.
**Message surfaces** Work with Feishu messages, interactive cards, and related automation.	**Local visibility** Inspect the host through the embedded dashboard and OpenTelemetry traces.

The rest of this document uses the short `larkin` form; it works as-is after `npm install -g larkin`, or prefix any command with `npx larkin@latest` to run it without installing.

Installation

Prefer npm:

# Run the latest version directly with npx — no in