@kernel.chat/kbot 3.61.7 → 3.61.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +1 -275
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,281 +1,7 @@
1
1
  # kbot
2
2
 
3
- <p align="center">
4
- <strong>kbot</strong><br>
5
- Open-source terminal AI agent. 35 agents. 670+ tools. 20 providers. Science, finance, security, and more.
6
- </p>
7
-
8
- <p align="center">
9
- <img src="tools/video-assets/demo.gif" alt="kbot demo" width="700">
10
- </p>
11
-
12
- <p align="center">
13
- <a href="https://github.com/isaacsight/kernel/actions/workflows/ci.yml"><img src="https://github.com/isaacsight/kernel/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
14
- <a href="https://www.npmjs.com/package/@kernel.chat/kbot"><img src="https://img.shields.io/npm/v/@kernel.chat/kbot?color=6B5B95&label=npm" alt="npm version"></a>
15
- <a href="https://www.npmjs.com/package/@kernel.chat/kbot"><img src="https://img.shields.io/npm/dw/@kernel.chat/kbot?color=6B5B95" alt="npm downloads"></a>
16
- <a href="https://github.com/isaacsight/kernel/blob/main/LICENSE"><img src="https://img.shields.io/github/license/isaacsight/kernel?color=6B5B95" alt="MIT License"></a>
17
- <a href="https://kernel.chat"><img src="https://img.shields.io/badge/web-kernel.chat-6B5B95" alt="kernel.chat"></a>
18
- <a href="https://discord.gg/kdMauM9abG"><img src="https://img.shields.io/badge/discord-join-6B5B95?logo=discord&logoColor=white" alt="Discord"></a>
19
- </p>
3
+ Open-source terminal AI agent. 670+ tools. 35 agents. 20 providers.
20
4
 
21
5
  ```bash
22
6
  npm install -g @kernel.chat/kbot
23
7
  ```
24
-
25
- ## Why kbot?
26
-
27
- Most terminal AI agents lock you into one provider, one model, one way of working. kbot doesn't.
28
-
29
- - **20 providers, zero lock-in** — Claude, GPT, Gemini, Grok, DeepSeek, Groq, Mistral, SambaNova, Cerebras, OpenRouter, and more. Switch with one command.
30
- - **Runs fully offline** — Embedded llama.cpp, Ollama, LM Studio, or Jan. $0, fully private.
31
- - **Learns your patterns** — Bayesian skill ratings + pattern extraction. Gets faster over time.
32
- - **35 specialist agents** — auto-routes your request to the right expert (coder, researcher, writer, guardian, quant, and 30 more).
33
- - **670+ tools** — files, bash, git, GitHub, web search, deploy, database, game dev, VFX, research, science, finance, security, and more.
34
- - **Programmatic SDK** — use kbot as a library in your own apps.
35
- - **MCP server built in** — plug kbot into Claude Code, Cursor, VS Code, Zed, or Neovim as a tool provider.
36
-
37
- ### How it compares
38
-
39
- | | kbot | Claude Code | Codex CLI | Aider | OpenCode |
40
- |---|---|---|---|---|---|
41
- | AI providers | 20 | 1 | 1 | 6 | 75+ |
42
- | Specialist agents | 35 | 0 | 0 | 0 | 0 |
43
- | Built-in tools | 600+ | ~20 | ~15 | ~10 | ~15 |
44
- | Science tools | 114 | 0 | 0 | 0 | 0 |
45
- | Learning engine | Yes | No | No | No | No |
46
- | Offline mode | Embedded + Ollama | No | No | Ollama | Ollama |
47
- | SDK | Yes | No | Yes | No | No |
48
- | MCP server | Yes | N/A | No | No | No |
49
- | Web companion | kernel.chat | No | No | No | No |
50
- | Open source | MIT | Source available | Apache 2.0 | Apache 2.0 | MIT |
51
- | Cost | BYOK / $0 local | $20+/mo | BYOK | BYOK | BYOK |
52
-
53
- ## Quick Start
54
-
55
- ```bash
56
- # Install globally
57
- npm install -g @kernel.chat/kbot
58
-
59
- # Or run directly (no install)
60
- npx @kernel.chat/kbot
61
-
62
- # Or use the install script (auto-installs Node.js if needed)
63
- curl -fsSL https://kernel.chat/install.sh | bash
64
- ```
65
-
66
- ```bash
67
- # Interactive mode
68
- kbot
69
-
70
- # One-shot
71
- kbot "explain this codebase"
72
- kbot "fix the auth bug in src/auth.ts"
73
- kbot "create a Dockerfile for this project"
74
-
75
- # Pipe mode (for scripting)
76
- kbot -p "generate a migration for user roles" > migration.sql
77
-
78
- # Use local models (free, no API key)
79
- kbot local
80
-
81
- # Set up your API key
82
- kbot auth
83
- ```
84
-
85
- ## Specialists
86
-
87
- kbot auto-routes to the right agent for each task. Or pick one with `--agent <name>`.
88
-
89
- | | Agents |
90
- |---|---|
91
- | **Core** | kernel, researcher, coder, writer, analyst |
92
- | **Extended** | aesthete, guardian, curator, strategist |
93
- | **Domain** | infrastructure, quant, investigator, oracle, chronist, sage, communicator, adapter |
94
- | **Presets** | claude-code, cursor, copilot, creative, developer |
95
-
96
- ## 600+ Tools
97
-
98
- | Category | Examples |
99
- |----------|---------|
100
- | **Files & Code** | read, write, glob, grep, lint, format, type-check |
101
- | **Shell** | bash, parallel execute, background tasks |
102
- | **Git & GitHub** | commit, diff, PR, issues, code search |
103
- | **Web** | search, fetch, browser automation, browser agent |
104
- | **Research** | arXiv, Semantic Scholar, HuggingFace, NASA, DOI |
105
- | **Data** | CSV read/query/write, transforms, reports, invoices |
106
- | **Quality** | lint (ESLint/Biome/Clippy), test (Vitest/Jest/pytest), deps audit, formatting |
107
- | **Deploy** | Vercel, Netlify, Cloudflare Workers/Pages, Fly.io, Railway |
108
- | **Database** | Postgres, MySQL, SQLite queries, Prisma, ER diagrams, seed data |
109
- | **Containers** | Docker build/run/compose, Terraform |
110
- | **Creative** | p5.js generative art, GLSL shaders, SVG patterns, design variants |
111
- | **VFX** | GLSL shaders, FFmpeg, ImageMagick, Blender, procedural textures |
112
- | **Game Dev** | 16 tools for Godot, Unity, Unreal, Bevy, Phaser, Three.js, PlayCanvas, Defold |
113
- | **Training** | dataset prep, fine-tuning, evaluation, model export |
114
- | **Social** | post to X, LinkedIn, Bluesky, Mastodon — single posts and threads |
115
- | **Sandbox** | Docker sandboxes, E2B cloud sandboxes, isolated code execution |
116
- | **Notebooks** | Jupyter read/edit/insert/delete cells |
117
- | **Build Matrix** | cross-platform builds — mobile, desktop, WASM, embedded, server |
118
- | **LSP** | goto definition, find references, hover, rename, diagnostics |
119
- | **Memory** | persistent memory save/search/update across sessions |
120
- | **MCP** | marketplace search/install, 20 bundled servers |
121
- | **IDE** | MCP server, ACP server, LSP bridge |
122
- | **Forge** | create tools at runtime, publish to registry, install from registry |
123
- | **Meta** | subagents, worktrees, planner, sessions, checkpoints, self-eval |
124
- | **Science & Math** | symbolic compute, matrix ops, FFT, ODEs, probability, optimization, graph theory, OEIS |
125
- | **Physics** | orbital mechanics, circuits, signal processing, particles (PDG), relativity, quantum simulator, beam analysis, fluid dynamics |
126
- | **Chemistry** | PubChem compounds, reactions, periodic table (118 elements), spectroscopy, stoichiometry, thermodynamics |
127
- | **Biology** | PubMed, gene lookup, protein/PDB, BLAST, drug/ChEMBL, pathways, taxonomy, clinical trials |
128
- | **Earth & Climate** | earthquakes/USGS, climate/NOAA, satellite imagery, geology, ocean, air quality, volcanoes, water resources |
129
- | **Neuroscience** | brain atlas, EEG analysis, cognitive models, neural simulation, connectome, psychophysics |
130
- | **Social Science** | psychometrics, game theory, econometrics, social network analysis, survey design, voting systems |
131
- | **Humanities** | corpus analysis, formal logic, argument mapping, ethics frameworks, historical timelines, stylometry |
132
- | **Health & Epidemiology** | SIR/SEIR models, epidemiology calculations, disease surveillance, nutrition, vaccination modeling |
133
- | **Finance** | market data, technical analysis, paper trading, DeFi yields, wallet & swaps, stock screener, sentiment |
134
- | **Cybersecurity** | dep_audit, secret_scan, ssl_check, headers_check, cve_lookup, port_scan, owasp_check |
135
- | **Self-Defense** | memory HMAC, prompt injection detection, knowledge sanitization, forge verification, anomaly detection |
136
-
137
- ## 20 Providers
138
-
139
- | Provider | Cost | Local? |
140
- |----------|------|--------|
141
- | **Embedded (llama.cpp)** | **Free** | Yes |
142
- | **Ollama** | **Free** | Yes |
143
- | **LM Studio** | **Free** | Yes |
144
- | **Jan** | **Free** | Yes |
145
- | DeepSeek | $0.27/M in | Cloud |
146
- | SambaNova | $0.50/M in | Cloud |
147
- | Cerebras | $0.60/M in | Cloud |
148
- | Groq | $0.59/M in | Cloud |
149
- | NVIDIA NIM | $0.80/M in | Cloud |
150
- | Together AI | $0.88/M in | Cloud |
151
- | Fireworks AI | $0.90/M in | Cloud |
152
- | Google (Gemini) | $1.25/M in | Cloud |
153
- | Mistral | $2.00/M in | Cloud |
154
- | OpenAI (GPT) | $2.00/M in | Cloud |
155
- | Cohere | $2.50/M in | Cloud |
156
- | Anthropic (Claude) | $3.00/M in | Cloud |
157
- | xAI (Grok) | $3.00/M in | Cloud |
158
- | Perplexity | $3.00/M in | Cloud |
159
- | OpenRouter | varies | Cloud |
160
- | kbot local | **Free** | Yes |
161
-
162
- Set any provider's env var and kbot auto-detects it. Or run `kbot auth` for interactive setup.
163
-
164
- ## SDK
165
-
166
- ```typescript
167
- import { agent, tools, providers } from '@kernel.chat/kbot'
168
-
169
- const result = await agent.run("fix the auth bug", { agent: 'coder' })
170
- console.log(result.content)
171
-
172
- for await (const event of agent.stream("explain this code")) {
173
- if (event.type === 'content_delta') process.stdout.write(event.text)
174
- }
175
- ```
176
-
177
- ## Architecture
178
-
179
- ```mermaid
180
- graph TD
181
- A[User Message] --> B{Local-first check}
182
- B -->|file, git, grep| C[Instant response — $0]
183
- B -->|Needs AI| D{Complexity detection}
184
- D -->|Simple| E[Bayesian Router → Specialist]
185
- D -->|Multi-step| F[Autonomous Planner]
186
- E --> G[Provider API + Tool Loop]
187
- F --> G
188
- G --> H{600+ Tools}
189
- H --> I[File ops, bash, git, GitHub, search, deploy, DB, game dev...]
190
- G --> J[Learning Engine]
191
- J --> K[Patterns + Solutions + User Profile]
192
- G --> L[Checkpointing]
193
- L --> M[Resume from last tool call]
194
- ```
195
-
196
- ## MCP Server
197
-
198
- Use kbot as a tool provider inside any MCP-compatible IDE:
199
-
200
- ```json
201
- {
202
- "mcp": {
203
- "servers": {
204
- "kbot": { "command": "kbot", "args": ["ide", "mcp"] }
205
- }
206
- }
207
- }
208
- ```
209
-
210
- Works with Claude Code, Cursor, VS Code, Windsurf, Zed, Neovim.
211
-
212
- ## Commands
213
-
214
- | Command | What it does |
215
- |---------|-------------|
216
- | `kbot` | Interactive REPL |
217
- | `kbot "prompt"` | One-shot execution |
218
- | `kbot auth` | Configure API key |
219
- | `kbot local` | Use local AI (Ollama, embedded, LM Studio, Jan) |
220
- | `kbot serve` | Start HTTP REST + SSE streaming server |
221
- | `kbot audit <repo>` | Security + quality audit of any GitHub repo |
222
- | `kbot contribute <repo>` | Find good-first-issues and quick wins |
223
- | `kbot share` | Share conversation as GitHub Gist |
224
- | `kbot pair` | File watcher with auto-analysis |
225
- | `kbot team` | Multi-agent TCP collaboration |
226
- | `kbot record` | Terminal session recording (SVG, GIF, asciicast) |
227
- | `kbot voice` | Text-to-speech output mode |
228
- | `kbot watch` | Real-time file analysis on change |
229
- | `kbot bootstrap` | Outer-loop project optimizer (visibility scoring) |
230
- | `kbot plugins` | Search, install, update community plugins |
231
- | `kbot models` | List, pull, remove, catalog local models |
232
- | `kbot changelog` | Generate changelog from git history |
233
- | `kbot completions` | Shell completions (bash, zsh, fish) |
234
- | `kbot cloud` | Sync learning data to kernel.chat |
235
- | `kbot ide mcp` | Start MCP server for IDEs |
236
- | `kbot doctor` | 10-point health check |
237
-
238
- ### Power-User Flags
239
-
240
- ```bash
241
- kbot --architect "design the auth system" # Architecture mode — plan before code
242
- kbot --thinking "solve this hard problem" # Extended reasoning with thinking budget
243
- kbot --self-eval "write a parser" # Self-evaluation loop — scores and retries
244
- kbot --computer-use "fill out this form" # Computer use — controls mouse and keyboard
245
- kbot -p "query" > output.txt # Pipe mode — clean output for scripting
246
- ```
247
-
248
- ## Security
249
-
250
- - API keys encrypted at rest (AES-256-CBC)
251
- - Destructive operations require confirmation
252
- - Shell commands sandboxed with blocklist
253
- - Tool execution timeout (5 min) with middleware pipeline
254
- - Config files restricted to owner (chmod 600)
255
- - 0 P0/P1 security issues (audited March 2026)
256
-
257
- ## Development
258
-
259
- ```bash
260
- cd packages/kbot
261
- npm install
262
- npm run dev # Run in dev mode
263
- npm run build # Compile TypeScript
264
- npm run test # Run tests (vitest)
265
- ```
266
-
267
- ## Web Companion — kernel.chat
268
-
269
- kbot has a web companion at [kernel.chat](https://kernel.chat) — same agents, persistent memory, and a visual interface. Free to use (20 messages/day).
270
-
271
- ## Community
272
-
273
- - **Web**: [kernel.chat](https://kernel.chat)
274
- - **npm**: [@kernel.chat/kbot](https://www.npmjs.com/package/@kernel.chat/kbot)
275
- - **Discord**: [discord.gg/kdMauM9abG](https://discord.gg/kdMauM9abG)
276
- - **GitHub**: [isaacsight/kernel](https://github.com/isaacsight/kernel)
277
- - **Issues**: [Report a bug](https://github.com/isaacsight/kernel/issues)
278
-
279
- ## License
280
-
281
- [MIT](LICENSE) — [kernel.chat group](https://kernel.chat)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kernel.chat/kbot",
3
- "version": "3.61.7",
3
+ "version": "3.61.8",
4
4
  "description": "The only AI agent that builds its own tools — and defends itself. Your AI answers to you, not a government. NEW: Computer-use desktop agent, macOS permission wizard, session isolation, M4L devices, Serum 2 presets, DJ tools. 670+ tools, 35 agents, 20 providers. Fully local, fully sovereign. MIT.",
5
5
  "type": "module",
6
6
  "repository": {