@toolkit-cli/toolkode 1.3.8 → 1.3.9

package/package.json

@@ -1,170 +1,27 @@
 {
-  "$schema": "https://json.schemastore.org/package.json",
-  "version": "1.3.8",
   "name": "@toolkit-cli/toolkode",
-  "type": "module",
-  "license": "SEE LICENSE IN LICENSE",
-  "description": "The AI engineering terminal. Free. Write code. Run agents. Ship faster.",
-  "keywords": ["ai", "terminal", "coding-agent", "cli", "llm", "code-generation", "subagents", "mcp", "toolkode"],
+  "version": "1.3.9",
+  "description": "The AI engineering terminal. Free.",
+  "license": "MIT",
   "homepage": "https://toolkode.com",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/aaronmrosenthal/toolkode-releases"
-  },
-  "bugs": {
-    "url": "https://github.com/aaronmrosenthal/toolkode-releases/issues"
-  },
-  "scripts": {
-    "prepare": "effect-language-service patch || true",
-    "typecheck": "tsgo --noEmit",
-    "test": "bun test --timeout 30000",
-    "build": "bun run script/build.ts",
-    "upgrade-opentui": "bun run script/upgrade-opentui.ts",
-    "dev": "bun run --conditions=browser ./src/index.ts",
-    "random": "echo 'Random script updated at $(date)' && echo 'Change queued successfully' && echo 'Another change made' && echo 'Yet another change' && echo 'One more change' && echo 'Final change' && echo 'Another final change' && echo 'Yet another final change'",
-    "clean": "echo 'Cleaning up...' && rm -rf node_modules dist",
-    "lint": "echo 'Running lint checks...' && bun test --coverage",
-    "format": "echo 'Formatting code...' && bun run --prettier --write src/**/*.ts",
-    "docs": "echo 'Generating documentation...' && find src -name '*.ts' -exec echo 'Processing: {}' \\;",
-    "deploy": "echo 'Deploying application...' && bun run build && echo 'Deployment completed successfully'",
-    "db": "bun drizzle-kit"
-  },
   "bin": {
     "toolkode": "./bin/toolkode.cjs"
   },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "exports": {
-    "./*": "./src/*.ts"
-  },
-  "imports": {
-    "#db": {
-      "bun": "./src/storage/db.bun.ts",
-      "node": "./src/storage/db.node.ts",
-      "default": "./src/storage/db.bun.ts"
-    }
-  },
-  "devDependencies": {
-    "@babel/core": "7.28.4",
-    "@effect/language-service": "0.79.0",
-    "@octokit/webhooks-types": "7.6.1",
-    "@toolkit-cli/script": "workspace:*",
-    "@parcel/watcher-darwin-arm64": "2.5.1",
-    "@parcel/watcher-darwin-x64": "2.5.1",
-    "@parcel/watcher-linux-arm64-glibc": "2.5.1",
-    "@parcel/watcher-linux-arm64-musl": "2.5.1",
-    "@parcel/watcher-linux-x64-glibc": "2.5.1",
-    "@parcel/watcher-linux-x64-musl": "2.5.1",
-    "@parcel/watcher-win32-arm64": "2.5.1",
-    "@parcel/watcher-win32-x64": "2.5.1",
-    "@standard-schema/spec": "1.0.0",
-    "@tsconfig/bun": "catalog:",
-    "@types/babel__core": "7.20.5",
-    "@types/bun": "catalog:",
-    "@types/cross-spawn": "6.0.6",
-    "@types/mime-types": "3.0.1",
-    "@types/semver": "^7.5.8",
-    "@types/turndown": "5.0.5",
-    "@types/which": "3.0.4",
-    "@types/yargs": "17.0.33",
-    "@typescript/native-preview": "catalog:",
-    "drizzle-kit": "catalog:",
-    "drizzle-orm": "catalog:",
-    "typescript": "catalog:",
-    "vscode-languageserver-types": "3.17.5",
-    "why-is-node-running": "3.2.2",
-    "zod-to-json-schema": "3.24.5"
-  },
-  "dependencies": {
-    "@actions/core": "1.11.1",
-    "@actions/github": "6.0.1",
-    "@agentclientprotocol/sdk": "0.14.1",
-    "@ai-sdk/amazon-bedrock": "4.0.83",
-    "@ai-sdk/anthropic": "3.0.64",
-    "@ai-sdk/azure": "3.0.49",
-    "@ai-sdk/cerebras": "2.0.41",
-    "@ai-sdk/cohere": "3.0.27",
-    "@ai-sdk/deepinfra": "2.0.41",
-    "@ai-sdk/gateway": "3.0.80",
-    "@ai-sdk/google": "3.0.53",
-    "@ai-sdk/google-vertex": "4.0.95",
-    "@ai-sdk/groq": "3.0.31",
-    "@ai-sdk/mistral": "3.0.27",
-    "@ai-sdk/openai": "3.0.48",
-    "@ai-sdk/openai-compatible": "2.0.37",
-    "@ai-sdk/perplexity": "3.0.26",
-    "@ai-sdk/provider": "3.0.8",
-    "@ai-sdk/provider-utils": "4.0.21",
-    "@ai-sdk/togetherai": "2.0.41",
-    "@ai-sdk/vercel": "2.0.39",
-    "@ai-sdk/xai": "3.0.74",
-    "@aws-sdk/credential-providers": "3.993.0",
-    "@clack/prompts": "1.0.0-alpha.1",
-    "@effect/platform-node": "catalog:",
-    "@hono/standard-validator": "0.1.5",
-    "@hono/zod-validator": "catalog:",
-    "@modelcontextprotocol/sdk": "1.27.1",
-    "@octokit/graphql": "9.0.2",
-    "@octokit/rest": "catalog:",
-    "@openauthjs/openauth": "catalog:",
-    "@openrouter/ai-sdk-provider": "2.3.3",
-    "@opentui/core": "0.1.92",
-    "@opentui/solid": "0.1.92",
-    "@parcel/watcher": "2.5.1",
-    "@pierre/diffs": "catalog:",
-    "@solid-primitives/event-bus": "1.1.2",
-    "@solid-primitives/scheduled": "1.5.2",
-    "@standard-schema/spec": "1.0.0",
-    "@toolkit-cli/plugin": "workspace:*",
-    "@toolkit-cli/script": "workspace:*",
-    "@toolkit-cli/sdk": "workspace:*",
-    "@toolkit-cli/util": "workspace:*",
-    "@zip.js/zip.js": "2.7.62",
-    "ai": "catalog:",
-    "ai-gateway-provider": "3.1.2",
-    "bonjour-service": "1.3.0",
-    "bun-pty": "0.4.8",
-    "chokidar": "4.0.3",
-    "clipboardy": "4.0.0",
-    "cross-spawn": "^7.0.6",
-    "decimal.js": "10.5.0",
-    "diff": "catalog:",
-    "drizzle-orm": "catalog:",
-    "effect": "catalog:",
-    "fuzzysort": "3.1.0",
-    "gitlab-ai-provider": "6.0.0",
-    "glob": "13.0.5",
-    "google-auth-library": "10.5.0",
-    "gray-matter": "4.0.3",
-    "hono": "catalog:",
-    "hono-openapi": "catalog:",
-    "ignore": "7.0.5",
-    "jsonc-parser": "3.3.1",
-    "mime-types": "3.0.2",
-    "minimatch": "10.0.3",
-    "open": "10.1.2",
-    "opencode-gitlab-auth": "2.0.1",
-    "opencode-poe-auth": "0.0.1",
-    "opentui-spinner": "0.0.6",
-    "partial-json": "0.1.7",
-    "remeda": "catalog:",
-    "semver": "^7.6.3",
-    "solid-js": "catalog:",
-    "strip-ansi": "7.1.2",
-    "tree-sitter-bash": "0.25.0",
-    "turndown": "7.2.0",
-    "ulid": "catalog:",
-    "vscode-jsonrpc": "8.2.1",
-    "web-tree-sitter": "0.25.10",
-    "which": "6.0.1",
-    "xdg-basedir": "5.1.0",
-    "yargs": "18.0.0",
-    "zod": "catalog:",
-    "zod-to-json-schema": "3.24.5"
-  },
-  "overrides": {
-    "drizzle-orm": "catalog:"
+  "scripts": {
+    "postinstall": "node ./postinstall.mjs || true"
+  },
+  "optionalDependencies": {
+    "@toolkit-cli/toolkode-darwin-arm64": "0.0.0-main-202603310042",
+    "@toolkit-cli/toolkode-darwin-x64": "0.0.0-main-202603310042",
+    "@toolkit-cli/toolkode-darwin-x64-baseline": "0.0.0-main-202603310042",
+    "@toolkit-cli/toolkode-linux-arm64": "0.0.0-main-202603310042",
+    "@toolkit-cli/toolkode-linux-arm64-musl": "0.0.0-main-202603310042",
+    "@toolkit-cli/toolkode-linux-x64": "0.0.0-main-202603310042",
+    "@toolkit-cli/toolkode-linux-x64-baseline": "0.0.0-main-202603310042",
+    "@toolkit-cli/toolkode-linux-x64-musl": "0.0.0-main-202603310042",
+    "@toolkit-cli/toolkode-linux-x64-baseline-musl": "0.0.0-main-202603310042",
+    "@toolkit-cli/toolkode-windows-arm64": "0.0.0-main-202603310042",
+    "@toolkit-cli/toolkode-windows-x64": "0.0.0-main-202603310042",
+    "@toolkit-cli/toolkode-windows-x64-baseline": "0.0.0-main-202603310042"
   }
 }

package/{script/postinstall.mjs → postinstall.mjs}

@@ -49,8 +49,8 @@ function detectPlatformAndArch() {
 
 function findBinary() {
   const { platform, arch } = detectPlatformAndArch()
-  const packageName = `opencode-${platform}-${arch}`
-  const binaryName = platform === "windows" ? "opencode.exe" : "opencode"
+  const packageName = `toolkode-${platform}-${arch}`
+  const binaryName = platform === "windows" ? "toolkode.exe" : "toolkode"
 
   try {
     // Use require.resolve to find the package
@@ -89,7 +89,7 @@ function symlinkBinary(sourcePath, binaryName) {
   const { targetPath } = prepareBinDirectory(binaryName)
 
   fs.symlinkSync(sourcePath, targetPath)
-  console.log(`opencode binary symlinked: ${targetPath} -> ${sourcePath}`)
+  console.log(`toolkode binary symlinked: ${targetPath} -> ${sourcePath}`)
 
   // Verify the file exists after operation
   if (!fs.existsSync(targetPath)) {
@@ -109,7 +109,7 @@ async function main() {
     // On non-Windows platforms, just verify the binary package exists
     // Don't replace the wrapper script - it handles binary execution
     const { binaryPath } = findBinary()
-    const target = path.join(__dirname, "bin", ".opencode")
+    const target = path.join(__dirname, "bin", ".toolkode")
     if (fs.existsSync(target)) fs.unlinkSync(target)
     try {
       fs.linkSync(binaryPath, target)
@@ -118,7 +118,7 @@ async function main() {
     }
     fs.chmodSync(target, 0o755)
   } catch (error) {
-    console.error("Failed to setup opencode binary:", error.message)
+    console.error("Failed to setup toolkode binary:", error.message)
     process.exit(1)
   }
 }

package/AGENTS.md

@@ -1,69 +0,0 @@
-# opencode database guide
-
-## Database
-
-- **Schema**: Drizzle schema lives in `src/**/*.sql.ts`.
-- **Naming**: tables and columns use snake*case; join columns are `<entity>_id`; indexes are `<table>*<column>\_idx`.
-- **Migrations**: generated by Drizzle Kit using `drizzle.config.ts` (schema: `./src/**/*.sql.ts`, output: `./migration`).
-- **Command**: `bun run db generate --name <slug>`.
-- **Output**: creates `migration/<timestamp>_<slug>/migration.sql` and `snapshot.json`.
-- **Tests**: migration tests should read the per-folder layout (no `_journal.json`).
-
-# opencode Effect rules
-
-Use these rules when writing or migrating Effect code.
-
-See `specs/effect-migration.md` for the compact pattern reference and examples.
-
-## Core
-
-- Use `Effect.gen(function* () { ... })` for composition.
-- Use `Effect.fn("Domain.method")` for named/traced effects and `Effect.fnUntraced` for internal helpers.
-- `Effect.fn` / `Effect.fnUntraced` accept pipeable operators as extra arguments, so avoid unnecessary outer `.pipe()` wrappers.
-- Use `Effect.callback` for callback-based APIs.
-- Prefer `DateTime.nowAsDate` over `new Date(yield* Clock.currentTimeMillis)` when you need a `Date`.
-
-## Schemas and errors
-
-- Use `Schema.Class` for multi-field data.
-- Use branded schemas (`Schema.brand`) for single-value types.
-- Use `Schema.TaggedErrorClass` for typed errors.
-- Use `Schema.Defect` instead of `unknown` for defect-like causes.
-- In `Effect.gen` / `Effect.fn`, prefer `yield* new MyError(...)` over `yield* Effect.fail(new MyError(...))` for direct early-failure branches.
-
-## Runtime vs InstanceState
-
-- Use `makeRuntime` (from `src/effect/run-service.ts`) for all services. It returns `{ runPromise, runFork, runCallback }` backed by a shared `memoMap` that deduplicates layers.
-- Use `InstanceState` (from `src/effect/instance-state.ts`) for per-directory or per-project state that needs per-instance cleanup. It uses `ScopedCache` keyed by directory — each open project gets its own state, automatically cleaned up on disposal.
-- If two open directories should not share one copy of the service, it needs `InstanceState`.
-- Do the work directly in the `InstanceState.make` closure — `ScopedCache` handles run-once semantics. Don't add fibers, `ensure()` callbacks, or `started` flags on top.
-- Use `Effect.addFinalizer` or `Effect.acquireRelease` inside the `InstanceState.make` closure for cleanup (subscriptions, process teardown, etc.).
-- Use `Effect.forkScoped` inside the closure for background stream consumers — the fiber is interrupted when the instance is disposed.
-
-## Preferred Effect services
-
-- In effectified services, prefer yielding existing Effect services over dropping down to ad hoc platform APIs.
-- Prefer `FileSystem.FileSystem` instead of raw `fs/promises` for effectful file I/O.
-- Prefer `ChildProcessSpawner.ChildProcessSpawner` with `ChildProcess.make(...)` instead of custom process wrappers.
-- Prefer `HttpClient.HttpClient` instead of raw `fetch`.
-- Prefer `Path.Path`, `Config`, `Clock`, and `DateTime` when those concerns are already inside Effect code.
-- For background loops or scheduled tasks, use `Effect.repeat` or `Effect.schedule` with `Effect.forkScoped` in the layer definition.
-
-## Effect.cached for deduplication
-
-Use `Effect.cached` when multiple concurrent callers should share a single in-flight computation rather than storing `Fiber | undefined` or `Promise | undefined` manually. See `specs/effect-migration.md` for the full pattern.
-
-## Instance.bind — ALS for native callbacks
-
-`Instance.bind(fn)` captures the current Instance AsyncLocalStorage context and restores it synchronously when called.
-
-Use it for native addon callbacks (`@parcel/watcher`, `node-pty`, native `fs.watch`, etc.) that need to call `Bus.publish` or anything that reads `Instance.directory`.
-
-You do not need it for `setTimeout`, `Promise.then`, `EventEmitter.on`, or Effect fibers.
-
-```typescript
-const cb = Instance.bind((err, evts) => {
-  Bus.publish(MyEvent, { ... })
-})
-nativeAddon.subscribe(dir, cb)
-```

package/BUN_SHELL_MIGRATION_PLAN.md

@@ -1,136 +0,0 @@
-# Bun shell migration plan
-
-Practical phased replacement of Bun `$` calls.
-
-## Goal
-
-Replace runtime Bun shell template-tag usage in `packages/toolkode/src` with a unified `Process` API in `util/process.ts`.
-
-Keep behavior stable while improving safety, testability, and observability.
-
-Current baseline from audit:
-
-- 143 runtime command invocations across 17 files
-- 84 are git commands
-- Largest hotspots:
-  - `src/cli/cmd/github.ts` (33)
-  - `src/worktree/index.ts` (22)
-  - `src/lsp/server.ts` (21)
-  - `src/installation/index.ts` (20)
-  - `src/snapshot/index.ts` (18)
-
-## Decisions
-
-- Extend `src/util/process.ts` (do not create a separate exec module).
-- Proceed with phased migration for both git and non-git paths.
-- Keep plugin `$` compatibility in 1.x and remove in 2.0.
-
-## Non-goals
-
-- Do not remove plugin `$` compatibility in this effort.
-- Do not redesign command semantics beyond what is needed to preserve behavior.
-
-## Constraints
-
-- Keep migration phased, not big-bang.
-- Minimize behavioral drift.
-- Keep these explicit shell-only exceptions:
-  - `src/session/prompt.ts` raw command execution
-  - worktree start scripts in `src/worktree/index.ts`
-
-## Process API proposal (`src/util/process.ts`)
-
-Add higher-level wrappers on top of current spawn support.
-
-Core methods:
-
-- `Process.run(cmd, opts)`
-- `Process.text(cmd, opts)`
-- `Process.lines(cmd, opts)`
-- `Process.status(cmd, opts)`
-- `Process.shell(command, opts)` for intentional shell execution
-
-Git helpers:
-
-- `Process.git(args, opts)`
-- `Process.gitText(args, opts)`
-
-Shared options:
-
-- `cwd`, `env`, `stdin`, `stdout`, `stderr`, `abort`, `timeout`, `kill`
-- `allowFailure` / non-throw mode
-- optional redaction + trace metadata
-
-Standard result shape:
-
-- `code`, `stdout`, `stderr`, `duration_ms`, `cmd`
-- helpers like `text()` and `arrayBuffer()` where useful
-
-## Phased rollout
-
-### Phase 0: Foundation
-
-- Implement Process wrappers in `src/util/process.ts`.
-- Refactor `src/util/git.ts` to use Process only.
-- Add tests for exit handling, timeout, abort, and output capture.
-
-### Phase 1: High-impact hotspots
-
-Migrate these first:
-
-- `src/cli/cmd/github.ts`
-- `src/worktree/index.ts`
-- `src/lsp/server.ts`
-- `src/installation/index.ts`
-- `src/snapshot/index.ts`
-
-Within each file, migrate git paths first where applicable.
-
-### Phase 2: Remaining git-heavy files
-
-Migrate git-centric call sites to `Process.git*` helpers:
-
-- `src/file/index.ts`
-- `src/project/vcs.ts`
-- `src/file/watcher.ts`
-- `src/storage/storage.ts`
-- `src/cli/cmd/pr.ts`
-
-### Phase 3: Remaining non-git files
-
-Migrate residual non-git usages:
-
-- `src/cli/cmd/tui/util/clipboard.ts`
-- `src/util/archive.ts`
-- `src/file/ripgrep.ts`
-- `src/tool/bash.ts`
-- `src/cli/cmd/uninstall.ts`
-
-### Phase 4: Stabilize
-
-- Remove dead wrappers and one-off patterns.
-- Keep plugin `$` compatibility isolated and documented as temporary.
-- Create linked 2.0 task for plugin `$` removal.
-
-## Validation strategy
-
-- Unit tests for new `Process` methods and options.
-- Integration tests on hotspot modules.
-- Smoke tests for install, snapshot, worktree, and GitHub flows.
-- Regression checks for output parsing behavior.
-
-## Risk mitigation
-
-- File-by-file PRs with small diffs.
-- Preserve behavior first, simplify second.
-- Keep shell-only exceptions explicit and documented.
-- Add consistent error shaping and logging at Process layer.
-
-## Definition of done
-
-- Runtime Bun `$` usage in `packages/toolkode/src` is removed except:
-  - approved shell-only exceptions
-  - temporary plugin compatibility path (1.x)
-- Git paths use `Process.git*` consistently.
-- CI and targeted smoke tests pass.
-- 2.0 issue exists for plugin `$` removal.

package/Dockerfile

@@ -1,18 +0,0 @@
-FROM alpine AS base
-
-# Disable the runtime transpiler cache by default inside Docker containers.
-# On ephemeral containers, the cache is not useful
-ARG BUN_RUNTIME_TRANSPILER_CACHE_PATH=0
-ENV BUN_RUNTIME_TRANSPILER_CACHE_PATH=${BUN_RUNTIME_TRANSPILER_CACHE_PATH}
-RUN apk add libgcc libstdc++ ripgrep
-
-FROM base AS build-amd64
-COPY dist/opencode-linux-x64-baseline-musl/bin/opencode /usr/local/bin/opencode
-
-FROM base AS build-arm64
-COPY dist/opencode-linux-arm64-musl/bin/opencode /usr/local/bin/opencode
-
-ARG TARGETARCH
-FROM build-${TARGETARCH}
-RUN opencode --version
-ENTRYPOINT ["opencode"]

package/README.md

@@ -1,95 +0,0 @@
-# tk_ toolkode
-
-**The AI engineering terminal. Free.**
-
-```
-$ npm i -g @toolkit-cli/toolkode
-```
-
-```
-$ toolkode
-
-  fix broken tests
-
-  [agent] Reading test files
-  [agent] Found 3 failures in auth.test.ts
-  [agent] Fixing import path
-  [agent] Re-running tests
-  [agent] All tests passing
-
-  ~/project:main                                         ● tk_
-```
-
-## Install
-
-```bash
-# npm
-npm i -g @toolkit-cli/toolkode
-
-# brew
-brew install aaronmrosenthal/tap/toolkode
-
-# curl
-curl -fsSL https://toolkode.com/install | bash
-```
-
-Then: `cd your-project && toolkode`
-
-## What you get
-
-- **Spec-driven workflow** — `/specify` → `/plan` → `/tasks` → `/implement`. Not a chat app.
-- **Sub-agents** — background tasks, git worktree isolation, parallel execution
-- **Agent teams** — multiple agents coordinating on shared task lists
-- **Any model** — Toolkit-LLM, Claude, GPT, Gemini, Ollama, or any OpenAI-compatible endpoint
-- **39 bundled skills** — commit, review, debug, security-review, release-notes, and more
-- **MCP servers** — connect external tools and data sources
-- **Auto-memory** — learns your project across sessions, stored locally
-- **Hooks** — 20 events, 4 types (command, http, prompt, agent)
-- **51 themes** — gruvbox, catppuccin, dracula, nord, tokyonight, rose-pine, and retro classics
-- **Vim mode** — for when you mean it
-- **Headless mode** — `toolkode -p "fix the build"` for CI/scripts
-- **Skills marketplace** — 90K+ community skills
-- **Private by default** — no telemetry, no session sharing, your code stays local
-
-## Quick start
-
-```bash
-toolkode                        # start
-/specify "add auth"             # describe what to build
-/plan                           # design the approach
-/tasks                          # break into steps
-/implement                      # execute every task
-```
-
-Side conversations without polluting your main thread:
-
-```bash
-/ask "how does the auth middleware work?"
-```
-
-Schedule recurring checks:
-
-```bash
-/loop 5m check if the build is green
-```
-
-## Models
-
-Toolkit-LLM models included with every plan. Or bring your own:
-
-```bash
-# Use any provider
-toolkode --provider anthropic
-toolkode --provider openai
-toolkode --provider ollama --model codellama
-```
-
-## Links
-
-- [toolkode.com](https://toolkode.com) — Homepage
-- [Quickstart](https://toolkode.com/quickstart) — Get started
-- [Bug reports](https://github.com/aaronmrosenthal/toolkode-releases/issues) — Report issues
-
-## License
-
-Copyright (c) 2026 Toolkit-CLI LLC. All rights reserved. See [LICENSE](https://github.com/aaronmrosenthal/toolkode-releases/blob/main/LICENSE) for details.