francize

agents-to-im

Manage the Feishu/Lark bridge daemon for Claude Code and Codex. Use for: setup guidance, start/stop/status/logs/doctor, checking bridge health, or explaining how to configure the Feishu bot. This skill is Feishu/Lark-only.

francize 137 4 Updated 2mo ago

Resources

14
GitHub

Install

npx skillscat add francize/agents-to-im

Install via the SkillsCat registry.

SKILL.md

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:

  • setup
  • start
  • stop
  • status
  • logs
  • doctor

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.

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
    • CTI_CLAUDE_DEFAULT_MODEL
    • CTI_CODEX_DEFAULT_MODEL
    • CTI_CLAUDE_CODE_EXECUTABLE
    • CTI_CODEX_API_KEY
    • CTI_CODEX_BASE_URL
    • CTI_AUTO_APPROVE
  4. Remind the user to enable Feishu long connection events:
    • im.message.receive_v1
    • card.action.trigger
  5. 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:

  • 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.

Categories