KernelBot

# KernelBot

[kernelbot.io](https://kernelbot.io) | [npm](https://www.npmjs.com/package/kernelbot) | [GitHub](https://github.com/KernelCode/kernelbot)

A self-evolving AI agent system that runs on your machine. KernelBot doesn't just respond to messages — it thinks, learns, remembers why things happened, builds a model of your world, and rewrites its own behavior based on every interaction.

## What Makes KernelBot Different

Most AI assistants are stateless — they forget everything between conversations. KernelBot has a **brain**.

- **World Model** — builds a knowledge graph of your projects, tools, preferences, and team. Entities, relationships, beliefs, and jargon — all structured and queryable.
- **Causal Memory** — doesn't just remember *what* happened, but *why*. Tracks trigger → goal → approach → outcome → lesson chains for every significant task.
- **Behavioral DNA** — 13 measurable personality traits that evolve based on real interactions. Per-user communication profiles adapt to how each person works.
- **Feedback Engine** — detects implicit signals (corrections, preferences, frustration, satisfaction) from your messages without requiring explicit feedback buttons.
- **Memory Consolidation** — every 6 hours, synthesizes recent memories, extracts new knowledge for the world model, merges redundant information, and identifies gaps.
- **Synthesis Loop** — replaces random background activity with intelligent, goal-directed cycles: assess → prioritize → execute → measure → adapt.
- **Identity Awareness** — classifies every sender (owner, known user, unknown, AI agent), enforces knowledge isolation, and adapts communication style per person.

## How It Works

```
You → Orchestrator (your chosen model)
              ↓ dispatch_task
  ┌───────────┼───────────────┐
  ↓           ↓               ↓
Coding    Browser    System    DevOps    Research
Worker     Worker     Worker    Worker     Worker
```

1. You send a message.
2. The **orchestrator** plans what needs t