gearbox-code 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gearbox contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# ⚙ gearbox
+
+A beautiful, simple coding harness for the terminal. It reads, edits, and runs your code through one clean agent loop, talking to any provider (Anthropic, OpenAI, Google, DeepSeek).
+
+> **What it does:** the point of Gearbox is *intelligent per-task model routing* — automatically using the right model for each task across every provider and account you pay for, cheaply and transparently. Basic routing is live: it classifies each task, filters candidates by quality bar, and picks the cheapest one that fits. The richer engine (shadow-eval, credit/limit scoring, confidence display) layers on top. See [`DESIGN.md`](./DESIGN.md).
+
+```
+ ⚙   gearbox
+     coding harness · sonnet-4.6
+ ──────────────────────────────────────────────────────────
+
+ › add a --json flag to the CLI and cover it with a test
+
+ ⏺  I'll see how args are parsed, add the flag, then test it.
+
+   ✓ read_file  src/cli.tsx
+     renders the Ink app · 18 lines
+   ✓ edit_file  src/cli.tsx
+   ✓ run_shell  bun test
+     9 pass · 0 fail
+
+ ⏺  Done — flag added with a passing test.
+
+ ╭──────────────────────────────────────────────────────────╮
+ │ › ask gearbox to build or fix something                  │
+ ╰──────────────────────────────────────────────────────────╯
+  gearbox · sonnet-4.6 · 18,432 tok · ⏎ send  ctrl+c quit
+```
+
+## Run
+
+```bash
+bun install
+export ANTHROPIC_API_KEY=...   # or OPENAI_API_KEY / GOOGLE_GENERATIVE_AI_API_KEY / DEEPSEEK_API_KEY
+bun start                      # or: bun run src/cli.tsx
+bun start -- --model gemini-flash   # pick a model
+```
+
+No key? It launches in demo mode so you can see the interface. Preview the look without running anything:
+
+```bash
+bun run scripts/preview.tsx
+```
+
+## Install for internal use (the `gearbox` command, anywhere)
+
+Requires [Bun](https://bun.sh). Clone the repo, then:
+
+```bash
+./install.sh          # bun install + bun link  → 'gearbox' on your PATH
+export ANTHROPIC_API_KEY=...   # each person uses their own key (add to ~/.zshrc)
+cd ~/any/project && gearbox    # the current directory is the workspace
+```
+
+**Upgrade** later with one command — `gearbox upgrade` (pulls latest + reinstalls deps). Equivalent to `git pull && bun install` in the repo. If `gearbox` isn't found, add Bun's bin dir to PATH: `export PATH="$HOME/.bun/bin:$PATH"`.
+
+**Standalone binary** (no clone/install on the target, same OS/arch):
+
+```bash
+bun run build         # → dist/gearbox  (single ~64MB executable)
+cp dist/gearbox ~/.bun/bin/    # or anywhere on PATH; share the file directly
+```
+
+> ⚠ **Before running on real code:** there is no permission/confirm gate yet — `write_file`, `edit_file`, `run_shell`, and the `!` prefix execute without asking. Fine for trusted internal use on your own repos; do not point it at anything you don't want modified. A confirm-gate is the next thing to land.
+
+## Develop
+
+```bash
+bun test            # render + agent tests (no API key needed)
+bun run typecheck
+```
+
+## Principles
+
+- **Open + free.** MIT. No paid dependencies, no hosted backend, no telemetry. The only cost is your own model calls on your own keys.
+- **Beautiful + calm.** One accent color, generous spacing, consistent glyphs. The whole look lives in `src/ui/theme.ts`.
+- **Routing-ready.** Model choice happens in exactly one place (`src/model/selector.ts`); the router drops in there later with no changes upstream. See [`CLAUDE.md`](./CLAUDE.md).
+
+## Status
+
+v0.1 — streaming agent loop, real file + shell tools, a polished Ink TUI, multi-provider support, accounts + spend ledger, BM25 context retrieval, and basic per-task routing (classify → quality bar → cheapest winner). The richer routing engine (shadow-eval, credit/limit/plan scoring, per-repo calibration) is next (`DESIGN.md`).