🌐 kronus.tech

Kronus

Open-source AI agent system built on Claude Code.

Build personal AI tools, run them from your phone, remember everything across projects.

---

v1.1 — Stability Update

Fixed message queuing (queued messages now process correctly instead of getting stuck), image/PDF sending from Claude to Telegram, install script failures on macOS (grep -P, broken persona file), and silent access.json ID mismatches. Daemon now logs errors instead of swallowing them, and warns when Telegram polling goes stale. Updated setup docs with BotFather privacy mode instructions, manual project registration guide, and expanded troubleshooting. If you installed v1.0, pull the latest and re-run ./scripts/install.sh.

What is Kronus?

Kronus turns Claude Code into a complete AI system you can run from anywhere. It adds three things Claude Code doesn't have out of the box: mobile access (via Telegram), persistent memory (a knowledge graph that spans sessions and projects), and a team of specialized agents that handle different types of work.

You describe what you want built. Claude builds it. Kronus remembers the decisions, learns your preferences, and picks up where you left off — from your terminal or your phone.

Anyone with a Claude plan can use it. No infrastructure to manage. Everything runs on your machine.

Architecture

┌──────────────────────────────────────────────────────────┐
│                    You                                    │
│          Terminal  ·  Telegram  ·  Dashboard               │
└─────────┬──────────────┬──────────────┬──────────────────┘
          │              │              │
┌─────────▼──────────────▼──────────────▼──────────────────┐
│                     Daemon                                │
│  Telegram bot · Session manager · Permission system       │
│  Message routing · Scope guard · Usage tracking           │
└─────────┬────────────────────────────────────────────────┘
          │ spawns per-project sessions
┌─────────▼────────────────────────────────────────────────┐
│              Claude Code Sessions                         │
│  One session per project · Resumes across restarts        │
│  Full tool access · Headless (stream-json I/O)            │
└─────────┬──────────────┬──────────────┬──────────────────┘
          │              │              │
┌─────────▼──┐  ┌───────▼─────┐  ┌────▼───────────────────┐
│   Agents   │  │   Skills    │  │     MCP Servers         │
│ 10 special-│  │ 19 quick    │  │ GitHub · Playwright     │
│ ized agents│  │ workflows   │  │ Brave · Notion · Slack  │
│ for complex│  │ for common  │  │ Linear · Memory · Brain │
│ multi-turn │  │ single-pass │  │ Context7 · Filesystem   │
│ tasks      │  │ tasks       │  │                         │
└────────────┘  └─────────────┘  └─────────────────────────┘
          │
┌─────────▼────────────────────────────────────────────────┐
│                     Brain                                 │
│  SQLite knowledge graph · D3 visualization                │
│  Auto-indexes notes · Cross-project search                │
│  14 MCP tools · Backlinks · Health scoring                │
└──────────────────────────────────────────────────────────┘

How it works

The daemon is a Bun process that runs a Telegram bot and manages Claude Code sessions. Each Telegram group maps to a project directory. When you send a message, the daemon routes it to the right Claude session, which runs in headless mode with --output-format stream-json. Responses stream back to Telegram.

Agents handle complex multi-turn work (code review, security audits, architecture planning). Skills handle quick single-pass workflows (test generation, standup updates, dependency checks). Both are defined as markdown files with YAML frontmatter — adding a new agent is creating a .md file.

The brain is a SQLite-backed knowledge graph that indexes your notes, extracts entities and relationships, and serves them via MCP tools. A D3-powered UI lets you visualize how your knowledge connects.

MCP servers connect external tools — GitHub for PRs, Playwright for browser automation, Brave for web search, Notion/Slack/Linear for team workflows.

Components

Component	What it does	Tech
Daemon	Telegram routing, session management, permissions, usage tracking	Bun, grammy, stream-json
Brain	Knowledge graph indexer, search, MCP server, visualization	SQLite, D3.js, Bun
Dashboard	Web UI for sessions, usage, knowledge graph, project overview	React, Vite, Tailwind
Agents	10 specialized AI agents (planner, code-reviewer, security-auditor, etc.)	Markdown + YAML frontmatter
Skills	19 quick workflows (/test-gen, /standup, /review, /audit, etc.)	Markdown + YAML frontmatter
Hub	App marketplace server — auth, billing, WebSocket relay	Express, PostgreSQL, Redis, Stripe
Connect	SDK for Hub connections — identity, app management	TypeScript, Ed25519

Quick Start

git clone https://github.com/kronus-tech/kronus.git
cd kronus && ./scripts/install.sh

The installer asks 5 questions (name, profession, how you work, your notes, your priority) and configures everything. Takes about 10 minutes.

Requirements: git, Bun, Claude Code (needs an Anthropic API key or Claude plan)

Full setup guide ->

Building Your Own Agents

Creating an agent is writing a markdown file. Drop it in .claude/agents/ and it's available immediately:

---
name: my-agent
description: Does something useful
model: sonnet
tools: Read, Write, Glob, Grep
---

You are an agent that does something useful.

## Instructions
1. Read the relevant files
2. Analyze them
3. Produce the output

Skills work the same way in .claude/skills/. No compilation, no deployment, no framework to learn. The markdown IS the agent.

Developer guide ->

Using from Your Phone

Once the daemon is running, any Telegram group becomes a project workspace:

# Start the daemon
~/.claude/daemon/scripts/kronus-daemon.sh start

# In Telegram: add your bot to a group, then:
/setup /path/to/project

Messages in the group go to Claude. Files you send get downloaded and placed in the project. Photos get analyzed. Claude can send files back. The full power of Claude Code, from a chat interface.

Telegram setup ->

Documentation

Resource	Link
Website	kronus.tech
Full docs	kronus-tech/docs
Setup guide	docs/SETUP.md
Developer guide	docs/DEVELOPER-GUIDE.md
API reference	docs/API-REFERENCE.md
Security	docs/SECURITY.md
Agent reference	docs/AGENT_REFERENCE.md
Daemon repo	kronus-tech/daemon

Directory Structure

.claude/
  agents/          # 10 specialized agents (markdown files)
  skills/          # 19 quick workflow skills (markdown dirs)
  rules/           # Coding standards, security rules, testing rules
  teams/           # Team configurations for parallel agent swarms
  mcp.json         # MCP server configuration
brain/             # Knowledge graph — indexer, MCP server, UI
dashboard/         # React web UI — sessions, usage, graph
hub/               # Marketplace server — auth, billing, relay
connect/           # SDK for Hub connections
daemon/            # Reference copy of the daemon (source: kronus-tech/daemon)
scripts/           # Install, init, publish scripts
config/            # Example configs (.env, projects.json, access.json)
templates/         # Profession-specific starter templates
docs/              # Guides, references, troubleshooting

License

MIT. Use it however you want.

---

kronus.tech · GitHub · Docs