brosh 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ellery Familia
+
+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,181 @@
+<p align="center">
+  <strong>The AI-native terminal. Built for Claude coders.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/elleryfamilia/brosh/releases"><img src="https://img.shields.io/github/v/release/elleryfamilia/brosh" alt="Release"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/elleryfamilia/brosh" alt="License: MIT"></a>
+  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-blue" alt="Platforms">
+</p>
+
+![brosh desktop](docs/images/brosh_startscreen.png)
+
+## Install
+
+**Homebrew (macOS):**
+
+```bash
+brew install --cask elleryfamilia/brosh/brosh
+```
+
+**Direct download:** `.dmg` (macOS) / `.AppImage` (Linux) from the [releases page](https://github.com/elleryfamilia/brosh/releases).
+
+**Build from source:**
+
+```bash
+git clone https://github.com/elleryfamilia/brosh.git
+cd brosh/packages/desktop-electron && npm install && npm run start
+```
+
+**CLI only:** `npm install -g brosh` or `brew install elleryfamilia/brosh/brosh-cli` -- [more install options](./docs/installation.md)
+
+## Features
+
+- [**Claude Code integration**](#claude-code-integration) -- Natural language detection, model switching, "Continue in Claude" handoff, built-in MCP server
+- [**Split panes & tabs**](#terminal) -- Horizontal/vertical splits with draggable dividers, multi-tab interface
+- [**Git sidebar**](#git-integration) -- Visual commit graph, file change tracking, Monaco diff editor
+- [**Sandbox mode**](#sandbox-mode) -- Restrict filesystem and network access per session
+- [**Themes & customization**](#terminal) -- 9 themes, 25+ fonts, cursor styles, window opacity, scrollback
+- [**MCP tools**](#mcp-integration) -- Give Claude Code direct access to type, read, and screenshot your terminal
+- [**Session recording**](#developer-tools) -- Record to asciicast format, play back with asciinema
+- **Cross-platform** -- macOS, Linux
+
+---
+
+## Claude Code Integration
+
+brosh is purpose-built for working with Claude Code. Every part of the terminal is designed to make AI-assisted development seamless.
+
+- **Natural language detection** -- An ML classifier distinguishes commands from questions in real time. Type `git push` and it runs. Type `how do I rebase onto main?` and Claude answers.
+- **Model switching** -- Switch between Sonnet, Opus, and Haiku from the status bar.
+- **MCP server built in** -- Claude Code connects over MCP and can see your terminal, run commands, and read output. No extra setup.
+- **Continue in Claude** -- Start a conversation in the terminal and seamlessly continue it in the Claude Code CLI with full context.
+- **Smart status bar** -- Git branch, active Claude model, MCP connection status, and session info at a glance.
+
+![brosh terminal chat](docs/images/terminal_chat.png)
+
+![MCP enabled](docs/images/mcp-enabled2.png)
+
+## Terminal
+
+- Multi-tab interface with split panes (horizontal and vertical)
+- Draggable panel dividers for custom layouts
+- 9 built-in themes and 25+ fonts
+- Cursor style options, window opacity, and configurable scrollback
+- Find bar for searching terminal output
+
+## Git Integration
+
+Built-in git sidebar with visual commit graph, file change tracking, and a Monaco-powered diff editor.
+
+![git sidebar](docs/images/git_sidebar.png)
+
+Click any changed file to open a full diff view:
+
+![git diff view](docs/images/git_sidebar_diff.png)
+
+## Sandbox Mode
+
+Choose between standard and sandboxed terminal sessions at launch. Sandbox mode restricts filesystem and network access so Claude can only touch what you allow.
+
+![sandbox permissions](docs/images/sandbox_selection2.png)
+
+See [docs/sandbox.md](./docs/sandbox.md) for configuration details.
+
+## Developer Tools
+
+- Monaco code editor integration
+- Terminal session recording ([asciicast format](./docs/recording.md))
+- Cross-platform: macOS, Linux
+
+## MCP Integration
+
+The desktop app runs a built-in MCP server on a Unix socket, giving Claude Code direct access to your terminal session.
+
+Add to your Claude Code MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "terminal": {
+      "command": "brosh"
+    }
+  }
+}
+```
+
+| Tool | Description |
+|------|-------------|
+| `type` | Send text input to the terminal |
+| `sendKey` | Send special keys and key combinations |
+| `getContent` | Retrieve terminal buffer content |
+| `takeScreenshot` | Capture terminal state with metadata |
+| `startRecording` | Start recording terminal output |
+| `stopRecording` | Stop recording and save file |
+
+See [docs/tools.md](./docs/tools.md) for the full API reference.
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| <kbd>Cmd</kbd>+<kbd>T</kbd> | New tab |
+| <kbd>Cmd</kbd>+<kbd>N</kbd> | New window |
+| <kbd>Cmd</kbd>+<kbd>W</kbd> | Close tab |
+| <kbd>Cmd</kbd>+<kbd>D</kbd> | Split pane vertically |
+| <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>D</kbd> | Split pane horizontally |
+| <kbd>Cmd</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd> | Toggle git sidebar |
+| <kbd>Cmd</kbd>+<kbd>F</kbd> | Find in terminal |
+| <kbd>Cmd</kbd>+<kbd>,</kbd> | Settings |
+
+## CLI Mode
+
+brosh also works as a standalone CLI terminal and MCP server without the desktop app:
+
+```bash
+brosh              # Interactive mode -- shell + MCP server on Unix socket
+brosh --sandbox    # With filesystem/network restrictions
+brosh --record     # With session recording
+```
+
+See the [docs/](./docs/) folder for CLI flags, recording, and sandbox configuration.
+
+## Development
+
+```bash
+# Core library
+npm install && npm run build
+
+# Desktop app
+cd packages/desktop-electron
+npm run dev          # Dev mode with hot-reload
+npm run package      # Build distributable
+```
+
+### Linux: Sandbox binaries
+
+The desktop app bundles statically-compiled `socat` and `bwrap` (bubblewrap) so sandbox mode works out of the box on any Linux distro. The binaries are built automatically during `npm run package` (via `prepackage`). You just need the build tools installed:
+
+```bash
+# One-time setup (Linux only)
+sudo apt-get install -y meson ninja-build pkg-config libcap-dev
+```
+
+The script fetches the latest source releases from upstream, compiles static binaries, and places them in `resources/bin/`. On macOS the step is a no-op. You can also run it manually with `npm run prepare-sandbox-bins`.
+
+## Documentation
+
+- [Overview](./docs/index.md) -- [Installation](./docs/installation.md) -- [Architecture](./docs/architecture.md)
+- [Tools Reference](./docs/tools.md) -- [Configuration](./docs/configuration.md) -- [Examples](./docs/examples.md)
+- [Recording](./docs/recording.md) -- [Sandbox Mode](./docs/sandbox.md)
+
+## Requirements
+
+- **Desktop App**: macOS 10.15+, Linux
+- **CLI**: Node.js 18+
+
+## License
+
+MIT
+
+The Linux desktop build bundles [socat](http://www.dest-unreach.org/socat/) (GPL-2.0) and [bubblewrap](https://github.com/containers/bubblewrap) (LGPL-2.1) as standalone executables for sandbox support. See [`packages/desktop-electron/THIRD-PARTY-NOTICES`](packages/desktop-electron/THIRD-PARTY-NOTICES) for full license texts.

package/brosh_brandmark.svg

@@ -0,0 +1,3 @@
+<svg width="366" height="366" viewBox="0 0 366 366" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M212.514 311.615C204.654 296.708 182.5 244.104 182.5 124.538V123.007L195.545 131.706C205.913 138.608 214.413 147.972 220.288 158.962C226.162 169.952 229.229 182.227 229.214 194.692H252.571C252.585 178.38 248.569 162.318 240.881 147.936C233.193 133.554 222.072 121.299 208.508 112.262L191.878 101.154H209.746C227.429 101.187 244.63 106.928 258.796 117.523L280.6 133.892L294.614 115.185L272.81 98.8154C254.593 85.1992 232.48 77.8195 209.746 77.7692H195.545C210.8 62.8567 231.251 54.4705 252.571 54.3846H275.929V31H252.571C236.882 31.0626 221.404 34.6254 207.263 41.4293C193.121 48.2332 180.672 58.1071 170.821 70.3329C160.97 58.1071 148.522 48.2332 134.38 41.4293C120.239 34.6254 104.761 31.0626 89.0714 31H65.7143V54.3846H89.0714C110.392 54.4705 130.843 62.8567 146.098 77.7692H131.897C109.163 77.8195 87.0497 85.1992 68.8325 98.8154L47.0286 115.185L61.0429 133.892L82.8468 117.523C97.0131 106.928 114.214 101.187 131.897 101.154H149.765L133.146 112.262C119.58 121.297 108.457 133.552 100.767 147.934C93.077 162.316 89.0592 178.379 89.0714 194.692H112.429C112.414 182.227 115.48 169.952 121.355 158.962C127.23 147.972 135.73 138.608 146.098 131.706L159.143 123.018V124.538C159.143 229.114 175.633 285.483 186.716 311.615H19V335H346V311.615H212.514Z" fill="#FFCE27"/>
+</svg>