kyberbot@agent
00:00:00
_

Your Personal Agent System. Powered by Claude Code.

KyberBot is an open-source personal AI agent that runs on top of Claude Code. It adds what Claude Code is missing — persistent memory, self-evolving identity, scheduled routines, and messaging channels — so your agent remembers everything, grows over time, and works for you 24/7.

COST: $0 EXTRA|SETUP: 5 MIN|DATA: LOCAL-FIRST
// WHAT_IS_KYBERBOT

Claude Code is already an exceptional AI agent. It just lacks persistence.

Claude Code can read and write files, execute shell commands, manage git repos, spawn sub-agents, connect to MCP servers, load skills, and reason through complex multi-step tasks. But when the session ends, everything is forgotten. No memory. No identity. No schedule.

KyberBot adds exactly those things — nothing more. A persistent brain (Kybernesis Local), living documents that the agent updates itself (SOUL.md, USER.md, HEARTBEAT.md), a heartbeat scheduler for autonomous routines, messaging channels (Telegram, WhatsApp), and skill auto-generation. All running on your existing Claude Code subscription at zero extra cost.

// CORE_FEATURES

Everything your agent needs

Six capabilities that turn Claude Code into a personal AI agent that knows you, grows with you, and works for you around the clock.

SELF_EVOLVING_IDENTITY

Your agent grows with every conversation

SOUL.md defines personality, tone, and values. USER.md accumulates what the agent learns about you — preferences, projects, people you mention. Both are living documents the agent updates autonomously. Day 1 is good. Day 30 is tailored to you in ways you didn't plan for.

SOUL.md
USER.md
identity.yaml
PERSISTENT_BRAIN

Kybernesis Local

Semantic search, entity graph, fact store with source confidence, and a reasoning engine that derives insights from what it knows. The sleep agent continuously maintains, links, and reasons about memories.

ORCHESTRATION

AI company

Organize agents into a company with a CEO, workers, goals, and a kanban board. Humans only intervene when agents hit blockers.

MESSAGING_CHANNELS

Talk to your agent from anywhere

Telegram and WhatsApp bridges let you message your agent on the go. Owner-only verification keeps it private. Every message carries full agent context — personality, memory, skills. Messages are ingested into the brain so the agent remembers conversations across channels.

TelegramWhatsAppmore coming
SKILL_AUTO_GENERATION

The agent builds its own tools

Ask the agent to do something new and it generates a skill on the fly — a markdown file with frontmatter, instructions, and examples. Skills are human-readable, version-controllable, and loaded automatically on startup. You can also create skills manually with kyberbot skill create.

auto-generatedmarkdown-basedversion-controlled
CLAUDE_CODE_NATIVE

Zero extra cost

Runs on your Claude Code subscription. Inherits sub-agents, MCP servers, git, permissions — no custom framework needed.

sub-agentsMCPgitfile I/Opermissions
// HOW_IT_WORKS

Architecture at a glance

kyberbot@architecture
OVERVIEW
DATA_FLOW:
User / Channel / ScheduleOrchestratorLiving Docs(SOUL, USER, HEARTBEAT)Brain(Kybernesis Local)Sub-agentsSkillsChannels
COMPONENTS:
Claude CodeRuntime harness — sub-agents, MCP, tools, permissions
Living DocsSOUL.md + USER.md + HEARTBEAT.md (self-updating)
BrainKybernesis Local — semantic search, entity graph, fact store, reasoning engine
HeartbeatScheduler reads HEARTBEAT.md, fires Claude sessions on cadence
ChannelsTelegram + WhatsApp bridges with owner-only auth
SkillsMarkdown skill files, auto-generated on demand
Sleep AgentBackground: decay, facts, reasoning, profiles, contradictions, entity hygiene
// WHY_KYBERBOT

What makes this different

THE_CORE_IDEA

Built on Claude Code, not from scratch

Most personal AI agent projects build a custom framework, wrap an LLM API, manage tokens, and deploy a server. KyberBot takes a different approach — Claude Code is already an exceptional agent. It can read and write files, execute commands, spawn sub-agents, connect to MCP servers, and reason through complex tasks. It just lacks persistence. KyberBot adds exactly that. Nothing more.

sub-agents
MCP servers
skills
permissions
git
file I/O
SUBSCRIPTION_MODEL
$0

extra cost

Runs on your Claude Code subscription. No API tokens, no per-message fees. 1,000 messages a day costs the same as one.

LOCAL_FIRST

Your data is yours

All data lives on your machine. Kybernesis Local handles storage, search, and memory. Nothing leaves unless you opt into cloud sync. MIT licensed.

SELF_EVOLUTION

Self-evolving, not configured

Most frameworks require you to define behavior upfront and edit config files when things change. KyberBot flips this — you have a conversation and it adapts.

TRADITIONAL
KYBERBOT
Edit system prompt
Agent evolves SOUL.md
Write JSON config
Agent updates USER.md
Set up cron jobs
Agent manages HEARTBEAT.md
Code new tools
Agent generates skills
Manually clean data
Sleep agent maintains memory
Deploy new version
Changes happen in real-time
PHILOSOPHY

Three beliefs

01

Your AI should know you

Not just in this conversation, but always. Memory is not a feature — it is the foundation.

02

Your AI should grow

Static configurations are a snapshot. Living documents the agent updates are a trajectory.

03

Your data is yours

Local-first. No data leaves your machine unless you choose to sync it. No vendor lock-in.

QUICK_SETUP

2-minute onboard

Clone, install, run the onboard wizard. It creates your agent's identity, personality, user profile, and schedules. No API keys. No servers.

$ kyberbot onboard
✓ Agent ready
// QUICK_START

Up and running in 2 minutes

1
Download & Install30 SECONDS

Download the KyberBot Desktop app for macOS. Drag to Applications. Double-click to open. That's it — no terminal, no git, no npm.

DOWNLOAD_FOR_MACOS
2
Create your agent90 SECONDS
// KYBERBOT
STEP 2 OF 10
Agent Identity
Atlas
My personal AI agent
Ian
America/New_Yorkauto-detected
3
Start talkingDONE
// ATLAS
Dashboard
Chat
Brain
A
Atlas
OPUS
YOU
What can you help me with?
ATLAS
I'm your personal AI agent. I can remember things across conversations, run tasks on a schedule, manage your projects, and learn your preferences over time. I'll get better the more we talk.
Message Atlas...
SEND
// DESKTOP_APP

See everything. Control everything.

No terminal required. The KyberBot Desktop app gives you a visual command center for your entire agent fleet — install once, manage everything.

// ATLAS
CLIAPP
Dashboard
Chat
Brain
Skills
Channels
Heartbeat
Bus
Atlasrunning
Infrastructure
HeartbeatTelegramSleep
Novarunning
Marketing
HeartbeatWhatsApp
Claudiorunning
Development
HeartbeatTelegram
AGENTS
3
UPTIME
4h 22m
MEMORIES
1,247
ENTITIES
89
NO_TERMINAL

Point-and-click control

Start, stop, and monitor agents without typing a single command. Perfect for non-technical users.

REAL_TIME

Watch your agent think

See tool calls, memory updates, and reasoning in real-time as your agent works through tasks.

VISUAL_MEMORY

Explore what it knows

Browse the entity graph, search memories, view timeline events, and edit living documents — all visually.

Requires Docker Desktop • The app guides you through the rest

// MULTI_AGENT

Build your own AI team

Run multiple agents, each with their own personality, memory, and expertise. They share a process, coordinate autonomously, and scale effortlessly.

YOUR_FLEET
Each agent runs independently with its own brain
A
Atlas
Infrastructure & Security

Monitors services, runs security audits, handles incident response

RUNNING|2,431 memories
N
Nova
Marketing & Content

Writes blog posts, manages social media, tracks analytics

RUNNING|1,847 memories
C
Claudio
Development & Code

Reviews PRs, writes tests, deploys to production

RUNNING|3,102 memories
Fleet Mode
All agents share one process — ~2MB per agent instead of ~300MB
~2MB
per agent
1 cmd
to start all
// AGENT_COMMUNICATION

Your agents talk to each other

When one agent needs expertise, a second opinion, or wants to delegate a task, it reaches out to another agent automatically. No configuration needed.

A
Atlas
INFRASTRUCTURE
Detects a deployment issue and automatically asks Nova to pause the scheduled blog post...
hold the deploy
AGENT_BUS
post paused
N
Nova
MARKETING
...receives the alert, pauses the scheduled post, and confirms. All without human intervention.
USE_CASES

Agents collaborate so you don't have to coordinate

Delegation
Your research agent finds something technical and hands it off to your developer agent.
Second opinions
Before a big deployment, your infra agent asks your security agent to review.
Status updates
Your marketing agent broadcasts a new blog post so other agents know about it.
Cross-domain knowledge
Your sales agent asks your product agent what features shipped this week.
BUILT_IN_SAFETY

Smart guardrails

Rate limiting prevents runaway conversations. Loop detection stops circular queries. Every message is logged for full transparency.

rate limitsloop preventionfull historytopic filters
// ORCHESTRATION

Run your agents like a company

A CEO agent drives strategy and assigns work. Workers execute tasks autonomously. You only step in when an agent hits a blocker and escalates to your inbox.

ORG_CHART
Kitt
CEO
Setting Q2 goals, reviewing KPIs, assigning sprint work
A
Atlas
ENGINEER
Implementing auth flow
IN_PROGRESS
N
Nova
CMO
Drafting launch post
IN_REVIEW
3 AGENTS7 ACTIVE TASKS2 GOALS TRACKED
TASK_BOARD
TODO
KYB-12
Add rate limiting
Atlas
IN PROGRESS
KYB-9
Auth flow v2
Atlas
KYB-11
Landing page copy
Nova
IN REVIEW
KYB-8
Launch blog post
Nova
DONE
KYB-6
CI pipeline
Atlas
KYB-7
Brand guidelines
Nova
GOALS_&_KPIS

Measurable objectives

Set company-level goals and track KPIs. The CEO agent breaks objectives into tasks, assigns them to workers, and reports progress.

HUMAN_INBOX

Intervene when needed

Agents escalate blockers to your inbox. You review, decide, and respond on your own schedule. No babysitting required.

LIVE_OBSERVABILITY

Watch it happen

Stream agent execution in real-time. Session logs, task transitions, and inter-agent messages — full transparency into what your company is doing.

// GET_STARTED

Build your personal AI agent today

KyberBot is open source, free to use, and built on top of Claude Code. Read the docs, clone the repo, and have your agent running in minutes.

Open source • MIT License • Local-first • Zero extra cost