@andypai/orb 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andy Pai
+
+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,349 @@
+<p align="center">
+  <img src="./assets/orb-wordmark.svg" alt="orb" width="920" />
+</p>
+
+<p align="center">
+  Voice-driven code explorer for your terminal. Ask questions about your codebase, watch tool calls live, and optionally hear answers spoken aloud while they stream.
+</p>
+
+<p align="center">
+  <img src="./assets/orb-terminal-session.svg" alt="Orb running in the terminal with live tool activity and an architecture summary." width="1100" />
+</p>
+
+## Why Orb
+
+Orb is a Bun-native terminal app for exploring real codebases with Anthropic or OpenAI models. It keeps the interface focused, shows tool activity as it happens, remembers project conversations, and can read answers aloud through `tts-gateway` or macOS `say`.
+
+## Features
+
+- **Natural language queries** - Ask questions about your code in plain English
+- **Live tool activity** - See file reads, shell commands, and exploration steps as they happen
+- **Voice input friendly** - Paste transcriptions from MacWhisper for hands-free interaction
+- **Streaming TTS (serve mode)** - Hear answers while they are still being generated
+- **Provider selection** - Choose Anthropic (Claude) or OpenAI via CLI flags
+- **Model switching (Claude)** - Cycle Anthropic models during a conversation with Shift+Tab
+- **Session persistence** - Automatically resume the last session per project
+- **Focused terminal UI** - Ink-based interface with conversation history, tool activity, and the Orb intro
+
+## Installation
+
+### Global install
+
+```bash
+# With Bun
+bun install -g @andypai/orb
+
+# With npm (Bun is still required at runtime)
+npm install -g @andypai/orb
+```
+
+### Local / one-off use
+
+```bash
+# Run without installing globally
+bunx @andypai/orb
+
+# Add to a Bun project
+bun add @andypai/orb
+
+# npm also works, but Bun is still required at runtime
+npm install @andypai/orb
+```
+
+## 60-Second Quick Start
+
+### 1. Set up an LLM provider
+
+- Anthropic: sign in with Claude Code / Max, or set `ANTHROPIC_API_KEY`
+- OpenAI: set `OPENAI_API_KEY`
+
+If you do not pass `--provider` or `--model`, Orb auto-selects a provider in this order:
+
+1. Claude Agent SDK (Claude Code / Max or API key)
+2. `OPENAI_API_KEY`
+3. `ANTHROPIC_API_KEY`
+
+### 2. Pick your speech path
+
+#### Fastest path with no speech
+
+```bash
+orb --no-tts
+```
+
+#### Fastest path on macOS (batch speech)
+
+```bash
+orb --tts-mode=generate
+```
+
+Generate mode uses macOS built-ins (`say` and `afplay`) and does not require `tts-gateway`.
+
+#### Recommended path for streaming speech
+
+```bash
+uv tool install tts-gateway[kokoro]
+~/.local/share/uv/tools/tts-gateway/bin/python -m spacy download en_core_web_sm
+tts serve --provider kokoro --port 8000
+```
+
+That spaCy install is important: Kokoro’s first request will crash in a plain `uv tool` install unless `en_core_web_sm` is installed into the `tts-gateway` tool environment.
+
+Orb expects `tts-gateway` at `http://localhost:8000` by default and automatically targets `POST /tts`.
+
+### 3. Run Orb
+
+```bash
+# Explore the current directory
+orb
+
+# Guided setup for persistent defaults
+orb setup
+
+# Explore a specific project
+orb /path/to/project
+```
+
+## Usage
+
+```bash
+# Anthropic with options
+orb --model=sonnet --voice=marius
+orb --provider=anthropic --model=opus
+
+# OpenAI provider
+orb --provider=openai --model=gpt-5.4
+orb --model=openai:gpt-5.4
+
+# Fresh conversation
+orb --new
+
+# Skip the intro animation
+orb --skip-intro
+```
+
+### Options
+
+| Option                   | Description                                                                    | Default                                 |
+| ------------------------ | ------------------------------------------------------------------------------ | --------------------------------------- |
+| `--provider=<provider>`  | LLM provider: `anthropic`\|`claude`, `openai`\|`gpt` (alias: `--llm-provider`) | `auto`                                  |
+| `--model=<model>`        | Model ID or alias (`haiku`, `sonnet`, `opus`) or `provider:model`              | `haiku` (anthropic), `gpt-5.4` (openai) |
+| `--voice=<voice>`        | TTS voice: `alba`, `marius`, `jean`                                            | `alba`                                  |
+| `--tts-mode=<mode>`      | `serve` for `tts-gateway`, `generate` for local macOS `say`                    | `serve`                                 |
+| `--tts-server-url=<url>` | Serve-mode gateway URL                                                         | `http://localhost:8000`                 |
+| `--tts-speed=<rate>`     | TTS speed multiplier                                                           | `1.5`                                   |
+| `--new`                  | Start fresh (ignore saved session)                                             | -                                       |
+| `--skip-intro`           | Skip the welcome animation                                                     | -                                       |
+| `--no-tts`               | Disable text-to-speech                                                         | -                                       |
+| `--no-streaming-tts`     | Disable streaming (batch mode)                                                 | -                                       |
+| `--help`                 | Show help message                                                              | -                                       |
+
+### Controls
+
+- Type your question and press **Enter** to submit
+- Paste MacWhisper transcription with **Cmd+V**
+- Press **Esc** or **Ctrl+S** to stop speech
+- Press **Shift+Tab** to cycle Claude models (Anthropic only)
+- Press **Ctrl+O** to toggle live tool-call details
+- Press **Ctrl+C** to exit
+
+## TTS Setup
+
+Orb supports two TTS paths:
+
+- **Serve mode** (default): send speech requests to a local `tts-gateway` server
+- **Generate mode**: use macOS built-in `say` for local fallback speech
+
+### Serve mode
+
+Serve mode gives Orb the best experience for low-latency streaming speech.
+
+#### Install and start `tts-gateway`
+
+```bash
+uv tool install tts-gateway[kokoro]
+~/.local/share/uv/tools/tts-gateway/bin/python -m spacy download en_core_web_sm
+tts serve --provider kokoro --port 8000
+```
+
+#### Verify the server
+
+```bash
+curl http://localhost:8000/health
+curl -X POST http://localhost:8000/tts -F 'text=hello from orb' -o /tmp/orb-check.wav
+```
+
+Then run Orb with defaults:
+
+```bash
+orb
+```
+
+If you use a different host or port:
+
+```bash
+orb --tts-server-url=http://localhost:9000
+```
+
+You can also save that value permanently with `orb setup` or `tts.server_url` in `~/.orb/config.toml`.
+
+#### Voice notes
+
+Orb exposes three portable voice presets: `alba`, `marius`, and `jean`.
+
+Some `tts-gateway` providers use different internal voice names. Orb already retries once without an explicit voice if the gateway rejects a preset, so a working server default will still speak.
+
+### Generate mode
+
+On macOS, generate mode works out of the box with the built-in `say` command:
+
+```bash
+orb --tts-mode=generate
+```
+
+If you want advanced voices, non-macOS support, or streaming playback while the model is still responding, use serve mode with `tts-gateway` instead.
+
+### Disable TTS
+
+```bash
+orb --no-tts
+```
+
+## Provider Setup
+
+Orb supports two LLM providers: **Anthropic (Claude)** and **OpenAI**.
+
+### Anthropic (default)
+
+Anthropic uses the Claude Agent SDK. Orb can reuse a local Claude Code / Max-authenticated session when available, or fall back to `ANTHROPIC_API_KEY` / `CLAUDE_API_KEY`.
+
+#### Quick start
+
+```bash
+# Uses Anthropic by default when available
+orb
+
+# Explicitly specify Anthropic
+orb --provider=anthropic
+
+# Use model aliases
+orb --model=haiku
+orb --model=sonnet
+orb --model=opus
+
+# Or use a full model ID
+orb --model=claude-haiku-4-5-20251001
+```
+
+#### Available models
+
+- `claude-haiku-4-5-20251001` (default, alias: `haiku`)
+- `claude-sonnet-4-6` (alias: `sonnet`)
+- `claude-opus-4-6` (alias: `opus`)
+
+If you are not already signed in through Claude Code / Max, set `ANTHROPIC_API_KEY` or `CLAUDE_API_KEY` before starting Orb.
+
+For setup details, see the [Claude Agent SDK quickstart](https://platform.claude.com/docs/en/agent-sdk/quickstart) and the [Claude models overview](https://platform.claude.com/docs/en/about-claude/models/overview).
+
+### OpenAI
+
+OpenAI support uses the official OpenAI Responses API and requires `OPENAI_API_KEY`.
+
+#### Quick start
+
+```bash
+export OPENAI_API_KEY=sk-...
+
+orb --provider=openai
+orb --provider=openai --model=gpt-5.4
+orb --model=openai:gpt-5.4
+```
+
+#### Common models
+
+- `gpt-5.4` (default for OpenAI)
+- `gpt-5`
+- `gpt-4o`
+- `gpt-5.4-mini`
+
+> Note: OpenAI runs in a sandboxed environment via `bash-tool`. File edits happen in a sandbox overlay and are not applied directly to your working tree. Orb will describe changes it made so you can apply them yourself.
+
+## Global Config
+
+Persistent defaults live in `~/.orb/config.toml`. CLI flags override config values for one-off runs.
+
+The easiest way to create the file is:
+
+```bash
+orb setup
+```
+
+A typical config looks like:
+
+```toml
+provider = "anthropic"
+model = "claude-haiku-4-5-20251001"
+skip_intro = false
+
+[tts]
+enabled = true
+streaming = true
+mode = "serve"
+server_url = "http://localhost:8000"
+voice = "alba"
+speed = 1.5
+buffer_sentences = 1
+clause_boundaries = false
+min_chunk_length = 15
+max_wait_ms = 150
+grace_window_ms = 50
+```
+
+Config-only advanced tuning keys live under `[tts]`:
+
+- `buffer_sentences`
+- `clause_boundaries`
+- `min_chunk_length`
+- `max_wait_ms`
+- `grace_window_ms`
+
+Sessions are stored under `~/.orb/sessions/` (one per project).
+
+## Customizing Prompts
+
+Orb’s built-in instructions live in the root-level `prompts/` directory:
+
+- `prompts/base.md` for shared behavior
+- `prompts/anthropic.md` for Anthropic-specific system instructions
+- `prompts/openai.md` for OpenAI-specific tool and sandbox instructions
+- `prompts/voice.md` for voice-mode guidance added when TTS is enabled
+
+Prompt files are read fresh for each run, so edits apply to the next question without rebuilding the app.
+
+## Requirements
+
+- **Runtime**: Bun >= 1.1
+- **LLM provider**: Anthropic or OpenAI authentication
+- **TTS** (optional): `tts-gateway` for serve mode, or macOS `say` and `afplay` for generate mode
+
+## Development
+
+```bash
+git clone https://github.com/andypai/orb.git
+cd orb
+bun install
+
+# Run in development
+bun run dev
+
+# Run with OpenAI
+bun run dev --provider=openai --model=gpt-5.4
+
+# Checks
+bun run check
+bun run test
+```
+
+## License
+
+MIT

package/assets/orb-logo.svg

@@ -0,0 +1,75 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="512" height="512" rx="120" fill="#111827"/>
+  <rect x="48" y="48" width="416" height="416" rx="96" fill="url(#bgGlow)"/>
+  <g opacity="0.28" filter="url(#blur)">
+    <circle cx="256" cy="256" r="130" fill="#67E8F9"/>
+  </g>
+  <g stroke="#67E8F9" stroke-width="10" stroke-linecap="round">
+    <path d="M126 158H180"/>
+    <path d="M332 158H386"/>
+    <path d="M104 194H162"/>
+    <path d="M350 194H408"/>
+    <path d="M92 230H150"/>
+    <path d="M362 230H420"/>
+    <path d="M86 266H144"/>
+    <path d="M368 266H426"/>
+    <path d="M92 302H150"/>
+    <path d="M362 302H420"/>
+    <path d="M104 338H162"/>
+    <path d="M350 338H408"/>
+    <path d="M126 374H180"/>
+    <path d="M332 374H386"/>
+  </g>
+  <g stroke="#67E8F9" stroke-width="8" stroke-linecap="round">
+    <path d="M164 144H348"/>
+    <path d="M142 180H370"/>
+    <path d="M126 216H386"/>
+    <path d="M118 252H394"/>
+    <path d="M126 288H386"/>
+    <path d="M142 324H370"/>
+    <path d="M164 360H348"/>
+  </g>
+  <g fill="#67E8F9">
+    <rect x="214" y="139" width="12" height="26" rx="6"/>
+    <rect x="286" y="139" width="12" height="26" rx="6"/>
+    <rect x="192" y="175" width="12" height="26" rx="6"/>
+    <rect x="214" y="175" width="12" height="26" rx="6"/>
+    <rect x="236" y="175" width="12" height="26" rx="6"/>
+    <rect x="264" y="175" width="12" height="26" rx="6"/>
+    <rect x="286" y="175" width="12" height="26" rx="6"/>
+    <rect x="308" y="175" width="12" height="26" rx="6"/>
+    <rect x="176" y="211" width="12" height="26" rx="6"/>
+    <rect x="200" y="211" width="12" height="26" rx="6"/>
+    <rect x="224" y="211" width="12" height="26" rx="6"/>
+    <rect x="248" y="211" width="12" height="26" rx="6"/>
+    <rect x="272" y="211" width="12" height="26" rx="6"/>
+    <rect x="296" y="211" width="12" height="26" rx="6"/>
+    <rect x="320" y="211" width="12" height="26" rx="6"/>
+    <rect x="188" y="247" width="12" height="26" rx="6"/>
+    <rect x="212" y="247" width="12" height="26" rx="6"/>
+    <rect x="300" y="247" width="12" height="26" rx="6"/>
+    <rect x="324" y="247" width="12" height="26" rx="6"/>
+    <rect x="202" y="283" width="12" height="26" rx="6"/>
+    <rect x="226" y="283" width="12" height="26" rx="6"/>
+    <rect x="250" y="283" width="12" height="26" rx="6"/>
+    <rect x="274" y="283" width="12" height="26" rx="6"/>
+    <rect x="298" y="283" width="12" height="26" rx="6"/>
+    <rect x="214" y="319" width="12" height="26" rx="6"/>
+    <rect x="286" y="319" width="12" height="26" rx="6"/>
+  </g>
+  <g fill="#9CA3AF" opacity="0.9">
+    <circle cx="248" cy="256" r="8"/>
+    <circle cx="264" cy="256" r="8"/>
+  </g>
+  <defs>
+    <filter id="blur" x="62" y="62" width="388" height="388" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+      <feFlood flood-opacity="0" result="BackgroundImageFix"/>
+      <feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+      <feGaussianBlur stdDeviation="32" result="effect1_foregroundBlur"/>
+    </filter>
+    <radialGradient id="bgGlow" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(256 256) rotate(90) scale(208)">
+      <stop stop-color="#172554"/>
+      <stop offset="1" stop-color="#111827"/>
+    </radialGradient>
+  </defs>
+</svg>

package/assets/orb-terminal-session.svg

@@ -0,0 +1,72 @@
+<svg width="1440" height="940" viewBox="0 0 1440 940" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="1440" height="940" fill="#0B1220"/>
+  <g filter="url(#shadow)">
+    <rect x="70" y="64" width="1300" height="812" rx="26" fill="#111827"/>
+    <rect x="70.5" y="64.5" width="1299" height="811" rx="25.5" stroke="#1F2937"/>
+  </g>
+  <rect x="70" y="64" width="1300" height="54" rx="26" fill="#162033"/>
+  <rect x="70" y="92" width="1300" height="26" fill="#162033"/>
+  <circle cx="112" cy="92" r="8" fill="#F87171"/>
+  <circle cx="140" cy="92" r="8" fill="#FBBF24"/>
+  <circle cx="168" cy="92" r="8" fill="#34D399"/>
+  <text x="214" y="100" fill="#E5E7EB" font-size="22" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, Liberation Mono, monospace">orb   main  →  orb --new</text>
+
+  <g font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, Liberation Mono, monospace" font-size="18">
+    <text x="94" y="156" fill="#60A5FA">you:</text>
+    <text x="150" y="156" fill="#E5E7EB">what project are we working on?</text>
+
+    <text x="94" y="192" fill="#A3E635">claude:</text>
+    <text x="184" y="192" fill="#9CA3AF">We're working on the "orb" project, located at /Users/andypai/Projects/orb.</text>
+    <text x="184" y="220" fill="#9CA3AF">Would you like me to explore the codebase and give you a better overview?</text>
+
+    <text x="94" y="286" fill="#60A5FA">you:</text>
+    <text x="150" y="286" fill="#E5E7EB">yes, explore and give a summary of the architecture</text>
+
+    <text x="140" y="332" fill="#22D3EE">✓ Agent</text>
+    <text x="224" y="332" fill="#9CA3AF">Explore orb project architecture</text>
+
+    <text x="140" y="360" fill="#34D399">✓ Read</text>
+    <text x="214" y="360" fill="#9CA3AF">/Users/andypai/Projects/orb/package.json</text>
+
+    <text x="140" y="388" fill="#34D399">✓ Read</text>
+    <text x="214" y="388" fill="#9CA3AF">/Users/andypai/Projects/orb/README.md</text>
+
+    <text x="140" y="416" fill="#34D399">✓ Bash</text>
+    <text x="214" y="416" fill="#9CA3AF">find /Users/andypai/Projects/orb/src ...</text>
+
+    <text x="140" y="444" fill="#34D399">✓ Bash</text>
+    <text x="214" y="444" fill="#9CA3AF">ls -la /Users/andypai/Projects/orb/src</text>
+
+    <text x="140" y="472" fill="#34D399">✓ Read</text>
+    <text x="214" y="472" fill="#9CA3AF">/Users/andypai/Projects/orb/src/index.ts</text>
+
+    <text x="94" y="538" fill="#A3E635">claude:</text>
+    <text x="184" y="538" fill="#D1D5DB">Orb is a voice-driven AI terminal assistant for your codebase. It uses Bun,</text>
+    <text x="184" y="566" fill="#D1D5DB">Ink, and a frame-based pipeline that routes prompts through Anthropic or</text>
+    <text x="184" y="594" fill="#D1D5DB">OpenAI, then optionally through streaming text-to-speech.</text>
+
+    <text x="184" y="638" fill="#9CA3AF">The main runtime path is:</text>
+    <text x="184" y="674" fill="#67E8F9">src/index.ts → src/ui/App.tsx → src/pipeline/** → adapters/transports</text>
+
+    <text x="184" y="724" fill="#D1D5DB">Results stream back into the terminal UI in real time, with tool activity,</text>
+    <text x="184" y="752" fill="#D1D5DB">session persistence, and optional spoken playback as the answer arrives.</text>
+  </g>
+
+  <rect x="94" y="800" width="382" height="34" rx="17" fill="#162033"/>
+  <circle cx="116" cy="817" r="6" fill="#67E8F9"/>
+  <text x="134" y="824" fill="#E5E7EB" font-size="18" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, Liberation Mono, monospace">ask a question about your codebase…</text>
+
+  <text x="1330" y="824" text-anchor="end" fill="#9CA3AF" font-size="18" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, Liberation Mono, monospace">sonnet 4.6 • alba • x1.5</text>
+
+  <defs>
+    <filter id="shadow" x="22" y="30" width="1396" height="908" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+      <feFlood flood-opacity="0" result="BackgroundImageFix"/>
+      <feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0" result="hardAlpha"/>
+      <feOffset dy="14"/>
+      <feGaussianBlur stdDeviation="24"/>
+      <feColorMatrix type="matrix" values="0 0 0 0 0.0156863 0 0 0 0 0.0235294 0 0 0 0 0.0588235 0 0 0 0.45 0"/>
+      <feBlend mode="normal" in2="BackgroundImageFix" result="effect1_dropShadow"/>
+      <feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow" result="shape"/>
+    </filter>
+  </defs>
+</svg>

package/assets/orb-wordmark.svg

@@ -0,0 +1,77 @@
+<svg width="1328" height="392" viewBox="0 0 1328 392" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="24" y="16" width="1280" height="360" rx="48" fill="#111827"/>
+  <rect x="52" y="44" width="1224" height="304" rx="36" fill="#131D2B" stroke="#1F2937" stroke-width="2"/>
+  <g transform="translate(118 64)">
+    <rect width="264" height="264" rx="64" fill="url(#logoBg)"/>
+    <g opacity="0.32" filter="url(#logoBlur)">
+      <circle cx="132" cy="132" r="78" fill="#67E8F9"/>
+    </g>
+    <g stroke="#67E8F9" stroke-width="6" stroke-linecap="round">
+      <path d="M42 64H78"/>
+      <path d="M186 64H222"/>
+      <path d="M28 92H68"/>
+      <path d="M196 92H236"/>
+      <path d="M20 120H60"/>
+      <path d="M204 120H244"/>
+      <path d="M18 148H58"/>
+      <path d="M206 148H246"/>
+      <path d="M20 176H60"/>
+      <path d="M204 176H244"/>
+      <path d="M28 204H68"/>
+      <path d="M196 204H236"/>
+      <path d="M42 232H78"/>
+      <path d="M186 232H222"/>
+    </g>
+    <g stroke="#67E8F9" stroke-width="5" stroke-linecap="round">
+      <path d="M70 54H194"/>
+      <path d="M54 82H210"/>
+      <path d="M42 110H222"/>
+      <path d="M36 138H228"/>
+      <path d="M42 166H222"/>
+      <path d="M54 194H210"/>
+      <path d="M70 222H194"/>
+    </g>
+    <g fill="#67E8F9">
+      <rect x="100" y="51" width="8" height="18" rx="4"/>
+      <rect x="156" y="51" width="8" height="18" rx="4"/>
+      <rect x="84" y="79" width="8" height="18" rx="4"/>
+      <rect x="100" y="79" width="8" height="18" rx="4"/>
+      <rect x="116" y="79" width="8" height="18" rx="4"/>
+      <rect x="140" y="79" width="8" height="18" rx="4"/>
+      <rect x="156" y="79" width="8" height="18" rx="4"/>
+      <rect x="172" y="79" width="8" height="18" rx="4"/>
+      <rect x="72" y="107" width="8" height="18" rx="4"/>
+      <rect x="88" y="107" width="8" height="18" rx="4"/>
+      <rect x="104" y="107" width="8" height="18" rx="4"/>
+      <rect x="120" y="107" width="8" height="18" rx="4"/>
+      <rect x="136" y="107" width="8" height="18" rx="4"/>
+      <rect x="152" y="107" width="8" height="18" rx="4"/>
+      <rect x="168" y="107" width="8" height="18" rx="4"/>
+      <rect x="82" y="135" width="8" height="18" rx="4"/>
+      <rect x="98" y="135" width="8" height="18" rx="4"/>
+      <rect x="158" y="135" width="8" height="18" rx="4"/>
+      <rect x="174" y="135" width="8" height="18" rx="4"/>
+      <rect x="92" y="163" width="8" height="18" rx="4"/>
+      <rect x="108" y="163" width="8" height="18" rx="4"/>
+      <rect x="124" y="163" width="8" height="18" rx="4"/>
+      <rect x="140" y="163" width="8" height="18" rx="4"/>
+      <rect x="156" y="163" width="8" height="18" rx="4"/>
+      <rect x="100" y="191" width="8" height="18" rx="4"/>
+      <rect x="156" y="191" width="8" height="18" rx="4"/>
+    </g>
+  </g>
+  <text x="462" y="170" fill="#E5E7EB" font-size="120" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, Liberation Mono, monospace" letter-spacing="20">orb</text>
+  <text x="468" y="222" fill="#67E8F9" opacity="0.9" font-size="28" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, Liberation Mono, monospace" letter-spacing="6">VOICE-DRIVEN CODE EXPLORER</text>
+  <text x="468" y="268" fill="#9CA3AF" font-size="24" font-family="ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, Liberation Mono, monospace">Anthropic or OpenAI • live tools • streaming speech</text>
+  <defs>
+    <filter id="logoBlur" x="22" y="22" width="220" height="220" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+      <feFlood flood-opacity="0" result="BackgroundImageFix"/>
+      <feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+      <feGaussianBlur stdDeviation="18" result="effect1_foregroundBlur"/>
+    </filter>
+    <radialGradient id="logoBg" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(132 132) rotate(90) scale(132)">
+      <stop stop-color="#172554"/>
+      <stop offset="1" stop-color="#111827"/>
+    </radialGradient>
+  </defs>
+</svg>

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@andypai/orb",
+  "version": "0.1.1",
+  "description": "Voice-driven code explorer for your terminal",
+  "homepage": "https://github.com/andypai/orb#readme",
+  "bugs": {
+    "url": "https://github.com/andypai/orb/issues"
+  },
+  "type": "module",
+  "bin": {
+    "orb": "./src/cli.ts"
+  },
+  "files": [
+    "assets/**/*",
+    "prompts/**/*.md",
+    "src/**/*.ts",
+    "src/**/*.tsx",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.spec.ts",
+    "!src/**/*.spec.tsx",
+    "!src/**/__tests__/**",
+    "!src/**/__snapshots__/**"
+  ],
+  "engines": {
+    "bun": ">=1.1.0"
+  },
+  "packageManager": "bun@1.3.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/andypai/orb.git"
+  },
+  "keywords": [
+    "ai",
+    "voice",
+    "tts",
+    "code-explorer",
+    "cli",
+    "terminal",
+    "openai",
+    "anthropic"
+  ],
+  "author": "Andy Pai",
+  "license": "MIT",
+  "scripts": {
+    "dev": "bun --watch src/cli.ts",
+    "start": "bun src/cli.ts",
+    "format": "bunx prettier --write .",
+    "check": "bunx prettier --check . && bun run test",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.1",
+    "@ai-sdk/openai": "3.0.47",
+    "@anthropic-ai/claude-agent-sdk": "0.2.80",
+    "@inkjs/ui": "2.0.0",
+    "@iarna/toml": "^2.2.5",
+    "ai": "6.0.134",
+    "bash-tool": "^1.3.9",
+    "commander": "^14.0.3",
+    "ink": "6.6.0",
+    "just-bash": "^2.7.0",
+    "react": "19.2.3",
+    "zod": "4.1.8"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.22",
+    "@types/react": "19.2.9",
+    "ink-testing-library": "4.0.0",
+    "prettier": "^3.7.4",
+    "typescript": "^5.7.2"
+  }
+}