brosh 0.1.5 → 0.1.6

package/README.github.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <strong>The AI-native terminal. Built for Claude coders.</strong>
+  <strong>Built for Claude coders.</strong>
 </p>
 
 <p align="center">
@@ -8,7 +8,7 @@
   <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-blue" alt="Platforms">
 </p>
 
-![brosh desktop](docs/images/brosh_startscreen.png)
+![intro screen](docs/images/intro_screen.png)
 
 ## Install
 
@@ -41,64 +41,40 @@ 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.
+## As much or as little as you'd like
 
-![brosh terminal chat](docs/images/terminal_chat.png)
+brosh gives you a terminal that grows with your workflow. Start minimal, add AI when you need it.
 
-![MCP enabled](docs/images/mcp-enabled2.png)
+### Just a terminal
 
-## Terminal
+At its simplest, brosh is a fast, themeable terminal with split panes, tabs, and a smart status bar.
 
-- 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
+![terminal](docs/images/terminal_screen.png)
 
-## Git Integration
+### Add Claude Code
 
-Built-in git sidebar with visual commit graph, file change tracking, and a Monaco-powered diff editor.
+Open a side-by-side pane and Claude Code is right there -- connected to your terminal over MCP, ready to help.
 
-![git sidebar](docs/images/git_sidebar.png)
+![claude code](docs/images/claudecode_screen.png)
 
-Click any changed file to open a full diff view:
+### Plugins when you need them
 
-![git diff view](docs/images/git_sidebar_diff.png)
+Git, Context, Plans, Files -- built-in plugins live in the status bar and open as sidebars when you need them. Here the Context plugin gives Claude visibility into your project's CLAUDE.md files, documentation, and codebase structure.
 
-## Sandbox Mode
+![context plugin](docs/images/context_screen.png)
 
-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
+## Features
 
-- Monaco code editor integration
-- Terminal session recording ([asciicast format](./docs/recording.md))
-- Cross-platform: macOS, Linux
+- **Claude Code integration** -- Built-in MCP server, model switching, natural language detection, "Continue in Claude" handoff
+- **Built-in plugins** -- Git, Context, Plans, and Files sidebars available when you need them
+- **Split panes & tabs** -- Horizontal/vertical splits with draggable dividers, multi-tab interface
+- **Sandbox mode** -- Restrict filesystem and network access per session
+- **Themes & customization** -- 9 themes, 25+ fonts, cursor styles, window opacity, scrollback
+- **MCP tools** -- Claude Code can type, read, and screenshot your terminal directly
+- **Session recording** -- Record to asciicast format, play back with asciinema
+- **Cross-platform** -- macOS, Linux
 
 ## MCP Integration
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brosh",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Terminal MCP bridge for AI-powered development",
   "author": "Ellery Familia",
   "repository": {
@@ -35,7 +35,7 @@
   "dependencies": {
     "@anthropic-ai/sandbox-runtime": "^0.0.32",
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@xterm/headless": "^5.3.0",
+    "@xterm/headless": "file:vendor/xterm-headless-5.5.0.tgz",
     "ink": "^5.0.1",
     "node-pty": "^1.2.0-beta.8",
     "react": "^18.3.1",

package/packages/desktop-electron/package-lock.json

@@ -31,7 +31,7 @@
         "@xterm/addon-search": "^0.16.0",
         "@xterm/addon-web-links": "^0.11.0",
         "@xterm/addon-webgl": "^0.18.0",
-        "@xterm/xterm": "^5.5.0",
+        "@xterm/xterm": "file:../../vendor/xterm-xterm-5.5.0.tgz",
         "brosh": "file:../..",
         "bytenode": "^1.5.7",
         "chokidar": "^5.0.0",
@@ -65,12 +65,12 @@
       }
     },
     "../..": {
-      "version": "0.1.3",
+      "version": "0.1.6",
       "license": "MIT",
       "dependencies": {
         "@anthropic-ai/sandbox-runtime": "^0.0.32",
         "@modelcontextprotocol/sdk": "^1.0.0",
-        "@xterm/headless": "^5.3.0",
+        "@xterm/headless": "file:vendor/xterm-headless-5.5.0.tgz",
         "ink": "^5.0.1",
         "node-pty": "^1.2.0-beta.8",
         "react": "^18.3.1",
@@ -3550,8 +3550,8 @@
     },
     "node_modules/@xterm/xterm": {
       "version": "5.5.0",
-      "resolved": "https://registry.npmjs.org/@xterm/xterm/-/xterm-5.5.0.tgz",
-      "integrity": "sha512-hqJHYaQb5OptNunnyAnkHyM8aCjZ1MEIDTQu1iIbbTD/xops91NB5yq1ZK/dC2JDbVWtF23zUtl9JE2NqwT87A==",
+      "resolved": "file:../../vendor/xterm-xterm-5.5.0.tgz",
+      "integrity": "sha512-4JDLfPkqA6w7JE06IM5oGaRkceyBTNC1Mjpn3mUjSOR/qcktEUqr1D7nsHhym/nTbLowub++/dGPsJ4741R6mA==",
       "license": "MIT"
     },
     "node_modules/7zip-bin": {

package/packages/desktop-electron/package.json

@@ -58,7 +58,7 @@
     "@xterm/addon-search": "^0.16.0",
     "@xterm/addon-web-links": "^0.11.0",
     "@xterm/addon-webgl": "^0.18.0",
-    "@xterm/xterm": "^5.5.0",
+    "@xterm/xterm": "file:../../vendor/xterm-xterm-5.5.0.tgz",
     "brosh": "file:../..",
     "bytenode": "^1.5.7",
     "chokidar": "^5.0.0",

package/packages/desktop-electron/vite.config.ts

@@ -6,6 +6,9 @@ export default defineConfig({
   plugins: [react()],
   base: './',
   root: 'src/renderer',
+  resolve: {
+    preserveSymlinks: true,
+  },
   build: {
     outDir: '../../dist/renderer',
     emptyOutDir: true,

package/website/index.html

@@ -3,18 +3,18 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>brosh - The AI-native terminal</title>
+  <title>brosh - Built for Claude coders</title>
   <meta name="description" content="A modern terminal emulator with built-in AI integration via MCP. Natural language detection, split panes, Git sidebar, sandbox mode, and more.">
 
   <!-- Open Graph -->
   <meta property="og:type" content="website">
-  <meta property="og:title" content="brosh - The AI-native terminal">
+  <meta property="og:title" content="brosh - Built for Claude coders">
   <meta property="og:description" content="A modern terminal emulator with built-in AI integration via MCP. Built for Claude coders.">
   <meta property="og:image" content="assets/images/brosh_startscreen.png">
 
   <!-- Twitter Card -->
   <meta name="twitter:card" content="summary_large_image">
-  <meta name="twitter:title" content="brosh - The AI-native terminal">
+  <meta name="twitter:title" content="brosh - Built for Claude coders">
   <meta name="twitter:description" content="A modern terminal emulator with built-in AI integration via MCP. Built for Claude coders.">
   <meta name="twitter:image" content="assets/images/brosh_startscreen.png">
 

package/website/install.sh.asc

@@ -1,16 +1,16 @@
 -----BEGIN PGP SIGNATURE-----
 
-iQIzBAABCgAdFiEEX8WeGtXPO7P8xoFftW8bjWv2UfkFAmmbF5gACgkQtW8bjWv2
-Ufml/RAAhZk/8zQvaYuq/kNFYWgtH1F7+zyilD1qXWEadeQVTVLcL8BfZNuy3JVl
-TuwVtOD1nMjm2AfyxaKeDWrL+SMSQ66y6+HlrYLmkTmlVSvPcwUaHs1KRdZZ62/W
-1iDCYrBa5Pj+4TVAZusPu8m9IlvVSU2tpUpjdbXfBZYAsxGYww2VDcB8nZIt490H
-r0GNH66/0k6HXd8bU586yAKfmY74e6Q1IXcSUQc2e0YTrh/BuSTEHWwkBW9Zdorv
-r/SWDJOqTHtl1Zz1ZY7M41fRisshWdagZBwpdd9fAxBx4DnO2mJaqfd9JVmG4MEt
-HK33rnaeXHGLwpy3s/06WMFk8Dd4BzLoE/VQkiI2pxGzDU/J3URaSgGuK9LPTgjF
-BMy2vI4eImmUP375S9NZgAwsKy9VROI4EaP+M3G9RwNG7NjO3ox6ipUKknXa9RP6
-yO/gYoAeRL1bjDXBlrJ/JyvXVmnChHLPigC4OmCLxcjisF4bS2BGrJK6j0LfOVnP
-QHSvvtTevF2/olWJVydV5JV+U/SckzAL8gW1ThoAtER39bPgoyniyCkVNpMx+vmG
-h3qLIaw/ZulQ/Lk6uRFdUxO7h1yAVuIQnC54i9Mr/UFA5kK/BpcqGRym0XRYgFjN
-5A2LoTXBApJWGQ9Nq/vPyaz+Psc2juJsRIci4raJn66lyCgjpOw=
-=9y68
+iQIzBAABCgAdFiEEX8WeGtXPO7P8xoFftW8bjWv2UfkFAmmcrWwACgkQtW8bjWv2
+Ufmocg//SlriDRiQt7Pg3iD40XZ3Rg9mVkRoxUVGW/vxiq4xPoTX1XrMC47hBF3O
+OR5h6YylCO8RS/+7LbS7hTmSanpeDGaOObMlMVVN5Vmk1u5Bw6lAOsjBd1z5TyZw
+tmDYiHeXiG1nPolDuGWytJoI3MA3jzh3bcU3UlRhNAVMAXOI9y32U4XHlGUTc2N2
+HT+yIhIcB14cGSCnNQOxnyQvgtuLWAMrUfK2jsugMbdSGJ74yibuOGlstoNih7eg
+rtnDEn9bahIkNlxSIIBqrgCfMS5EKSYiF49cQ+kdcJBE94MUgllpnFAL1bwcrEt/
+vY1zpiLcmyd/eUE/cCHYOjJ6vccRjJAx+I/j7aHQGRGxBmeHW8ie77fGQ9IuDbit
+/P2NG7qYPsCLhM+y7UGKa4nwjtAjAi2zwkwOKT8FRrexcnhh1m8Pa/FsbRG1itck
+UQpsl416n2U29EwYGUyXb4ijvKMyQHACmvISgKM/Cxm1eBpDBsvEgkUArNEBzWv0
+pZjAF2ssztiFBB1HpKR6TsPeXmQMLIIwPuxQ2CDlZavjBmRvYHnLMSOCe0V6hSjp
+ndvw1q3oBMlj5omUhJpWPMgZhNkaVLJn9bU7ZwHyjljWZyUbin7H7G9Ayy58+rsl
+yE9ZiDnpe9PT0+hRw40h7NGII5B9JEFoFqGHhpJ47UELXP09ah4=
+=nCSH
 -----END PGP SIGNATURE-----

package/packages/desktop-electron/tests/main/error-triage/buildTriagePrompt.test.ts

@@ -1,133 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { buildTriagePrompt } from '../../../src/main/error-triage.js';
-
-/**
- * Tests for the error triage prompt builder.
- *
- * buildTriagePrompt creates the prompt sent to Claude for error triage,
- * including command text, exit code, and recent terminal output.
- */
-
-describe('buildTriagePrompt', () => {
-  describe('prompt structure', () => {
-    it('should include command, exit code, and output', () => {
-      const prompt = buildTriagePrompt('npm run build', 1, 'Error: Module not found');
-
-      expect(prompt).toContain('npm run build');
-      expect(prompt).toContain('Exit code: 1');
-      expect(prompt).toContain('Error: Module not found');
-    });
-
-    it('should include JSON response format instructions', () => {
-      const prompt = buildTriagePrompt('ls /nonexistent', 2, 'No such file');
-
-      expect(prompt).toContain('shouldNotify');
-      expect(prompt).toContain('message');
-      expect(prompt).toContain('JSON');
-    });
-
-    it('should include guidance for shouldNotify=true cases', () => {
-      const prompt = buildTriagePrompt('node app.js', 1, 'crash');
-
-      expect(prompt).toContain('Module/package not found');
-      expect(prompt).toContain('Permission denied');
-      expect(prompt).toContain('Syntax errors');
-    });
-
-    it('should include guidance for shouldNotify=false cases', () => {
-      const prompt = buildTriagePrompt('grep pattern file', 1, '');
-
-      expect(prompt).toContain('grep');
-      expect(prompt).toContain('Ctrl+C');
-    });
-  });
-
-  describe('command handling', () => {
-    it('should handle null command', () => {
-      const prompt = buildTriagePrompt(null, 1, 'some error');
-
-      expect(prompt).toContain('Command: unknown');
-    });
-
-    it('should handle empty string command', () => {
-      const prompt = buildTriagePrompt('', 1, 'some error');
-
-      // Empty string is falsy, should fall back to "unknown"
-      expect(prompt).toContain('Command: unknown');
-    });
-
-    it('should include the actual command when provided', () => {
-      const prompt = buildTriagePrompt('python -m pytest tests/', 1, 'FAILED');
-
-      expect(prompt).toContain('Command: python -m pytest tests/');
-    });
-  });
-
-  describe('exit code handling', () => {
-    it('should include various exit codes', () => {
-      expect(buildTriagePrompt('cmd', 1, 'err')).toContain('Exit code: 1');
-      expect(buildTriagePrompt('cmd', 2, 'err')).toContain('Exit code: 2');
-      expect(buildTriagePrompt('cmd', 127, 'err')).toContain('Exit code: 127');
-      expect(buildTriagePrompt('cmd', 139, 'err')).toContain('Exit code: 139');
-    });
-  });
-
-  describe('output handling', () => {
-    it('should trim whitespace from output', () => {
-      const prompt = buildTriagePrompt('cmd', 1, '  \n  error message  \n  ');
-
-      // The output should be trimmed
-      expect(prompt).toContain('error message');
-      // Should be wrapped in code fences
-      expect(prompt).toContain('```');
-    });
-
-    it('should handle empty output', () => {
-      const prompt = buildTriagePrompt('cmd', 1, '');
-
-      expect(prompt).toContain('Exit code: 1');
-      // Should still have code fence structure even if empty
-      expect(prompt).toContain('```');
-    });
-
-    it('should handle multi-line output', () => {
-      const output = [
-        'Error: Cannot find module "express"',
-        '    at Function._resolveFilename (node:internal/modules/cjs/loader:1405:15)',
-        '    at Function._load (node:internal/modules/cjs/loader:1215:37)',
-      ].join('\n');
-
-      const prompt = buildTriagePrompt('node server.js', 1, output);
-
-      expect(prompt).toContain('Cannot find module');
-      expect(prompt).toContain('_resolveFilename');
-    });
-
-    it('should preserve output with special characters', () => {
-      const output = 'Error: Expected "}" but found "<EOF>"';
-      const prompt = buildTriagePrompt('node -e "{"', 1, output);
-
-      expect(prompt).toContain('Expected');
-    });
-  });
-
-  describe('default behavior guidance', () => {
-    it('should default to shouldNotify=true', () => {
-      const prompt = buildTriagePrompt('cmd', 1, 'error');
-
-      expect(prompt).toContain('DEFAULT: shouldNotify=true');
-    });
-
-    it('should mention that most non-zero exit codes indicate real problems', () => {
-      const prompt = buildTriagePrompt('cmd', 1, 'error');
-
-      expect(prompt).toContain('real problems');
-    });
-
-    it('should advise notifying when in doubt', () => {
-      const prompt = buildTriagePrompt('cmd', 1, 'error');
-
-      expect(prompt).toContain('When in doubt, notify');
-    });
-  });
-});

package/packages/desktop-electron/tests/main/error-triage/parseTriageResponse.test.ts

@@ -1,123 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-
-/**
- * Tests for triage response parsing.
- *
- * parseTriageResponse is not exported directly, so we test it
- * through the module's behavior by examining the expected parsing patterns.
- */
-
-// Since parseTriageResponse is private, test the expected parsing patterns
-describe('Triage Response Parsing Patterns', () => {
-  describe('envelope format (claude --output-format json)', () => {
-    it('should parse standard envelope with result string', () => {
-      const envelope = {
-        result: '{"shouldNotify": true, "message": "Module not found: express"}',
-      };
-      const innerJson = envelope.result;
-      const parsed = JSON.parse(innerJson);
-
-      expect(parsed.shouldNotify).toBe(true);
-      expect(parsed.message).toBe('Module not found: express');
-    });
-
-    it('should handle direct format (no envelope)', () => {
-      const direct = {
-        shouldNotify: false,
-        message: '',
-      };
-
-      expect(typeof direct.shouldNotify).toBe('boolean');
-      expect(direct.shouldNotify).toBe(false);
-    });
-  });
-
-  describe('inner JSON parsing', () => {
-    it('should parse clean JSON', () => {
-      const json = '{"shouldNotify": true, "message": "Permission denied on /etc/config"}';
-      const parsed = JSON.parse(json);
-
-      expect(parsed.shouldNotify).toBe(true);
-      expect(parsed.message).toContain('Permission denied');
-    });
-
-    it('should handle markdown code fence wrapping', () => {
-      const wrapped = '```json\n{"shouldNotify": true, "message": "Syntax error"}\n```';
-      const cleaned = wrapped
-        .replace(/^```(?:json)?\s*\n?/, '')
-        .replace(/\n?```\s*$/, '');
-      const parsed = JSON.parse(cleaned);
-
-      expect(parsed.shouldNotify).toBe(true);
-      expect(parsed.message).toBe('Syntax error');
-    });
-
-    it('should handle code fence without language tag', () => {
-      const wrapped = '```\n{"shouldNotify": false, "message": ""}\n```';
-      const cleaned = wrapped
-        .replace(/^```(?:json)?\s*\n?/, '')
-        .replace(/\n?```\s*$/, '');
-      const parsed = JSON.parse(cleaned);
-
-      expect(parsed.shouldNotify).toBe(false);
-    });
-
-    it('should reject missing shouldNotify field', () => {
-      const json = '{"message": "some error"}';
-      const parsed = JSON.parse(json);
-
-      expect(typeof parsed.shouldNotify).not.toBe('boolean');
-    });
-
-    it('should handle empty message for shouldNotify=false', () => {
-      const json = '{"shouldNotify": false, "message": ""}';
-      const parsed = JSON.parse(json);
-
-      expect(parsed.shouldNotify).toBe(false);
-      expect(parsed.message).toBe('');
-    });
-  });
-
-  describe('error scenarios', () => {
-    it('should handle empty stdout', () => {
-      const trimmed = ''.trim();
-      expect(trimmed).toBe('');
-      // parseTriageResponse returns null for empty input
-    });
-
-    it('should handle malformed JSON', () => {
-      const malformed = '{"shouldNotify": true, message: broken}';
-      expect(() => JSON.parse(malformed)).toThrow();
-    });
-
-    it('should handle non-JSON responses', () => {
-      const text = 'The command failed because the module was not found.';
-      expect(() => JSON.parse(text)).toThrow();
-    });
-  });
-
-  describe('TriageResult contract', () => {
-    it('should always have boolean shouldNotify', () => {
-      const results = [
-        { shouldNotify: true, message: 'Error occurred' },
-        { shouldNotify: false, message: '' },
-      ];
-
-      for (const result of results) {
-        expect(typeof result.shouldNotify).toBe('boolean');
-        expect(typeof result.message).toBe('string');
-      }
-    });
-
-    it('should coerce message to string', () => {
-      // The actual code does String(parsed.message || "")
-      const coerce = (val: unknown) => String(val || '');
-
-      expect(coerce('hello')).toBe('hello');
-      expect(coerce(undefined)).toBe('');
-      expect(coerce(null)).toBe('');
-      expect(coerce('')).toBe('');
-      expect(coerce(42)).toBe('42');
-    });
-  });
-});