clibot

Category: Tools & Productivity | Uploader: keepmind9 | Downloads: 0 | Version: v1.0（Latest）

Bridge AI CLI tools (Claude Code, Gemini CLI, OpenCode, etc.) to IM platforms (Telegram, Discord, Feishu/Lark). Use when user wants to install, configure, or manage clibot service. Handles binary download, configuration generation, bot token setup, and service lifecycle. Ideal for users who want to interact with AI CLI tools through chat platforms.

Changelog: Source: GitHub https://github.com/keepmind9/clibot

Directory Structure

Current level: skills/clibot/

📁 lib/
- 📄 downloader.js 2.8 KB
- 📄 utils.js 5.6 KB
- 📄 validator.js 4.8 KB
📁 references/
- 📄 bot-setup.md 11.8 KB
- 📄 quickstart.md 6.6 KB
- 📄 troubleshooting.md 9.8 KB
📁 scripts/
- 📄 config.js 3.1 KB
- 📄 help.js 546 B
- 📄 install.js 5.0 KB
- 📄 logs.js 958 B
- 📄 service.js 6.4 KB
- 📄 setup.js 9.9 KB
- 📄 validate.js 1.3 KB
📄 cli.js 2.2 KB
📄 package.json 1.2 KB
📄 SKILL.md 2.8 KB

SKILL.md

---
name: clibot
description: Bridge AI CLI tools (Claude Code, Gemini CLI, OpenCode, etc.) to IM platforms (Telegram, Discord, Feishu/Lark). Use when user wants to install, configure, or manage clibot service. Handles binary download, configuration generation, bot token setup, and service lifecycle. Ideal for users who want to interact with AI CLI tools through chat platforms.
---

# Clibot Skill

## Overview

Clibot is a lightweight middleware that connects AI CLI tools (Claude Code, Gemini CLI, OpenCode, etc.) to IM platforms (Telegram, Discord, Feishu/Lark). This skill automates: binary installation, bot configuration, session setup, permission management, and service lifecycle.

Uses ACP mode (Claude Agent SDK via stdio) — no tmux required.

## Quick Start

```
/clibot setup
```

Wizard auto-detects OS/arch, downloads the correct binary if needed, then guides through:
1. Platform selection (Telegram/Discord/Feishu)
2. Bot token collection with inline instructions
3. Session configuration (defaults work for most users)
4. Permission setup (admins + optional whitelist)
5. Auto-starts the service when done

## Workflow Decision Tree

```
User request
    ↓
Is clibot installed?
    ├─ No → Auto-downloads binary first, then config wizard
    └─ Yes → Config wizard
            ↓
Has config.yaml?
    ├─ No → Generate config
    └─ Yes → Ask to overwrite or use existing
            ↓
Config valid? (auto-validated by /clibot validate)
    ├─ No → Show errors, guide fix
    └─ Yes → Start service
            ↓
Service running?
    ├─ No → /clibot start
    └─ Yes → /clibot status
```

## Commands

| Command | Description |
|---------|-------------|
| `/clibot setup` | Full wizard (installs binary if missing, generates config, starts service) |
| `/clibot install` | Download binary only |
| `/clibot config` | Generate/edit config.yaml |
| `/clibot validate` | Check config for errors |
| `/clibot start` | Start clibot daemon |
| `/clibot stop` | Stop clibot daemon |
| `/clibot restart` | Stop + start |
| `/clibot status` | Show PID, uptime, recent logs |
| `/clibot logs` | View logs (`-f` to follow) |

## Key Defaults

- **Install path**: `~/.local/bin/clibot` (no sudo required)
- **Config path**: `~/.clibot/config.yaml`
- **Log path**: `~/.clibot/logs/clibot.log`
- **CLI adapter**: `acp` (Claude Agent SDK, no tmux needed)
- **Session name**: `claude`, command: `claude`

## References

- `references/quickstart.md` — Common configuration examples and workflows
- `references/bot-setup.md` — Step-by-step bot creation guides (Telegram/Discord/Feishu)
- `references/troubleshooting.md` — Error diagnoses and solutions

## Permissions

This skill may invoke external tools (`npm`, `npm install`, `npm link`) during installation. Network access is required to download binaries from GitHub releases.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

clibot

Directory Structure

SKILL.md

Report

Notice