agents-to-im

name	agents-to-im
description	Manage the Feishu/Lark bridge daemon for Claude Code and Codex. Use for: CLI install guidance, setup guidance, start/stop/status/logs/doctor, checking bridge health, or explaining how to configure the Feishu bot. This skill is Feishu/Lark-only.
argument-hint	onboard | setup | start | stop | status | logs [N] | doctor | upgrade
allowed-tools	["Bash","Read","Write","Edit","Grep","Glob"]

Agents to IM Skill

You are managing the Feishu/Lark bridge daemon. User data is stored at ~/.agents-to-im/.

The skill directory is ~/.claude/skills/agents-to-im. If that path does not exist, find SKILL.md via glob and derive the root directory from it.

Commands

Map $ARGUMENTS to one of:

• onboard
• setup
• start
• stop
• status
• logs
• doctor
• upgrade

If no configuration exists at ~/.agents-to-im/config.env, show config.env.example and explain the required Feishu fields. Do not try to start the daemon without config.

CLI usage

Prefer the globally installed npm CLI:

• install once: npm install -g agents-to-im@beta
• agents-to-im onboard
• agents-to-im start
• agents-to-im restart
• agents-to-im status
• agents-to-im doctor
• agents-to-im upgrade
• agents-to-im logs 100

Use source checkout commands only for development/debugging.

Setup

This project no longer has a multi-platform setup wizard. Setup means:

1. Show config.env.example.
2. Explain the required fields:
   • CTI_FEISHU_APP_ID
   • CTI_FEISHU_APP_SECRET
   • CTI_DEFAULT_WORKDIR
3. Explain optional fields:
   • CTI_FEISHU_DOMAIN
   • CTI_FEISHU_ALLOWED_USERS
   • external CODEX_HOME override if the user stores Codex config outside ~/.codex
4. Point the user to references/setup-guides.md for the one-shot Feishu scopes import JSON.
5. Remind the user to enable Feishu long connection events:
   • im.message.receive_v1
   • card.action.trigger
6. Remind the user that private chat only accepts /new:claude and /new:codex, and real conversation happens in the auto-created group.

Runtime behavior

• Runtime is selected per session.
• /new:claude creates a Claude session.
• /new:codex creates a Codex session.
• /reset keeps the current group's runtime.

Execution

Use:

• agents-to-im onboard
• bash "SKILL_DIR/scripts/daemon.sh" start
• bash "SKILL_DIR/scripts/daemon.sh" stop
• bash "SKILL_DIR/scripts/daemon.sh" status
• bash "SKILL_DIR/scripts/daemon.sh" logs 50
• bash "SKILL_DIR/scripts/doctor.sh"

When showing logs or doctor output, summarize the important lines instead of dumping excessive raw output.