lark-setup

Installs lark-cli and authenticates a Feishu/Lark account via OAuth.

3|2|Updated Jul 21, 2026
One-click install
npx skills add https://github.com/zlsbksdxl/codex-lark --skill lark-setup-zlsbksdxl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-setup
Source: https://github.com/zlsbksdxl/codex-lark/tree/main/plugins/feishu2codex/skills/lark-setup
Command: npx skills add https://github.com/zlsbksdxl/codex-lark --skill lark-setup-zlsbksdxl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @larksuite/cli.

What problem does it solve? After installing the feishu2codex plugin, none of the bundled Lark skills can run until the official lark-cli runtime is installed and a Feishu/Lark account is authenticated. This Skill walks through that one-time setup so the other 27 Lark skills become usable. ## Core Features & Use Cases - Runtime Installation: Detects a missing lark-cli binary and installs the pinned version 1.0.73 of @larksuite/cli via npm, with a clear stop condition when Node.js/npm is unavailable. - Guided OAuth Configuration: Initializes app configuration with lark-cli config init --new, supports least-privilege domain or scope authorization, and returns the verification URL plus QR code for browser/device sign-in. - Credential Safety & Verification: Never prints app secrets, tokens, or device codes, and confirms completion only after lark-cli auth status --json --verify reports a valid signed-in identity. - Use Case: A user installs feishu2codex and tries to read a Feishu doc, but the skill fails because lark-cli is missing. This Skill installs the runtime, runs OAuth, and verifies the account so the doc skill works immediately after. ## Quick Start Use the lark-setup skill to install lark-cli and connect my Feishu/Lark account.

Frequently Asked Questions about lark-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Feishu/Lark after installing feishu2codex?

Run the lark-setup skill, which checks for lark-cli, installs @larksuite/cli version 1.0.73 via npm if missing, initializes app configuration, and completes OAuth sign-in. Setup finishes only after auth status verification confirms a signed-in user.

How do I install lark-cli for Feishu/Lark CLI workflows?

Install it globally with npm using `npm install --global --no-audit --no-fund @larksuite/[email protected]`, then confirm with `lark-cli --version`. The setup skill requires exactly version 1.0.73 before continuing to authentication.

Why does a Lark skill fail saying lark-cli is missing or unauthenticated?

Bundled Lark skills depend on the official lark-cli runtime and a valid OAuth session. If the binary is absent or no account is signed in, run the setup workflow to install the runtime and complete browser or device authorization.

Can I set up lark-cli without Node.js or npm installed?

No. The runtime is distributed as an npm package, so Node.js and npm are required. If npm is unavailable, the setup stops before authentication and instructs you to install Node.js first.

Does the Feishu/Lark OAuth setup expose my app secrets or tokens?

No. The workflow explicitly never prints app secrets, access tokens, device codes, or stored credentials. It only returns the verification URL and QR code, then checks sign-in status through lark-cli auth status.