KYBERNESIS
KYBERBOT
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
GET_STARTEDVIEW_DOCSGITHUB
// 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 vector search, entity graph, and timeline — all local. The sleep agent runs every hour to tag, link, tier, and summarize memories automatically.

HEARTBEAT_SCHEDULER

Autonomous routines

Define recurring tasks in natural language via HEARTBEAT.md. The agent proposes new tasks as it learns your routine.

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 / Schedule→Orchestrator→Living Docs(SOUL, USER, HEARTBEAT)→Brain(Kybernesis Local)→Sub-agents→Skills→Channels
COMPONENTS:
Claude Code—Runtime harness — sub-agents, MCP, tools, permissions
Living Docs—SOUL.md + USER.md + HEARTBEAT.md (self-updating)
Brain—Kybernesis Local — semantic search, entity graph, timeline + sleep agent
Heartbeat—Scheduler reads HEARTBEAT.md, fires Claude sessions on cadence
Channels—Telegram + WhatsApp bridges with owner-only auth
Skills—Markdown skill files, auto-generated on demand
Sleep Agent—Background: decay, tag, link, tier, summarize, 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

terminal
STEP 1 — INSTALL
# Install KyberBot (one time)
$ git clone https://github.com/KybernesisAI/kyberbot.git
$ cd kyberbot
$ npm install && npm run build
$ cd packages/cli && npm link && cd ../..
terminal
STEP 2 — ONBOARD
$ mkdir ~/my-agent && cd ~/my-agent
$ kyberbot onboard
Personal AI Operating System. Powered by Claude Code.
Step 1 of 7: Agent Identity
✔ What should your AI agent be called? Atlas
✔ One-line description of your agent: My personal AI agent
✔ How would you like to define its personality? (SOUL.md) Guided template (recommended)
Step 2 of 7: About You
✔ Your name: Ian
✔ Timezone (detected: America/New_York): America/New_York
✔ Location (optional): New York
✔ Tell your agent something about yourself (optional): I'm a software engineer
Step 3 of 7: Claude Code
✔ How would you like to connect to Claude? Agent SDK (recommended) — works with your Claude Code subscription
✔ OpenAI API key for embeddings (~$0.02/M tokens, optional): ••••••••••••••••••
Step 4 of 7: Initializing Brain
+ data/
+ logs/
+ brain/
+ skills/
+ .claude/ (CLAUDE.md, settings, commands, skills)
+ identity.yaml
+ SOUL.md
+ USER.md
+ HEARTBEAT.md
+ docker-compose.yml
Memory databases will be created automatically on first launch.
Step 5 of 7: Cloud Sync
Your agent's memory is stored locally by default.
Kybernesis Cloud adds optional cross-device access to workspace memory.
✔ Enable cloud memory sync via Kybernesis? (optional) No
Keeping all memory local.
Step 6 of 7: Messaging Channels
✔ Connect messaging channels? (Telegram / WhatsApp) Yes
✔ Which channel? Telegram
✔ Telegram Bot Token (from @BotFather): ••••••••••••••••••
Telegram configured in identity.yaml
+ .env
Step 7 of 7: Summary
+ identity.yaml -- Agent configuration
+ SOUL.md -- Agent personality
+ USER.md -- What the agent knows about you
+ HEARTBEAT.md -- Recurring task schedule
+ .claude/CLAUDE.md -- Claude Code instructions
+ data/ -- Memory databases
+ brain/ -- Knowledge base
+ skills/ -- Auto-generated capabilities
+ logs/ -- Service logs
Atlas is alive.
To start all services:
kyberbot
To start talking:
cd ~/my-agent && claude
Your agent will learn your preferences,
build skills it needs, and evolve over time.
terminal
STEP 3 — START
# Start all services (leave running)
$ kyberbot
# In a new terminal — start talking
$ cd ~/my-agent && claude
Your agent is alive. Start talking.
// 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.

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