@toolkit-cli/toolkode 1.3.14 → 1.4.1
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.
- package/LICENSE +40 -0
- package/README.md +90 -0
- package/bin/toolkode.cjs +11 -9
- package/package.json +39 -18
- package/bin/toolkode +0 -17
package/LICENSE
ADDED
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
Toolkode Software License Agreement
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Toolkit-CLI LLC. All rights reserved.
|
|
4
|
+
|
|
5
|
+
TERMS AND CONDITIONS
|
|
6
|
+
|
|
7
|
+
1. Grant of License. Subject to the terms of this Agreement, Toolkit-CLI LLC
|
|
8
|
+
("Licensor") grants you a limited, non-exclusive, non-transferable,
|
|
9
|
+
non-sublicensable license to use the toolkode software ("Software") solely
|
|
10
|
+
for your personal or internal business purposes.
|
|
11
|
+
|
|
12
|
+
2. Restrictions. You may not:
|
|
13
|
+
(a) modify, adapt, translate, reverse engineer, decompile, or disassemble
|
|
14
|
+
the Software;
|
|
15
|
+
(b) create derivative works based on the Software;
|
|
16
|
+
(c) distribute, sublicense, lease, rent, loan, or otherwise transfer the
|
|
17
|
+
Software to any third party;
|
|
18
|
+
(d) remove or alter any proprietary notices, labels, or marks on the
|
|
19
|
+
Software;
|
|
20
|
+
(e) use the Software to build a competing product or service.
|
|
21
|
+
|
|
22
|
+
3. Ownership. The Software is licensed, not sold. Licensor retains all right,
|
|
23
|
+
title, and interest in and to the Software, including all intellectual
|
|
24
|
+
property rights therein.
|
|
25
|
+
|
|
26
|
+
4. Termination. This license is effective until terminated. It will terminate
|
|
27
|
+
automatically if you fail to comply with any term of this Agreement. Upon
|
|
28
|
+
termination, you must destroy all copies of the Software.
|
|
29
|
+
|
|
30
|
+
5. Disclaimer of Warranties. THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY
|
|
31
|
+
OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
|
|
32
|
+
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
33
|
+
|
|
34
|
+
6. Limitation of Liability. IN NO EVENT SHALL LICENSOR BE LIABLE FOR ANY
|
|
35
|
+
INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR PUNITIVE DAMAGES ARISING
|
|
36
|
+
OUT OF OR RELATED TO YOUR USE OF THE SOFTWARE.
|
|
37
|
+
|
|
38
|
+
7. General. This Agreement constitutes the entire agreement between you and
|
|
39
|
+
Licensor regarding the Software. This Agreement shall be governed by the
|
|
40
|
+
laws of the State of Delaware without regard to conflict of law principles.
|
package/README.md
ADDED
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# toolkode
|
|
2
|
+
|
|
3
|
+
The AI engineering terminal. Free.
|
|
4
|
+
|
|
5
|
+
Write code. Run agents. Ship faster.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm i -g @toolkit-cli/toolkode
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Or via Homebrew:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
brew install aaronmrosenthal/tap/toolkode
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Usage
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
# Start the TUI
|
|
23
|
+
toolkode
|
|
24
|
+
|
|
25
|
+
# Start in a specific directory
|
|
26
|
+
toolkode /path/to/project
|
|
27
|
+
|
|
28
|
+
# Continue the last session
|
|
29
|
+
toolkode --continue
|
|
30
|
+
|
|
31
|
+
# Run a one-shot prompt
|
|
32
|
+
toolkode --prompt "fix the failing tests"
|
|
33
|
+
|
|
34
|
+
# Start the HTTP server
|
|
35
|
+
toolkode serve
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## Features
|
|
39
|
+
|
|
40
|
+
- **Multi-provider** — Anthropic, OpenAI, Google, OpenRouter, GitHub Copilot, local models via Ollama
|
|
41
|
+
- **Subagents** — Spawn parallel agents for complex tasks with `team` and `batch` tools
|
|
42
|
+
- **MCP servers** — Connect external tools via the Model Context Protocol
|
|
43
|
+
- **Vim mode** — Full vim keybindings in the prompt editor
|
|
44
|
+
- **Skills marketplace** — 90K+ community skills from skills.sh
|
|
45
|
+
- **Themes** — 59 built-in themes
|
|
46
|
+
- **Spec-kit workflow** — /specify, /plan, /tasks, /implement
|
|
47
|
+
- **Cron/loop** — Schedule recurring prompts within a session
|
|
48
|
+
- **Private by default** — No telemetry, no data collection, no hidden network calls
|
|
49
|
+
|
|
50
|
+
## Configuration
|
|
51
|
+
|
|
52
|
+
Config file: `~/.config/toolkode/config.json` or `toolkode.json` in your project root.
|
|
53
|
+
|
|
54
|
+
```json
|
|
55
|
+
{
|
|
56
|
+
"provider": {
|
|
57
|
+
"anthropic": {
|
|
58
|
+
"apiKey": "sk-..."
|
|
59
|
+
}
|
|
60
|
+
},
|
|
61
|
+
"model": "anthropic/claude-sonnet-4-6"
|
|
62
|
+
}
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## SDK
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
npm i @toolkit-cli/sdk
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
```typescript
|
|
72
|
+
import { createClient } from "@toolkit-cli/sdk/v2"
|
|
73
|
+
|
|
74
|
+
const client = createClient({ url: "http://localhost:4096" })
|
|
75
|
+
const session = await client.session.create({})
|
|
76
|
+
await client.session.prompt({
|
|
77
|
+
sessionID: session.data.id,
|
|
78
|
+
parts: [{ type: "text", text: "hello" }],
|
|
79
|
+
})
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## Links
|
|
83
|
+
|
|
84
|
+
- Website: [toolkode.com](https://toolkode.com)
|
|
85
|
+
- Releases: [github.com/aaronmrosenthal/toolkode-releases](https://github.com/aaronmrosenthal/toolkode-releases)
|
|
86
|
+
- Issues: [github.com/aaronmrosenthal/toolkode-releases/issues](https://github.com/aaronmrosenthal/toolkode-releases/issues)
|
|
87
|
+
|
|
88
|
+
## License
|
|
89
|
+
|
|
90
|
+
Copyright (c) 2026 Toolkit-CLI LLC. All rights reserved. See [LICENSE](./LICENSE) for details.
|
package/bin/toolkode.cjs
CHANGED
|
@@ -167,15 +167,17 @@ if (resolved) {
|
|
|
167
167
|
run(resolved)
|
|
168
168
|
}
|
|
169
169
|
|
|
170
|
-
// Dev fallback: no compiled binary found — run via bun directly
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
170
|
+
// Dev fallback: no compiled binary found — run via bun directly (dev only)
|
|
171
|
+
if (process.env.TOOLKODE_DEV) {
|
|
172
|
+
const srcEntry = path.join(scriptDir, "..", "src", "index.ts")
|
|
173
|
+
if (fs.existsSync(srcEntry)) {
|
|
174
|
+
const result = childProcess.spawnSync(
|
|
175
|
+
"bun",
|
|
176
|
+
["run", "--conditions=browser", srcEntry, ...process.argv.slice(2)],
|
|
177
|
+
{ stdio: "inherit" }
|
|
178
|
+
)
|
|
179
|
+
process.exit(typeof result.status === "number" ? result.status : 0)
|
|
180
|
+
}
|
|
179
181
|
}
|
|
180
182
|
|
|
181
183
|
console.error(
|
package/package.json
CHANGED
|
@@ -1,27 +1,48 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@toolkit-cli/toolkode",
|
|
3
|
-
"version": "1.3.14",
|
|
4
|
-
"description": "The AI engineering terminal. Free.",
|
|
5
|
-
"license": "MIT",
|
|
6
|
-
"homepage": "https://toolkode.com",
|
|
7
3
|
"bin": {
|
|
8
4
|
"toolkode": "./bin/toolkode.cjs"
|
|
9
5
|
},
|
|
6
|
+
"files": [
|
|
7
|
+
"bin/toolkode.cjs",
|
|
8
|
+
"postinstall.mjs",
|
|
9
|
+
"LICENSE",
|
|
10
|
+
"README.md"
|
|
11
|
+
],
|
|
10
12
|
"scripts": {
|
|
11
|
-
"postinstall": "
|
|
13
|
+
"postinstall": "bun ./postinstall.mjs || node ./postinstall.mjs"
|
|
14
|
+
},
|
|
15
|
+
"version": "1.4.1",
|
|
16
|
+
"license": "SEE LICENSE IN LICENSE",
|
|
17
|
+
"description": "The AI engineering terminal. Free. Write code. Run agents. Ship faster.",
|
|
18
|
+
"homepage": "https://toolkode.com",
|
|
19
|
+
"repository": {
|
|
20
|
+
"type": "git",
|
|
21
|
+
"url": "https://github.com/aaronmrosenthal/toolkode-releases"
|
|
12
22
|
},
|
|
23
|
+
"keywords": [
|
|
24
|
+
"ai",
|
|
25
|
+
"terminal",
|
|
26
|
+
"coding-agent",
|
|
27
|
+
"cli",
|
|
28
|
+
"llm",
|
|
29
|
+
"code-generation",
|
|
30
|
+
"subagents",
|
|
31
|
+
"mcp",
|
|
32
|
+
"toolkode"
|
|
33
|
+
],
|
|
13
34
|
"optionalDependencies": {
|
|
14
|
-
"@toolkit-cli/toolkode-darwin-arm64": "
|
|
15
|
-
"@toolkit-cli/toolkode-darwin-x64": "
|
|
16
|
-
"@toolkit-cli/toolkode-darwin-x64
|
|
17
|
-
"@toolkit-cli/toolkode-linux-arm64": "
|
|
18
|
-
"@toolkit-cli/toolkode-linux-arm64
|
|
19
|
-
"@toolkit-cli/toolkode-linux-x64": "
|
|
20
|
-
"@toolkit-cli/toolkode-linux-x64-baseline": "
|
|
21
|
-
"@toolkit-cli/toolkode-linux-x64-musl": "
|
|
22
|
-
"@toolkit-cli/toolkode-linux-x64
|
|
23
|
-
"@toolkit-cli/toolkode-windows-arm64": "
|
|
24
|
-
"@toolkit-cli/toolkode-windows-x64": "
|
|
25
|
-
"@toolkit-cli/toolkode-windows-x64
|
|
35
|
+
"@toolkit-cli/toolkode-darwin-arm64": "1.4.1",
|
|
36
|
+
"@toolkit-cli/toolkode-darwin-x64-baseline": "1.4.1",
|
|
37
|
+
"@toolkit-cli/toolkode-darwin-x64": "1.4.1",
|
|
38
|
+
"@toolkit-cli/toolkode-linux-arm64-musl": "1.4.1",
|
|
39
|
+
"@toolkit-cli/toolkode-linux-arm64": "1.4.1",
|
|
40
|
+
"@toolkit-cli/toolkode-linux-x64-baseline-musl": "1.4.1",
|
|
41
|
+
"@toolkit-cli/toolkode-linux-x64-baseline": "1.4.1",
|
|
42
|
+
"@toolkit-cli/toolkode-linux-x64-musl": "1.4.1",
|
|
43
|
+
"@toolkit-cli/toolkode-linux-x64": "1.4.1",
|
|
44
|
+
"@toolkit-cli/toolkode-windows-arm64": "1.4.1",
|
|
45
|
+
"@toolkit-cli/toolkode-windows-x64-baseline": "1.4.1",
|
|
46
|
+
"@toolkit-cli/toolkode-windows-x64": "1.4.1"
|
|
26
47
|
}
|
|
27
|
-
}
|
|
48
|
+
}
|
package/bin/toolkode
DELETED
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
#!/bin/bash
|
|
2
|
-
# tk_ toolkode — resolve and run
|
|
3
|
-
SOURCE="${BASH_SOURCE[0]}"
|
|
4
|
-
while [ -L "$SOURCE" ]; do
|
|
5
|
-
DIR="$(cd "$(dirname "$SOURCE")" && pwd)"
|
|
6
|
-
SOURCE="$(readlink "$SOURCE")"
|
|
7
|
-
[[ $SOURCE != /* ]] && SOURCE="$DIR/$SOURCE"
|
|
8
|
-
done
|
|
9
|
-
DIR="$(cd "$(dirname "$SOURCE")" && pwd)"
|
|
10
|
-
|
|
11
|
-
# Dev mode: run source via bun if src/index.ts exists
|
|
12
|
-
if [ -f "$DIR/../src/index.ts" ]; then
|
|
13
|
-
exec bun run --conditions=browser "$DIR/../src/index.ts" "$@"
|
|
14
|
-
fi
|
|
15
|
-
|
|
16
|
-
# Production: run compiled .cjs shim
|
|
17
|
-
exec node "$DIR/toolkode.cjs" "$@"
|