@toolkit-cli/toolkode 1.3.15 → 1.9.0

package/LICENSE

@@ -0,0 +1,40 @@
+Toolkode Software License Agreement
+
+Copyright (c) 2026 Toolkit-CLI LLC. All rights reserved.
+
+TERMS AND CONDITIONS
+
+1. Grant of License. Subject to the terms of this Agreement, Toolkit-CLI LLC
+   ("Licensor") grants you a limited, non-exclusive, non-transferable,
+   non-sublicensable license to use the toolkode software ("Software") solely
+   for your personal or internal business purposes.
+
+2. Restrictions. You may not:
+   (a) modify, adapt, translate, reverse engineer, decompile, or disassemble
+       the Software;
+   (b) create derivative works based on the Software;
+   (c) distribute, sublicense, lease, rent, loan, or otherwise transfer the
+       Software to any third party;
+   (d) remove or alter any proprietary notices, labels, or marks on the
+       Software;
+   (e) use the Software to build a competing product or service.
+
+3. Ownership. The Software is licensed, not sold. Licensor retains all right,
+   title, and interest in and to the Software, including all intellectual
+   property rights therein.
+
+4. Termination. This license is effective until terminated. It will terminate
+   automatically if you fail to comply with any term of this Agreement. Upon
+   termination, you must destroy all copies of the Software.
+
+5. Disclaimer of Warranties. THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY
+   OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+   OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+6. Limitation of Liability. IN NO EVENT SHALL LICENSOR BE LIABLE FOR ANY
+   INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR PUNITIVE DAMAGES ARISING
+   OUT OF OR RELATED TO YOUR USE OF THE SOFTWARE.
+
+7. General. This Agreement constitutes the entire agreement between you and
+   Licensor regarding the Software. This Agreement shall be governed by the
+   laws of the State of Delaware without regard to conflict of law principles.

package/README.md

@@ -0,0 +1,113 @@
+# toolkode
+
+The AI engineering terminal. Free.
+
+Write code. Run agents. Ship faster.
+
+## Install
+
+```bash
+npm i -g @toolkit-cli/toolkode
+```
+
+Or via Homebrew:
+
+```bash
+brew install aaronmrosenthal/tap/toolkode
+```
+
+## Usage
+
+```bash
+# Start the TUI
+toolkode
+
+# Start in a specific directory
+toolkode /path/to/project
+
+# Continue the last session
+toolkode --continue
+
+# Run a one-shot prompt
+toolkode --prompt "fix the failing tests"
+
+# Start the HTTP server
+toolkode serve
+```
+
+## What's new in v1.5
+
+**Your conversations last longer and remember more.** We completely rebuilt how Toolkode manages context. Long sessions no longer lose track of what you asked for, what files you were editing, or what errors you hit. When the context window fills up, Toolkode summarizes the older history while keeping your recent work intact — instead of compressing everything at once.
+
+**Click to switch models.** The sidebar now shows your model name, and you can click it to change models instantly. Same for the agent mode. On the home screen, trending models are clickable — if you don't have the provider connected, clicking takes you straight to the setup flow. Two clicks from "I want that model" to using it.
+
+**Provider management.** The sidebar shows which providers you have connected by name with model counts, plus a clear "+ connect provider" action.
+
+**Agent inspector.** Click "Agents" in the sidebar to see what your sub-agents are doing. See their status, task, duration, files modified, and tools used. Send a nudge to steer them or stop them if they're stuck.
+
+**Agents finish what they start.** When a sub-agent goes idle with unfinished tasks, Toolkode automatically sends it a continuation prompt. No more babysitting agents that complete 80% and then go idle.
+
+**Clickable sidebar.** The model, agent mode, providers, MCP servers, and git sections are all clickable now. Click "commit" in the git section when you have changes. Click a provider to manage it.
+
+**Safe auto-updater.** Toolkode checks for updates on startup and shows a subtle sidebar banner when a new version is available. It detects your install method (npm, Homebrew, bun, pnpm, curl) and suggests the right command. Updates require explicit confirmation and won't run while a session is active.
+
+### Fixes
+
+- Arrow keys no longer hijacked by filter tabs in model picker and agent inspector. Filter cycling is now ctrl+left/right.
+- Compaction no longer triggers prematurely on tool-heavy sessions.
+- Free-tier models from third-party providers no longer auto-connect without explicit user action.
+- All dialogs now adapt to terminal width — usable on 80-col tmux panes through 176-col ultrawides.
+
+## Features
+
+- **Multi-provider** — Anthropic, OpenAI, Google, OpenRouter, GitHub Copilot, local models via Ollama
+- **Subagents** — Spawn parallel agents for complex tasks with `team` and `batch` tools
+- **MCP servers** — Connect external tools via the Model Context Protocol
+- **Vim mode** — Full vim keybindings in the prompt editor
+- **Skills marketplace** — 90K+ community skills from skills.sh
+- **Themes** — 59 built-in themes
+- **Spec-kit workflow** — /specify, /plan, /tasks, /implement
+- **Cron/loop** — Schedule recurring prompts within a session
+- **Private by default** — No telemetry, no data collection, no hidden network calls
+
+## Configuration
+
+Config file: `~/.config/toolkode/config.json` or `toolkode.json` in your project root.
+
+```json
+{
+  "provider": {
+    "anthropic": {
+      "apiKey": "sk-..."
+    }
+  },
+  "model": "anthropic/claude-sonnet-4-6"
+}
+```
+
+## SDK
+
+```bash
+npm i @toolkit-cli/sdk
+```
+
+```typescript
+import { createClient } from "@toolkit-cli/sdk/v2"
+
+const client = createClient({ url: "http://localhost:4096" })
+const session = await client.session.create({})
+await client.session.prompt({
+  sessionID: session.data.id,
+  parts: [{ type: "text", text: "hello" }],
+})
+```
+
+## Links
+
+- Website: [toolkode.com](https://toolkode.com)
+- Releases: [github.com/aaronmrosenthal/toolkode-releases](https://github.com/aaronmrosenthal/toolkode-releases)
+- Issues: [github.com/aaronmrosenthal/toolkode-releases/issues](https://github.com/aaronmrosenthal/toolkode-releases/issues)
+
+## License
+
+Copyright (c) 2026 Toolkit-CLI LLC. All rights reserved. See [LICENSE](./LICENSE) for details.

package/bin/toolkode.cjs

@@ -167,15 +167,17 @@ if (resolved) {
   run(resolved)
 }
 
-// Dev fallback: no compiled binary found — run via bun directly
-const srcEntry = path.join(scriptDir, "..", "src", "index.ts")
-if (fs.existsSync(srcEntry)) {
-  const result = childProcess.spawnSync(
-    "bun",
-    ["run", "--conditions=browser", srcEntry, ...process.argv.slice(2)],
-    { stdio: "inherit" }
-  )
-  process.exit(typeof result.status === "number" ? result.status : 0)
+// Dev fallback: no compiled binary found — run via bun directly (dev only)
+if (process.env.TOOLKODE_DEV) {
+  const srcEntry = path.join(scriptDir, "..", "src", "index.ts")
+  if (fs.existsSync(srcEntry)) {
+    const result = childProcess.spawnSync(
+      "bun",
+      ["run", "--conditions=browser", srcEntry, ...process.argv.slice(2)],
+      { stdio: "inherit" }
+    )
+    process.exit(typeof result.status === "number" ? result.status : 0)
+  }
 }
 
 console.error(

package/package.json

@@ -1,27 +1,20 @@
 {
   "name": "@toolkit-cli/toolkode",
-  "version": "1.3.15",
-  "description": "The AI engineering terminal. Free.",
-  "license": "MIT",
-  "homepage": "https://toolkode.com",
   "bin": {
     "toolkode": "./bin/toolkode.cjs"
   },
+  "files": [
+    "bin/toolkode.cjs",
+    "postinstall.mjs",
+    "LICENSE",
+    "README.md"
+  ],
   "scripts": {
-    "postinstall": "node ./postinstall.mjs || true"
+    "postinstall": "bun ./postinstall.mjs || node ./postinstall.mjs"
   },
+  "version": "1.9.0",
+  "license": "SEE LICENSE IN LICENSE",
   "optionalDependencies": {
-    "@toolkit-cli/toolkode-darwin-arm64": "0.0.0-main-202603310359",
-    "@toolkit-cli/toolkode-darwin-x64": "0.0.0-main-202603310359",
-    "@toolkit-cli/toolkode-darwin-x64-baseline": "0.0.0-main-202603310359",
-    "@toolkit-cli/toolkode-linux-arm64": "0.0.0-main-202603310359",
-    "@toolkit-cli/toolkode-linux-arm64-musl": "0.0.0-main-202603310359",
-    "@toolkit-cli/toolkode-linux-x64": "0.0.0-main-202603310359",
-    "@toolkit-cli/toolkode-linux-x64-baseline": "0.0.0-main-202603310359",
-    "@toolkit-cli/toolkode-linux-x64-musl": "0.0.0-main-202603310359",
-    "@toolkit-cli/toolkode-linux-x64-baseline-musl": "0.0.0-main-202603310359",
-    "@toolkit-cli/toolkode-windows-arm64": "0.0.0-main-202603310359",
-    "@toolkit-cli/toolkode-windows-x64": "0.0.0-main-202603310359",
-    "@toolkit-cli/toolkode-windows-x64-baseline": "0.0.0-main-202603310359"
+    "@toolkit-cli/toolkode-darwin-arm64": "1.9.0"
   }
-}
+}

package/bin/toolkode

@@ -1,17 +0,0 @@
-#!/bin/bash
-# tk_ toolkode — resolve and run
-SOURCE="${BASH_SOURCE[0]}"
-while [ -L "$SOURCE" ]; do
-  DIR="$(cd "$(dirname "$SOURCE")" && pwd)"
-  SOURCE="$(readlink "$SOURCE")"
-  [[ $SOURCE != /* ]] && SOURCE="$DIR/$SOURCE"
-done
-DIR="$(cd "$(dirname "$SOURCE")" && pwd)"
-
-# Dev mode: run source via bun if src/index.ts exists
-if [ -f "$DIR/../src/index.ts" ]; then
-  exec bun run --conditions=browser "$DIR/../src/index.ts" "$@"
-fi
-
-# Production: run compiled .cjs shim
-exec node "$DIR/toolkode.cjs" "$@"