abyss v2026.03.25
Features Skills GitHub
Open Source · MIT License

Your personal AI,
right in Telegram

abyss is a local-first, multi-bot AI assistant
powered by Claude Code.

No servers. No databases. No LLM API Key.
Just your Mac, Telegram, and Claude Subscription.

Copied! $ curl -sSL https://raw.githubusercontent.com/heg-wtf/abyss/main/install.sh | bash
Telegram
💬 Chat
📎 Files
📷 Photos
⟷
abyss
🤖 Multi-Bot Manager
📁 File-Based Sessions
🧩 Skill System
⏰ Cron Automation
💓 Heartbeat
👥 Group Collaboration
Claude Code (SDK Pool)
Persistent Sessions
│
Abysscope Dashboard
🖥 Web UI (port 3847)

Built for power users

Everything runs locally. No cloud dependency.

🏠

Local First

No server, no SSL, no public IP needed. Long Polling over Telegram. Your data stays on your Mac.

🤖

Multi-Bot System

Run multiple specialized bots simultaneously. Each with its own personality, skills, model, and memory.

🧩

Skill Plugins

18+ built-in skills. Create custom ones with markdown or integrate MCP servers, CLIs, and browser tools.

⏰

Cron Automation

Schedule recurring tasks with natural language. Morning briefings, daily reports, periodic checks.

👥

Group Collaboration

Multiple bots collaborate in Telegram groups with shared conversation context and workspace.

🖥

Abysscope Dashboard

Web UI with cron editor, skill CRUD, session/conversation management, markdown memory viewer, and log tools.

⚡

SDK Client Pool

Persistent Claude sessions via Python Agent SDK. Fast responses with session reuse, no cold starts.

💓

Heartbeat

Periodic situation awareness. Bots proactively check tasks, reminders, and deliver updates autonomously.

📁

File-Based Architecture

No database. Sessions are directories. Conversations are markdown. Everything is inspectable and portable.

18+ Built-in Skills

Install with abyss skills install <name>

💬 iMessage ⏰ Reminders 🗺 Naver Map 🖼 Image Processing 💰 Best Price 🗄 Supabase 📧 Gmail 📅 Google Calendar 🐦 Twitter / X 📋 Jira 🔍 Naver Search 📍 Kakao Local 📊 DART Disclosure 🌐 Translate 🏪 Daiso 🧠 QMD Knowledge 📦 GitHub Skill Import

CLI First

Everything from onboarding to deployment, in the terminal. 

# Setup
$ abyss init
$ abyss bot add

# Run
$ abyss start --daemon
$ abyss status

# Skills
$ abyss skills install supabase
$ abyss skills install reminders

# Automation
$ abyss cron add my-bot
$ abyss heartbeat enable my-bot

# Dashboard
$ abyss dashboard start --daemon

What's New

v2026.03.25 Bot Isolation — Each bot's CLAUDE.md now explicitly ignores parent configs (~/.claude/CLAUDE.md). Fixed dashboard PID OverflowError crash.
v2026.03.21 Abysscope v2 — Cron editor (recurring/one-shot), custom skill CRUD, session & conversation delete, markdown memory viewer, /skills bot-scoped view.
v2026.03.20 Cron Edit — Edit cron job messages via CLI (abyss cron edit with $EDITOR) or Telegram (/cron edit with ForceReply). Expanded cron list preview to 80 chars.
v2026.03.18 GitHub Skill Import — Import skills directly from GitHub repos via CLI (abyss skills import) or Telegram (/skills import). Compatible with skills.sh packages.
v2026.03.16 SDK Client Pool — Persistent Claude sessions via Python Agent SDK. Removed Node.js bridge dependency.
v2026.03.14 Group Collaboration — Multi-bot group chat with shared conversations, workspace, and orchestrator routing.
v2026.03.12 Abysscope Dashboard — Web UI for managing bots, skills, cron, sessions, memory, and logs.
v2026.03.11 Dashboard CLI — Added start/stop/restart/status subcommands for Abysscope management.