chutes-build 0.1.0 → 0.3.0
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/README.md +124 -57
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -1,65 +1,54 @@
|
|
|
1
1
|
# Chutes Build
|
|
2
2
|
|
|
3
|
+
**A privacy-first, open-source coding agent built for the [Chutes](https://chutes.ai) ecosystem.**
|
|
4
|
+
|
|
3
5
|
[](https://github.com/TheStreamCode/chutes-build/actions/workflows/ci.yml)
|
|
4
6
|
[](https://www.npmjs.com/package/chutes-build)
|
|
5
7
|
[](LICENSE)
|
|
6
8
|
|
|
7
|
-
Chutes Build
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
One CLI, no compromises: an interactive terminal UI, a full coding agent
|
|
12
|
+
runtime, native Chutes model routing, parallel subagents, multimodal
|
|
13
|
+
generation, web research, browser automation, and local memory — with
|
|
14
|
+
telemetry, remote trace upload, and phone-home update checks off by default.
|
|
11
15
|
|
|
12
16
|
|
|
13
17
|
|
|
14
18
|
> **Development preview:** the project is under active development. Build it
|
|
15
19
|
> from source and review agent actions before approving changes.
|
|
16
20
|
|
|
17
|
-
##
|
|
21
|
+
## Contents
|
|
22
|
+
|
|
23
|
+
- [Highlights](#highlights)
|
|
24
|
+
- [Quick start](#quick-start)
|
|
25
|
+
- [Features](#features)
|
|
26
|
+
- [Configuration](#configuration)
|
|
27
|
+
- [Privacy & security](#privacy--security)
|
|
28
|
+
- [Project](#project)
|
|
29
|
+
|
|
30
|
+
## Highlights
|
|
31
|
+
|
|
32
|
+
- 🔒 **Privacy by construction** — telemetry, remote error reporting, automatic
|
|
33
|
+
update checks, remote trace upload, and upstream session sharing are all
|
|
34
|
+
disabled by default.
|
|
35
|
+
- ⚡ **Chutes-native inference** — live model discovery, `Auto (Chutes Router)`
|
|
36
|
+
as the default, and automatic fallback when a model is temporarily
|
|
37
|
+
unavailable.
|
|
38
|
+
- 🧭 **Advisor** — an on-demand reasoning agent that reviews plans, blockers,
|
|
39
|
+
and completion claims without ever taking over the executor loop.
|
|
40
|
+
- 🧩 **Subagent orchestration** — concurrent fan-out with isolated worktrees
|
|
41
|
+
for real parallel decomposition, not just sequential delegation.
|
|
42
|
+
- 🎨 **Multimodal, natively** — image, video, music, speech, and on-demand OCR,
|
|
43
|
+
built directly into the Rust runtime instead of a bolted-on MCP process.
|
|
44
|
+
- 🧠 **Hybrid memory & voice** — full-text plus semantic vector recall, and
|
|
45
|
+
hold-to-record voice dictation, both on by default.
|
|
46
|
+
|
|
47
|
+
See [Features](#features) below for the complete list.
|
|
18
48
|
|
|
19
|
-
|
|
20
|
-
`Auto (Chutes Router)` as the first model choice, configurable fallback
|
|
21
|
-
chains, and automatic retry when a selected model is temporarily unavailable.
|
|
22
|
-
- **Coding agent runtime:** repository inspection, edits, shell commands,
|
|
23
|
-
planning, goals, MCP servers, skills, sessions, worktrees, and permission
|
|
24
|
-
controls inherited from the mature upstream runtime.
|
|
25
|
-
- **Advisor:** a read-only, on-demand reasoning agent that reviews plans,
|
|
26
|
-
difficult decisions, blockers, and completion claims without taking over the
|
|
27
|
-
executor loop.
|
|
28
|
-
- **Subagent orchestration:** foreground and background workers, concurrent
|
|
29
|
-
fan-out, multi-worker waits, bounded nesting, and isolated worktrees. The
|
|
30
|
-
`chutes-build-orchestrator` preset is tuned for parallel decomposition.
|
|
31
|
-
- **Chutes account:** read-only subscription, quota, and usage access through
|
|
32
|
-
`get_chutes_usage`, a compact plan/quota indicator in the TUI, and detailed
|
|
33
|
-
`/usage` output. Per-model statistics remain disabled unless requested.
|
|
34
|
-
- **Chutes media:** live discovery and invocation for image generation and
|
|
35
|
-
editing, video, music, speech, and other supported Chutes media models through
|
|
36
|
-
`list_media_models`, `describe_media_model`, and `generate_media`. This is the
|
|
37
|
-
native Rust integration of the `chutes-media-mcp` workflow, so Chutes Build
|
|
38
|
-
does not need to spawn a separate Node/MCP process for its core media tools.
|
|
39
|
-
Generated output crosses the tool/ACP/TUI boundary as a typed artifact:
|
|
40
|
-
images use bounded lazy previews, videos use a two-frame rolling decoder,
|
|
41
|
-
and music/speech expose local pause/resume, seek, volume, duration, and
|
|
42
|
-
waveform controls with native-player fallback. Media work starts only while
|
|
43
|
-
inference is idle, never autoplays, and stays off the TUI render thread.
|
|
44
|
-
- **Capability routing:** image inputs stay with the selected model when it
|
|
45
|
-
supports vision and are otherwise delegated to a vision-capable Chutes route.
|
|
46
|
-
- **Current coding documentation:** Context7 search and documentation tools are
|
|
47
|
-
built in and avoid sending credentials or known secrets.
|
|
48
|
-
- **Official Chutes research:** before answering Chutes-specific questions, the
|
|
49
|
-
main agent and subagents consult both the official
|
|
50
|
-
[documentation](https://chutes.ai/docs) and [news](https://chutes.ai/news),
|
|
51
|
-
treating directly relevant official pages as primary authority.
|
|
52
|
-
- **Research and browser tools:** native web search (DuckDuckGo by default,
|
|
53
|
-
optionally Brave) plus agentic Chrome/Edge control through a local DevTools
|
|
54
|
-
connection and an isolated temporary browser profile.
|
|
55
|
-
- **Local memory:** Chutes Build maintains a secret-filtered `memories.md` file
|
|
56
|
-
and can be launched with `--no-memory` when a stateless session is preferred.
|
|
57
|
-
- **Time awareness and wellness:** the agent receives the local date, time, and
|
|
58
|
-
timezone and can suggest a break after long or late sessions.
|
|
59
|
-
- **Privacy by construction:** telemetry, remote error reporting, automatic
|
|
60
|
-
update checks, remote trace upload, and upstream session sharing are disabled.
|
|
49
|
+
## Quick start
|
|
61
50
|
|
|
62
|
-
|
|
51
|
+
### Install with npm
|
|
63
52
|
|
|
64
53
|
Release builds install without a Rust toolchain:
|
|
65
54
|
|
|
@@ -77,7 +66,7 @@ npx chutes-build
|
|
|
77
66
|
The npm launcher selects a native binary for Windows, macOS, or Linux. It does
|
|
78
67
|
not collect telemetry and does not download executables from an install script.
|
|
79
68
|
|
|
80
|
-
|
|
69
|
+
### Build from source
|
|
81
70
|
|
|
82
71
|
Prerequisites:
|
|
83
72
|
|
|
@@ -97,7 +86,7 @@ cargo build -p chutes-build --release
|
|
|
97
86
|
The Windows executable is `target\release\chutes-build.exe`; on macOS and
|
|
98
87
|
Linux it is `target/release/chutes-build`.
|
|
99
88
|
|
|
100
|
-
|
|
89
|
+
### First run
|
|
101
90
|
|
|
102
91
|
Run `chutes-build` with no prior setup and log in from the welcome screen:
|
|
103
92
|
press `l` for "Login with Chutes" (opens your browser) or `k` to paste a
|
|
@@ -124,7 +113,81 @@ when no preference has been saved. Select a concrete model with `/model` or
|
|
|
124
113
|
`chutes-build --model <model-id>`. Inspect the resolved catalog with
|
|
125
114
|
`chutes-build models`.
|
|
126
115
|
|
|
127
|
-
##
|
|
116
|
+
## Features
|
|
117
|
+
|
|
118
|
+
### Agent & coding
|
|
119
|
+
|
|
120
|
+
- **Coding agent runtime:** repository inspection, edits, shell commands,
|
|
121
|
+
planning, goals, MCP servers, skills, sessions, worktrees, and permission
|
|
122
|
+
controls inherited from the mature upstream runtime.
|
|
123
|
+
- **Advisor:** a read-only, on-demand reasoning agent that reviews plans,
|
|
124
|
+
difficult decisions, blockers, and completion claims without taking over the
|
|
125
|
+
executor loop. Reasons at maximum effort by default. `/advisor on|off`
|
|
126
|
+
toggles it; `/advisor <model>` pins a specific model (e.g. your largest or
|
|
127
|
+
highest-tier available one — Chutes' catalog carries no price/size metadata
|
|
128
|
+
to pick one automatically); `/advisor default` clears the pin.
|
|
129
|
+
- **Subagent orchestration:** foreground and background workers, concurrent
|
|
130
|
+
fan-out, multi-worker waits, bounded nesting, and isolated worktrees. The
|
|
131
|
+
`chutes-build-orchestrator` preset is tuned for parallel decomposition.
|
|
132
|
+
|
|
133
|
+
### Chutes integration
|
|
134
|
+
|
|
135
|
+
- **Chutes-native inference:** API-key authentication, live model discovery,
|
|
136
|
+
`Auto (Chutes Router)` as the first model choice, configurable fallback
|
|
137
|
+
chains, and automatic retry when a selected model is temporarily unavailable.
|
|
138
|
+
- **Chutes account:** read-only subscription, quota, and usage access through
|
|
139
|
+
`get_chutes_usage`, a compact plan/quota indicator in the TUI, and detailed
|
|
140
|
+
`/usage` output. Per-model statistics remain disabled unless requested.
|
|
141
|
+
- **Chutes media:** live discovery and invocation for image generation and
|
|
142
|
+
editing, video, music, speech, and other supported Chutes media models through
|
|
143
|
+
`list_media_models`, `describe_media_model`, and `generate_media`. This is the
|
|
144
|
+
native Rust integration of the `chutes-media-mcp` workflow, so Chutes Build
|
|
145
|
+
does not need to spawn a separate Node/MCP process for its core media tools.
|
|
146
|
+
Generated output crosses the tool/ACP/TUI boundary as a typed artifact:
|
|
147
|
+
images use bounded lazy previews, videos use a two-frame rolling decoder,
|
|
148
|
+
and music/speech expose local pause/resume, seek, volume, duration, and
|
|
149
|
+
waveform controls with native-player fallback. Media work starts only while
|
|
150
|
+
inference is idle, never autoplays, and stays off the TUI render thread.
|
|
151
|
+
- **Capability routing:** image inputs stay with the selected model when it
|
|
152
|
+
supports vision and are otherwise delegated to a vision-capable Chutes route.
|
|
153
|
+
- **On-demand OCR:** the `ocr_page` tool extracts text verbatim from a single
|
|
154
|
+
image or PDF page via a dedicated Chutes vision model, independent of the
|
|
155
|
+
active chat model's vision support. Returns extracted text only — the image
|
|
156
|
+
itself is never added to the conversation.
|
|
157
|
+
|
|
158
|
+
### Research & tools
|
|
159
|
+
|
|
160
|
+
- **Current coding documentation:** Context7 search and documentation tools are
|
|
161
|
+
built in and avoid sending credentials or known secrets.
|
|
162
|
+
- **Official Chutes research:** before answering Chutes-specific questions, the
|
|
163
|
+
main agent and subagents consult both the official
|
|
164
|
+
[documentation](https://chutes.ai/docs) and [news](https://chutes.ai/news),
|
|
165
|
+
treating directly relevant official pages as primary authority.
|
|
166
|
+
- **Research and browser tools:** native web search (DuckDuckGo by default,
|
|
167
|
+
optionally Brave) plus agentic Chrome/Edge control through a local DevTools
|
|
168
|
+
connection and an isolated temporary browser profile.
|
|
169
|
+
|
|
170
|
+
### Memory & voice
|
|
171
|
+
|
|
172
|
+
- **Local memory:** Chutes Build maintains a secret-filtered `memories.md` file
|
|
173
|
+
and can be launched with `--no-memory` when a stateless session is preferred.
|
|
174
|
+
Recall is hybrid by default — full-text search combined with semantic vector
|
|
175
|
+
search against a built-in Chutes-hosted embedding model.
|
|
176
|
+
- **Voice input:** hold-to-record dictation transcribes speech into the prompt
|
|
177
|
+
box. Enabled by default; activation is always manual (mic icon, `/voice`, or
|
|
178
|
+
Ctrl+Space) — Chutes Build never records without an explicit press.
|
|
179
|
+
- **Time awareness and wellness:** the agent receives the local date, time, and
|
|
180
|
+
timezone and can suggest a break after long or late sessions.
|
|
181
|
+
|
|
182
|
+
### Privacy by construction
|
|
183
|
+
|
|
184
|
+
Telemetry, remote error reporting, automatic update checks, remote trace
|
|
185
|
+
upload, and upstream session sharing are disabled. See
|
|
186
|
+
[Privacy & security](#privacy--security) below for the full data boundary.
|
|
187
|
+
|
|
188
|
+
## Configuration
|
|
189
|
+
|
|
190
|
+
### Model selection, reasoning, and routing
|
|
128
191
|
|
|
129
192
|
Auto sends `model-router` requests to the Chutes router endpoint, allowing the
|
|
130
193
|
service to select a model for the task and handle cold or unavailable capacity.
|
|
@@ -162,7 +225,7 @@ remain router decisions.
|
|
|
162
225
|
Selecting `Instant` can reduce reasoning latency, but it intentionally changes
|
|
163
226
|
the model's reasoning behavior and is never enabled silently.
|
|
164
227
|
|
|
165
|
-
|
|
228
|
+
### Account plan and quota
|
|
166
229
|
|
|
167
230
|
When authenticated, Chutes Build fetches subscription usage, plan metadata, and
|
|
168
231
|
quota data concurrently. The TUI status bar shows the plan plus the rolling
|
|
@@ -172,7 +235,7 @@ run `/usage` for every active window, percentage, and reset time. If aggregate
|
|
|
172
235
|
quota usage is unavailable, the client falls back concurrently to the
|
|
173
236
|
documented per-chute quota endpoints.
|
|
174
237
|
|
|
175
|
-
|
|
238
|
+
### Optional web and browser configuration
|
|
176
239
|
|
|
177
240
|
Web search uses DuckDuckGo without a dedicated key. For Brave Search:
|
|
178
241
|
|
|
@@ -204,7 +267,9 @@ limited to 512 MiB by default (`CHUTES_MAX_MEDIA_BYTES`, hard ceiling 2 GiB),
|
|
|
204
267
|
while workspace inputs are limited to 64 MiB by default
|
|
205
268
|
(`CHUTES_MAX_INPUT_ASSET_BYTES`, hard ceiling 512 MiB).
|
|
206
269
|
|
|
207
|
-
##
|
|
270
|
+
## Privacy & security
|
|
271
|
+
|
|
272
|
+
### Local data
|
|
208
273
|
|
|
209
274
|
User-level state defaults to `~/.chutes-build` or the directory set in
|
|
210
275
|
`CHUTES_BUILD_HOME`. Project memory is stored in `memories.md`. Configuration,
|
|
@@ -213,7 +278,7 @@ explicitly calls an external service.
|
|
|
213
278
|
|
|
214
279
|
See [PRIVACY.md](PRIVACY.md) for the exact network and data boundaries.
|
|
215
280
|
|
|
216
|
-
|
|
281
|
+
### Security model
|
|
217
282
|
|
|
218
283
|
Chutes Build is an agent capable of reading files, running commands, editing
|
|
219
284
|
code, and controlling an isolated browser. Use it only in repositories you
|
|
@@ -222,7 +287,9 @@ for sensitive work. Never place API keys in prompts, source files, or committed
|
|
|
222
287
|
configuration. See the [security review](docs/security-review.md) for release
|
|
223
288
|
controls, trust boundaries, and tracked dependency exceptions.
|
|
224
289
|
|
|
225
|
-
## Project
|
|
290
|
+
## Project
|
|
291
|
+
|
|
292
|
+
### Provenance
|
|
226
293
|
|
|
227
294
|
Chutes Build is a substantially modified fork of
|
|
228
295
|
[`xai-org/grok-build`](https://github.com/xai-org/grok-build). The upstream
|
|
@@ -237,7 +304,7 @@ and reviewed through the documented [upstream synchronization
|
|
|
237
304
|
procedure](docs/upstream-sync.md); upstream changes are never merged or released
|
|
238
305
|
automatically.
|
|
239
306
|
|
|
240
|
-
|
|
307
|
+
### Contributing
|
|
241
308
|
|
|
242
309
|
Issues and focused pull requests are welcome. Read
|
|
243
310
|
[CONTRIBUTING.md](CONTRIBUTING.md), [SECURITY.md](SECURITY.md), and
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "chutes-build",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"description": "Privacy-first coding agent optimized for the Chutes ecosystem",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"author": "Michael Gasperini (Mikesoft)",
|
|
@@ -34,12 +34,12 @@
|
|
|
34
34
|
"verify:release": "node npm/scripts/verify-release.mjs"
|
|
35
35
|
},
|
|
36
36
|
"optionalDependencies": {
|
|
37
|
-
"chutes-build-darwin-arm64": "0.
|
|
38
|
-
"chutes-build-darwin-x64": "0.
|
|
39
|
-
"chutes-build-linux-arm64-gnu": "0.
|
|
40
|
-
"chutes-build-linux-x64-gnu": "0.
|
|
41
|
-
"chutes-build-win32-arm64": "0.
|
|
42
|
-
"chutes-build-win32-x64": "0.
|
|
37
|
+
"chutes-build-darwin-arm64": "0.3.0",
|
|
38
|
+
"chutes-build-darwin-x64": "0.3.0",
|
|
39
|
+
"chutes-build-linux-arm64-gnu": "0.3.0",
|
|
40
|
+
"chutes-build-linux-x64-gnu": "0.3.0",
|
|
41
|
+
"chutes-build-win32-arm64": "0.3.0",
|
|
42
|
+
"chutes-build-win32-x64": "0.3.0"
|
|
43
43
|
},
|
|
44
44
|
"keywords": [
|
|
45
45
|
"ai",
|