@kernel.chat/kbot 3.61.4 → 3.61.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kernel.chat/kbot",
-  "version": "3.61.4",
+  "version": "3.61.5",
   "description": "The only AI agent that builds its own tools \u2014 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.",
   "type": "module",
   "repository": {
@@ -218,5 +218,7 @@
     "README.md",
     "install.sh",
     "ollama-manifest.json"
-  ]
+  ],
+  "readme": "<p align=\"center\">\n  <strong>kbot</strong><br>\n  Open-source terminal AI agent. 35 agents. 670+ tools. 20 providers. Science, finance, security, and more.\n</p>\n\n<p align=\"center\">\n  <img src=\"tools/video-assets/demo.gif\" alt=\"kbot demo\" width=\"700\">\n</p>\n\n<p align=\"center\">\n  <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>\n  <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>\n  <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>\n  <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>\n  <a href=\"https://kernel.chat\"><img src=\"https://img.shields.io/badge/web-kernel.chat-6B5B95\" alt=\"kernel.chat\"></a>\n  <a href=\"https://discord.gg/kdMauM9abG\"><img src=\"https://img.shields.io/badge/discord-join-6B5B95?logo=discord&logoColor=white\" alt=\"Discord\"></a>\n</p>\n\n```bash\nnpm install -g @kernel.chat/kbot\n```\n\n## Why kbot?\n\nMost terminal AI agents lock you into one provider, one model, one way of working. kbot doesn't.\n\n- **20 providers, zero lock-in** \u2014 Claude, GPT, Gemini, Grok, DeepSeek, Groq, Mistral, SambaNova, Cerebras, OpenRouter, and more. Switch with one command.\n- **Runs fully offline** \u2014 Embedded llama.cpp, Ollama, LM Studio, or Jan. $0, fully private.\n- **Learns your patterns** \u2014 Bayesian skill ratings + pattern extraction. Gets faster over time.\n- **35 specialist agents** \u2014 auto-routes your request to the right expert (coder, researcher, writer, guardian, quant, and 30 more).\n- **670+ tools** \u2014 files, bash, git, GitHub, web search, deploy, database, game dev, VFX, research, science, finance, security, and more.\n- **Programmatic SDK** \u2014 use kbot as a library in your own apps.\n- **MCP server built in** \u2014 plug kbot into Claude Code, Cursor, VS Code, Zed, or Neovim as a tool provider.\n\n### How it compares\n\n| | kbot | Claude Code | Codex CLI | Aider | OpenCode |\n|---|---|---|---|---|---|\n| AI providers | 20 | 1 | 1 | 6 | 75+ |\n| Specialist agents | 35 | 0 | 0 | 0 | 0 |\n| Built-in tools | 600+ | ~20 | ~15 | ~10 | ~15 |\n| Science tools | 114 | 0 | 0 | 0 | 0 |\n| Learning engine | Yes | No | No | No | No |\n| Offline mode | Embedded + Ollama | No | No | Ollama | Ollama |\n| SDK | Yes | No | Yes | No | No |\n| MCP server | Yes | N/A | No | No | No |\n| Web companion | kernel.chat | No | No | No | No |\n| Open source | MIT | Source available | Apache 2.0 | Apache 2.0 | MIT |\n| Cost | BYOK / $0 local | $20+/mo | BYOK | BYOK | BYOK |\n\n## Quick Start\n\n```bash\n# Install globally\nnpm install -g @kernel.chat/kbot\n\n# Or run directly (no install)\nnpx @kernel.chat/kbot\n\n# Or use the install script (auto-installs Node.js if needed)\ncurl -fsSL https://kernel.chat/install.sh | bash\n```\n\n```bash\n# Interactive mode\nkbot\n\n# One-shot\nkbot \"explain this codebase\"\nkbot \"fix the auth bug in src/auth.ts\"\nkbot \"create a Dockerfile for this project\"\n\n# Pipe mode (for scripting)\nkbot -p \"generate a migration for user roles\" > migration.sql\n\n# Use local models (free, no API key)\nkbot local\n\n# Set up your API key\nkbot auth\n```\n\n## Specialists\n\nkbot auto-routes to the right agent for each task. Or pick one with `--agent <name>`.\n\n| | Agents |\n|---|---|\n| **Core** | kernel, researcher, coder, writer, analyst |\n| **Extended** | aesthete, guardian, curator, strategist |\n| **Domain** | infrastructure, quant, investigator, oracle, chronist, sage, communicator, adapter |\n| **Presets** | claude-code, cursor, copilot, creative, developer |\n\n## 600+ Tools\n\n| Category | Examples |\n|----------|---------|\n| **Files & Code** | read, write, glob, grep, lint, format, type-check |\n| **Shell** | bash, parallel execute, background tasks |\n| **Git & GitHub** | commit, diff, PR, issues, code search |\n| **Web** | search, fetch, browser automation, browser agent |\n| **Research** | arXiv, Semantic Scholar, HuggingFace, NASA, DOI |\n| **Data** | CSV read/query/write, transforms, reports, invoices |\n| **Quality** | lint (ESLint/Biome/Clippy), test (Vitest/Jest/pytest), deps audit, formatting |\n| **Deploy** | Vercel, Netlify, Cloudflare Workers/Pages, Fly.io, Railway |\n| **Database** | Postgres, MySQL, SQLite queries, Prisma, ER diagrams, seed data |\n| **Containers** | Docker build/run/compose, Terraform |\n| **Creative** | p5.js generative art, GLSL shaders, SVG patterns, design variants |\n| **VFX** | GLSL shaders, FFmpeg, ImageMagick, Blender, procedural textures |\n| **Game Dev** | 16 tools for Godot, Unity, Unreal, Bevy, Phaser, Three.js, PlayCanvas, Defold |\n| **Training** | dataset prep, fine-tuning, evaluation, model export |\n| **Social** | post to X, LinkedIn, Bluesky, Mastodon \u2014 single posts and threads |\n| **Sandbox** | Docker sandboxes, E2B cloud sandboxes, isolated code execution |\n| **Notebooks** | Jupyter read/edit/insert/delete cells |\n| **Build Matrix** | cross-platform builds \u2014 mobile, desktop, WASM, embedded, server |\n| **LSP** | goto definition, find references, hover, rename, diagnostics |\n| **Memory** | persistent memory save/search/update across sessions |\n| **MCP** | marketplace search/install, 20 bundled servers |\n| **IDE** | MCP server, ACP server, LSP bridge |\n| **Forge** | create tools at runtime, publish to registry, install from registry |\n| **Meta** | subagents, worktrees, planner, sessions, checkpoints, self-eval |\n| **Science & Math** | symbolic compute, matrix ops, FFT, ODEs, probability, optimization, graph theory, OEIS |\n| **Physics** | orbital mechanics, circuits, signal processing, particles (PDG), relativity, quantum simulator, beam analysis, fluid dynamics |\n| **Chemistry** | PubChem compounds, reactions, periodic table (118 elements), spectroscopy, stoichiometry, thermodynamics |\n| **Biology** | PubMed, gene lookup, protein/PDB, BLAST, drug/ChEMBL, pathways, taxonomy, clinical trials |\n| **Earth & Climate** | earthquakes/USGS, climate/NOAA, satellite imagery, geology, ocean, air quality, volcanoes, water resources |\n| **Neuroscience** | brain atlas, EEG analysis, cognitive models, neural simulation, connectome, psychophysics |\n| **Social Science** | psychometrics, game theory, econometrics, social network analysis, survey design, voting systems |\n| **Humanities** | corpus analysis, formal logic, argument mapping, ethics frameworks, historical timelines, stylometry |\n| **Health & Epidemiology** | SIR/SEIR models, epidemiology calculations, disease surveillance, nutrition, vaccination modeling |\n| **Finance** | market data, technical analysis, paper trading, DeFi yields, wallet & swaps, stock screener, sentiment |\n| **Cybersecurity** | dep_audit, secret_scan, ssl_check, headers_check, cve_lookup, port_scan, owasp_check |\n| **Self-Defense** | memory HMAC, prompt injection detection, knowledge sanitization, forge verification, anomaly detection |\n\n## 20 Providers\n\n| Provider | Cost | Local? |\n|----------|------|--------|\n| **Embedded (llama.cpp)** | **Free** | Yes |\n| **Ollama** | **Free** | Yes |\n| **LM Studio** | **Free** | Yes |\n| **Jan** | **Free** | Yes |\n| DeepSeek | $0.27/M in | Cloud |\n| SambaNova | $0.50/M in | Cloud |\n| Cerebras | $0.60/M in | Cloud |\n| Groq | $0.59/M in | Cloud |\n| NVIDIA NIM | $0.80/M in | Cloud |\n| Together AI | $0.88/M in | Cloud |\n| Fireworks AI | $0.90/M in | Cloud |\n| Google (Gemini) | $1.25/M in | Cloud |\n| Mistral | $2.00/M in | Cloud |\n| OpenAI (GPT) | $2.00/M in | Cloud |\n| Cohere | $2.50/M in | Cloud |\n| Anthropic (Claude) | $3.00/M in | Cloud |\n| xAI (Grok) | $3.00/M in | Cloud |\n| Perplexity | $3.00/M in | Cloud |\n| OpenRouter | varies | Cloud |\n| kbot local | **Free** | Yes |\n\nSet any provider's env var and kbot auto-detects it. Or run `kbot auth` for interactive setup.\n\n## SDK\n\n```typescript\nimport { agent, tools, providers } from '@kernel.chat/kbot'\n\nconst result = await agent.run(\"fix the auth bug\", { agent: 'coder' })\nconsole.log(result.content)\n\nfor await (const event of agent.stream(\"explain this code\")) {\n  if (event.type === 'content_delta') process.stdout.write(event.text)\n}\n```\n\n## Architecture\n\n```mermaid\ngraph TD\n    A[User Message] --> B{Local-first check}\n    B -->|file, git, grep| C[Instant response \u2014 $0]\n    B -->|Needs AI| D{Complexity detection}\n    D -->|Simple| E[Bayesian Router \u2192 Specialist]\n    D -->|Multi-step| F[Autonomous Planner]\n    E --> G[Provider API + Tool Loop]\n    F --> G\n    G --> H{600+ Tools}\n    H --> I[File ops, bash, git, GitHub, search, deploy, DB, game dev...]\n    G --> J[Learning Engine]\n    J --> K[Patterns + Solutions + User Profile]\n    G --> L[Checkpointing]\n    L --> M[Resume from last tool call]\n```\n\n## MCP Server\n\nUse kbot as a tool provider inside any MCP-compatible IDE:\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"kbot\": { \"command\": \"kbot\", \"args\": [\"ide\", \"mcp\"] }\n    }\n  }\n}\n```\n\nWorks with Claude Code, Cursor, VS Code, Windsurf, Zed, Neovim.\n\n## Commands\n\n| Command | What it does |\n|---------|-------------|\n| `kbot` | Interactive REPL |\n| `kbot \"prompt\"` | One-shot execution |\n| `kbot auth` | Configure API key |\n| `kbot local` | Use local AI (Ollama, embedded, LM Studio, Jan) |\n| `kbot serve` | Start HTTP REST + SSE streaming server |\n| `kbot audit <repo>` | Security + quality audit of any GitHub repo |\n| `kbot contribute <repo>` | Find good-first-issues and quick wins |\n| `kbot share` | Share conversation as GitHub Gist |\n| `kbot pair` | File watcher with auto-analysis |\n| `kbot team` | Multi-agent TCP collaboration |\n| `kbot record` | Terminal session recording (SVG, GIF, asciicast) |\n| `kbot voice` | Text-to-speech output mode |\n| `kbot watch` | Real-time file analysis on change |\n| `kbot bootstrap` | Outer-loop project optimizer (visibility scoring) |\n| `kbot plugins` | Search, install, update community plugins |\n| `kbot models` | List, pull, remove, catalog local models |\n| `kbot changelog` | Generate changelog from git history |\n| `kbot completions` | Shell completions (bash, zsh, fish) |\n| `kbot cloud` | Sync learning data to kernel.chat |\n| `kbot ide mcp` | Start MCP server for IDEs |\n| `kbot doctor` | 10-point health check |\n\n### Power-User Flags\n\n```bash\nkbot --architect \"design the auth system\"    # Architecture mode \u2014 plan before code\nkbot --thinking \"solve this hard problem\"    # Extended reasoning with thinking budget\nkbot --self-eval \"write a parser\"            # Self-evaluation loop \u2014 scores and retries\nkbot --computer-use \"fill out this form\"     # Computer use \u2014 controls mouse and keyboard\nkbot -p \"query\" > output.txt                 # Pipe mode \u2014 clean output for scripting\n```\n\n## Security\n\n- API keys encrypted at rest (AES-256-CBC)\n- Destructive operations require confirmation\n- Shell commands sandboxed with blocklist\n- Tool execution timeout (5 min) with middleware pipeline\n- Config files restricted to owner (chmod 600)\n- 0 P0/P1 security issues (audited March 2026)\n\n## Development\n\n```bash\ncd packages/kbot\nnpm install\nnpm run dev          # Run in dev mode\nnpm run build        # Compile TypeScript\nnpm run test         # Run tests (vitest)\n```\n\n## Web Companion \u2014 kernel.chat\n\nkbot has a web companion at [kernel.chat](https://kernel.chat) \u2014 same agents, persistent memory, and a visual interface. Free to use (20 messages/day).\n\n## Community\n\n- **Web**: [kernel.chat](https://kernel.chat)\n- **npm**: [@kernel.chat/kbot](https://www.npmjs.com/package/@kernel.chat/kbot)\n- **Discord**: [discord.gg/kdMauM9abG](https://discord.gg/kdMauM9abG)\n- **GitHub**: [isaacsight/kernel](https://github.com/isaacsight/kernel)\n- **Issues**: [Report a bug](https://github.com/isaacsight/kernel/issues)\n\n## License\n\n[MIT](LICENSE) \u2014 [kernel.chat group](https://kernel.chat)\n",
+  "readmeFilename": "README.md"
 }