This project provides a lightweight, CLI-only bridge enabling interaction with AI coding agents like Claude Code and Codex from IM platforms (Telegram, Discord, Feishu/Lark). It targets developers and power users seeking seamless AI coding assistance within familiar chat environments, facilitating code interaction and tool execution with granular control.

How It Works

A background Node.js daemon connects IM bots to Claude Code or Codex via SDKs, forwarding messages and relaying AI responses, including tool usage and streaming output. Its novel approach lies in the permission-gateway, which intercepts tool calls, presenting inline approval buttons in chat for explicit user consent before execution. This ensures secure and controlled AI-driven code manipulation.

Quick Start & Requirements

• Installation: Recommended: npx skills add op7418/Claude-to-IM-skill. Alternative: git clone. Specific scripts for Codex integration are available.
• Prerequisites: Node.js >= 20. Claude Code CLI (authenticated) or Codex CLI (npm install -g @openai/codex, authenticated).
• Setup: Interactive wizard (/claude-to-im setup in Claude Code/Codex) guides through IM platform selection, token entry, and default configuration. Tokens are validated in real-time.
• Links: No external docs; commands like /claude-to-im setup and /claude-to-im doctor are provided.

Highlighted Details

• Supports Telegram, Discord, and Feishu/Lark integrations.
• Interactive setup wizard simplifies configuration.
• Explicit permission controls for AI tool usage via inline chat buttons.
• Streaming previews of AI responses (Telegram & Discord).
• Session persistence across daemon restarts.
• Secure credential storage (chmod 600) and log redaction.

Maintenance & Community

The README does not detail specific contributors, sponsorships, or community channels.

Licensing & Compatibility

Released under the MIT License, generally permissive for commercial use and distribution.

Limitations & Caveats

Presented as a lightweight, CLI-only alternative to a desktop GUI. Specific limitations like alpha status or known bugs are not detailed. Tool execution requires user approval within a 5-minute timeout.