If kbot is useful to you, consider starring the repo — it helps others discover the project.

npm install -g @kernel.chat/kbot

This repo ships three packages

Package	What it is	npm	Source
@kernel.chat/kbot	Open-source terminal AI agent — 100+ skills, multi-provider, BYOK, MIT	`npm i -g @kernel.chat/kbot`	`packages/kbot/`
@kernel.chat/kbot-finance	Audit-grade AI infrastructure for capital markets — content-addressed envelopes, hash-chained audit log, regulatory verifier, MCP server. Apache 2.0	`npm i @kernel.chat/kbot-finance`	`packages/kbot-finance/`
@kernel.chat/agent-os	POSIX for AI agents — ten OS-level primitives: signed capability tokens (acap), namespaces, per-agent quotas (ulimit-tok), taint-tracked exec (chexec), content-addressed audit, downscoped handoff, snapshot, credential vault, rubric-graded outcomes. Runs above Modal-class sandboxes, below MCP/A2A. Apache 2.0	`npm i @kernel.chat/agent-os`	`packages/agent-os/`

Plus this repo also serves kernel.chat — the editorial magazine documenting the rise of provenance engineering as a discipline. ISSUE 381 — On Provenance — declares the magazine's five-year throughline. See packages/kbot-finance/ROLE.md for the field definition.

The stack, end-to-end

your AI agent  →  @kernel.chat/agent-os  (permissions, quotas, audit, vault)
                       │
                       ├─→  @kernel.chat/kbot          (the agent itself)
                       └─→  @kernel.chat/kbot-finance  (regulated-industry verifier)

agent-os is the OS-level substrate; kbot is one tenant of that OS; kbot-finance is the compliance verifier those tenants call when the work is regulated. Open core throughout, with commercial offerings downstream.

Why kbot?

Most terminal AI agents lock you into one provider, one model, one way of working. kbot doesn't.

20 providers, zero lock-in — Claude, GPT, Gemini, Grok, DeepSeek, Groq, Mistral, SambaNova, Cerebras, OpenRouter, and more. Switch with one command.
Runs fully offline — Embedded llama.cpp, Ollama, LM Studio, or Jan. $0, fully private.
Learns your patterns — Bayesian skill ratings + pattern extraction. Gets faster over time.
35 specialist agents — auto-routes your request to the right expert (coder, researcher, writer, guardian, quant, and 30 more).
600+ tools — files, bash, git, GitHub, web search, deploy, database, game dev, VFX, research, science, finance, security, and more.
Programmatic SDK — use kbot as a library in your own apps.
MCP server built in — plug kbot into Claude Code, Cursor, VS Code, Zed, or Neovim as a tool provider.

How it compares

	kbot	Claude Code	Codex CLI	Aider	OpenCode
AI providers	20	1	1	6	75+
Specialist agents	35	0	0	0	0
Built-in tools	600+	~20	~15	~10	~15
Science tools	114	0	0	0	0
Learning engine	Yes	No	No	No	No
Offline mode	Embedded + Ollama	No	No	Ollama	Ollama
SDK	Yes	No	Yes	No	No
MCP server	Yes	N/A	No	No	No
Web companion	kernel.chat	No	No	No	No
Open source	MIT	Source available	Apache 2.0	Apache 2.0	MIT
Cost	BYOK / $0 local	$20+/mo	BYOK	BYOK	BYOK

Quick Start

# Install globally
npm install -g @kernel.chat/kbot

# Or run directly (no install)
npx @kernel.chat/kbot

# Or use the install script (auto-installs Node.js if needed)
curl -fsSL https://kernel.chat/install.sh | bash

# Interactive mode
kbot

# One-shot
kbot "explain this codebase"
kbot "fix the auth bug in src/auth.ts"
kbot "create a Dockerfile for this project"

# Pipe mode (for scripting)
kbot -p "generate a migration for user roles" > migration.sql

# Use local models (free, no API key)
kbot local

# Set up your API key
kbot auth

Specialists

kbot auto-routes to the right agent for each task. Or pick one with --agent <name>.

	Agents
Core	kernel, researcher, coder, writer, analyst
Extended	aesthete, guardian, curator, strategist
Domain	infrastructure, quant, investigator, oracle, chronist, sage, communicator, adapter
Presets	claude-code, cursor, copilot, creative, developer

600+ Tools

Category	Examples
Files & Code	read, write, glob, grep, lint, format, type-check
Shell	bash, parallel execute, background tasks
Git & GitHub	commit, diff, PR, issues, code search
Web	search, fetch, browser automation, browser agent
Research	arXiv, Semantic Scholar, HuggingFace, NASA, DOI
Data	CSV read/query/write, transforms, reports, invoices
Quality	lint (ESLint/Biome/Clippy), test (Vitest/Jest/pytest), deps audit, formatting
Deploy	Vercel, Netlify, Cloudflare Workers/Pages, Fly.io, Railway
Database	Postgres, MySQL, SQLite queries, Prisma, ER diagrams, seed data
Containers	Docker build/run/compose, Terraform
Creative	p5.js generative art, GLSL shaders, SVG patterns, design variants
VFX	GLSL shaders, FFmpeg, ImageMagick, Blender, procedural textures
Game Dev	16 tools for Godot, Unity, Unreal, Bevy, Phaser, Three.js, PlayCanvas, Defold
Training	dataset prep, fine-tuning, evaluation, model export
Social	post to X, LinkedIn, Bluesky, Mastodon — single posts and threads
Sandbox	Docker sandboxes, E2B cloud sandboxes, isolated code execution
Notebooks	Jupyter read/edit/insert/delete cells
Build Matrix	cross-platform builds — mobile, desktop, WASM, embedded, server
LSP	goto definition, find references, hover, rename, diagnostics
Memory	persistent memory save/search/update across sessions
MCP	marketplace search/install, 20 bundled servers
IDE	MCP server, ACP server, LSP bridge
Forge	create tools at runtime, publish to registry, install from registry
Meta	subagents, worktrees, planner, sessions, checkpoints, self-eval
Science & Math	symbolic compute, matrix ops, FFT, ODEs, probability, optimization, graph theory, OEIS
Physics	orbital mechanics, circuits, signal processing, particles (PDG), relativity, quantum simulator, beam analysis, fluid dynamics
Chemistry	PubChem compounds, reactions, periodic table (118 elements), spectroscopy, stoichiometry, thermodynamics
Biology	PubMed, gene lookup, protein/PDB, BLAST, drug/ChEMBL, pathways, taxonomy, clinical trials
Earth & Climate	earthquakes/USGS, climate/NOAA, satellite imagery, geology, ocean, air quality, volcanoes, water resources
Neuroscience	brain atlas, EEG analysis, cognitive models, neural simulation, connectome, psychophysics
Social Science	psychometrics, game theory, econometrics, social network analysis, survey design, voting systems
Humanities	corpus analysis, formal logic, argument mapping, ethics frameworks, historical timelines, stylometry
Health & Epidemiology	SIR/SEIR models, epidemiology calculations, disease surveillance, nutrition, vaccination modeling
Finance	market data, technical analysis, paper trading, DeFi yields, wallet & swaps, stock screener, sentiment
Cybersecurity	dep_audit, secret_scan, ssl_check, headers_check, cve_lookup, port_scan, owasp_check
Self-Defense	memory HMAC, prompt injection detection, knowledge sanitization, forge verification, anomaly detection

20 Providers

Provider	Cost	Local?
Embedded (llama.cpp)	Free	Yes
Ollama	Free	Yes
LM Studio	Free	Yes
Jan	Free	Yes
DeepSeek	$0.27/M in	Cloud
SambaNova	$0.50/M in	Cloud
Cerebras	$0.60/M in	Cloud
Groq	$0.59/M in	Cloud
NVIDIA NIM	$0.80/M in	Cloud
Together AI	$0.88/M in	Cloud
Fireworks AI	$0.90/M in	Cloud
Google (Gemini)	$1.25/M in	Cloud
Mistral	$2.00/M in	Cloud
OpenAI (GPT)	$2.00/M in	Cloud
Cohere	$2.50/M in	Cloud
Anthropic (Claude)	$3.00/M in	Cloud
xAI (Grok)	$3.00/M in	Cloud
Perplexity	$3.00/M in	Cloud
OpenRouter	varies	Cloud
kbot local	Free	Yes

Set any provider's env var and kbot auto-detects it. Or run kbot auth for interactive setup.

SDK

import { agent, tools, providers } from '@kernel.chat/kbot'

const result = await agent.run("fix the auth bug", { agent: 'coder' })
console.log(result.content)

for await (const event of agent.stream("explain this code")) {
  if (event.type === 'content_delta') process.stdout.write(event.text)
}

Architecture

graph TD
    A[User Message] --> B{Local-first check}
    B -->|file, git, grep| C[Instant response — $0]
    B -->|Needs AI| D{Complexity detection}
    D -->|Simple| E[Bayesian Router → Specialist]
    D -->|Multi-step| F[Autonomous Planner]
    E --> G[Provider API + Tool Loop]
    F --> G
    G --> H{600+ Tools}
    H --> I[File ops, bash, git, GitHub, search, deploy, DB, game dev...]
    G --> J[Learning Engine]
    J --> K[Patterns + Solutions + User Profile]
    G --> L[Checkpointing]
    L --> M[Resume from last tool call]

MCP Server

kbot MCP server

Use kbot as a tool provider inside any MCP-compatible IDE:

{
  "mcp": {
    "servers": {
      "kbot": { "command": "kbot", "args": ["ide", "mcp"] }
    }
  }
}

Or run via Docker:

docker run -i --rm kernelchat/kbot ide mcp

Works with Claude Code, Cursor, VS Code, Windsurf, Zed, Neovim.

Commands

Command	What it does
`kbot`	Interactive REPL
`kbot "prompt"`	One-shot execution
`kbot auth`	Configure API key
`kbot local`	Use local AI (Ollama, embedded, LM Studio, Jan)
`kbot serve`	Start HTTP REST + SSE streaming server
`kbot audit <repo>`	Security + quality audit of any GitHub repo
`kbot contribute <repo>`	Find good-first-issues and quick wins
`kbot share`	Share conversation as GitHub Gist
`kbot pair`	File watcher with auto-analysis
`kbot team`	Multi-agent TCP collaboration
`kbot record`	Terminal session recording (SVG, GIF, asciicast)
`kbot voice`	Text-to-speech output mode
`kbot watch`	Real-time file analysis on change
`kbot bootstrap`	Outer-loop project optimizer (visibility scoring)
`kbot plugins`	Search, install, update community plugins
`kbot models`	List, pull, remove, catalog local models
`kbot changelog`	Generate changelog from git history
`kbot completions`	Shell completions (bash, zsh, fish)
`kbot cloud`	Sync learning data to kernel.chat
`kbot ide mcp`	Start MCP server for IDEs
`kbot doctor`	10-point health check

Power-User Flags

kbot --architect "design the auth system"    # Architecture mode — plan before code
kbot --thinking "solve this hard problem"    # Extended reasoning with thinking budget
kbot --self-eval "write a parser"            # Self-evaluation loop — scores and retries
kbot --computer-use "fill out this form"     # Computer use — controls mouse and keyboard
kbot -p "query" > output.txt                 # Pipe mode — clean output for scripting

Security

API keys encrypted at rest (AES-256-CBC)
Destructive operations require confirmation
Shell commands sandboxed with blocklist
Tool execution timeout (5 min) with middleware pipeline
Config files restricted to owner (chmod 600)
0 P0/P1 security issues (audited March 2026)

Development

cd packages/kbot
npm install
npm run dev          # Run in dev mode
npm run build        # Compile TypeScript
npm run test         # Run tests (vitest)

Web Companion — kernel.chat

kbot has a web companion at kernel.chat — same agents, persistent memory, and a visual interface. Free to use (20 messages/day).

Community

Web: kernel.chat
npm: @kernel.chat/kbot
Discord: discord.gg/kdMauM9abG
GitHub: isaacsight/kernel
Issues: Report a bug

License

MIT — kernel.chat group

kernelchat/kbot