Insomnia

Autonomous AI agents that never sleep. They work while you don't.

Overview

Insomnia is a system of tireless AI agents that operate autonomously via Telegram, building your projects around the clock without human intervention.

1. Telegram Bridge - Command your agents via Telegram. They respond, they execute, they deliver.
2. Orchestrator - Worker agents implement. Manager agents review. Skills compound. Progress is relentless.

Send a message. Walk away. Come back to shipped code.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                      Telegram Bridge                        │
│  ┌──────────┐    ┌───────────┐    ┌──────────────────────┐ │
│  │ Responder│───►│  Manager  │───►│ Claude CLI (Opus)    │ │
│  │ (Haiku)  │    │  Registry │    │ Long-running agents  │ │
│  └──────────┘    └───────────┘    └──────────────────────┘ │
│       │                                      │              │
│       ▼                                      ▼              │
│  Quick ACK                           Full responses via    │
│  via Telegram                            Telegram           │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                       Orchestrator                          │
│  ┌──────────┐    ┌──────────┐    ┌────────────────────────┐│
│  │  Worker  │───►│ Manager  │───►│ Skills (learned        ││
│  │ (Opus)   │    │ (Opus)   │    │ patterns)              ││
│  └──────────┘    └──────────┘    └────────────────────────┘│
│       │                │                                    │
│       ▼                ▼                                    │
│  Implements        Reviews work,                           │
│  tasks, runs       generates skills                        │
│  tests                                                      │
└─────────────────────────────────────────────────────────────┘

Quick Start

Prerequisites

• Node.js 18+
• Claude CLI installed and authenticated
• A Telegram account and bot token (from @BotFather)

Installation

# Clone the repository
git clone https://github.com/AlexanderLiteplo/insomnia.git
cd insomnia

# Run the setup wizard
./setup.sh

# Or manually:
cd bridge
npm install
npm run build
npm run setup  # Interactive Telegram setup

Running the Bridge

cd bridge
npm start

Running the Dashboard

cd bridge/dashboard
npm install
npm run dev
# Open http://localhost:3333

Running the Orchestrator

cd orchestrator

# Create your project tasks
cp prds/tasks.example.json prds/tasks.json
# Edit prds/tasks.json with your project

# Start the orchestrator
./scripts/orchestrator.sh start

Components

Bridge (/bridge)

The Telegram bridge receives messages from your Telegram bot and routes them to specialized Claude agents.

• Responder (Haiku) - Fast classifier that routes messages
• Managers (Opus) - Long-running agents that handle specific topics
• Dashboard - Real-time monitoring UI

See bridge documentation for details.

Orchestrator (/orchestrator)

The worker/manager system that autonomously builds projects.

• Worker - Implements tasks, runs tests
• Manager - Reviews work, approves or requests changes
• Skills - Learned patterns saved for future use

See orchestrator documentation for details.

Configuration

Bridge Config (bridge/config.json)

{
  "telegramBotToken": "your-bot-token-from-botfather",
  "telegramAllowedUserIds": [123456789],
  "claudeWorkDir": "~/Documents/claude-work",
  "pollInterval": 2000
}

Environment Variables

Variable	Description
ORCHESTRATOR_DIR	Path to orchestrator directory
BRIDGE_DIR	Path to bridge directory

Documentation

• Setup Guide - Detailed installation instructions
• Architecture - System design and components

License

MIT - See LICENSE for details.

Contributing

See CONTRIBUTING.md for guidelines.