# CCCBot

> Autonomous AI agent built on Claude Code Channels — scheduled tasks, heartbeat monitoring, auto-recovery, and persona config for Telegram & Discord

- **URL**: https://www.freshcrate.ai/projects/CCCBot
- **Author**: lucianlamp
- **Category**: MCP Servers
- **Latest version**: `v0.2.2` (2026-03-30)
- **License**: MIT
- **Source**: https://github.com/lucianlamp/CCCBot
- **Homepage**: https://x.com/lucianlamp/status/2036089908071461298
- **Language**: Shell
- **GitHub**: 17 stars, 2 forks
- **Registry**: github
- **Tags**: `ai-agent`, `anthropic`, `autonomous-agent`, `chatbot`, `claude`, `claude-code`, `discord-bot`, `mcp`, `shell`

## Description

Autonomous AI agent built on Claude Code Channels — scheduled tasks, heartbeat monitoring, auto-recovery, and persona config for Telegram & Discord

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.2.2` | 2026-03-30 | Medium | ## Fixes  - **Heartbeat fails with custom workspace** — Fixed relative paths in heartbeat skill that caused `HEARTBEAT.md` and `check.sh` not found errors when workspace was set to a directory outside `~/.cccbot` (#2) - **Channel-aware MCP checks** — Heartbeat now reads `cccbot.json` to determine which channels are enabled, skipping MCP checks for unconfigured channels (e.g., no Telegram check when only Discord is active) - **install.bat version detection** — Fixed `for /f` nested quote parsing |
| `v0.2.1` | 2026-03-29 | Medium | ## Changes  ### Removed - Session restart feature (`ccc-restart` skill, `restart-session.sh`, `restart-session.bat`) — removed for stability - Heartbeat MCP auto-recovery logic — removed in prior commit  ## Install / Update  ```bash curl -fsSL https://raw.githubusercontent.com/lucianlamp/CCCBot/master/scripts/install.sh \| bash ```  Or re-run the installer to update. |
| `v0.2.0` | 2026-03-25 | Medium | ## What's New  - **`cccbot` command** — Global CLI launcher automatically added to PATH during install   - `cccbot` — Start the bot   - `cccbot update` — Update to latest version   - `cccbot update v0.1.8` — Update to specific version - No more navigating to `~/.cccbot/` or memorizing install one-liners - **Fix:** start.bat multi-line PowerShell command breaking on Windows - **Simplified post-install:** Boot sequence runs automatically — just confirm the greeting message arrives  ## Supported Pl |
| `v0.1.8` | 2026-03-25 | Medium | ## What's New  - **Interactive channel selection** — Installer now asks which messaging channel to use (Telegram / Discord / Both) - Channel choice is saved to `cccbot.json` — no more hardcoded defaults - On update, existing `cccbot.json` is preserved (channel prompt is skipped) - GitHub issue templates added (bug report, feature request, question)  ## Install / Update  ```bash curl -fsSL https://raw.githubusercontent.com/lucianlamp/CCCBot/master/scripts/install.sh \| bash ``` |
| `v0.1.7` | 2026-03-25 | Medium | ## New Features  - **`cccbot.json` user configuration** — Channels and workspace settings are now configured via `~/.cccbot/cccbot.json` instead of hardcoding in `start.sh`. Survives reinstalls. - **Default workspace directory** — Set `"workspace": "~/projects/my-app"` to tell Claude where to work. Supports relative paths, tilde expansion, and absolute paths. External paths are automatically added to `additionalDirectories`. - **SessionStart context injection** — Workspace path is injected into |
| `v0.1.6` | 2026-03-24 | Medium | ## Fixes  - **Preserve start.sh/start.bat on reinstall** — Re-running the installer no longer overwrites user channel configuration (e.g. Discord → Telegram reset) (Closes #1) |
| `v0.1.5` | 2026-03-24 | Medium | - WSL support for session restart (`restart-session.sh` auto-detects WSL and opens a new terminal window) - Heartbeat and restart skills updated with WSL-aware OS detection |
| `v0.1.4` | 2026-03-24 | Medium | - Default SOUL updated to warm, personal assistant persona - Supports English and Japanese |
| `v0.1.3` | 2026-03-24 | Medium | - Session restart via Telegram (`ccc-restart` skill) - wmic-based process spawning (outside process tree) - Silent MCP health checks (no test messages sent) - HEARTBEAT_OK console-only (not sent to channels) - Boot greeting on both startup and resume - PID-based session management |
| `v0.1.1` | 2026-03-24 | Medium | ## What's Changed  Code review fixes + boot performance improvement.  ### Security - **PID validation before kill** — restart scripts verify the process is a CCC session before killing - **Version format validation** — installers reject malicious version strings - **Double-launch guard** — launchers detect and block concurrent sessions  ### Cross-Platform - **macOS `sed -i` fix** — installer uses portable sed pattern - **Process group kill replaced** — `pkill -P` for reliability across environme |

## Dependency audit

- **Score**: 100/100
- **Total deps**: 0
- **Resolved**: 0
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 0
- **Scanned**: 2026-04-27

## Citation

- HTML: https://www.freshcrate.ai/projects/CCCBot
- Markdown: https://www.freshcrate.ai/projects/CCCBot.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/CCCBot/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._