@barnaby.build/barnaby 0.0.132 → 0.0.233

package/README.md

@@ -1,163 +1,162 @@
-# Barnaby
-
-Barnaby is a desktop AI agent orchestrator for **agentic coordination** — connecting Codex, Claude, Gemini CLIs and OpenRouter APIs to deliver windowed agents, workspace-aware context, and a polished UI experience.
-
-- **Agentic coordination**: Run multiple agents in parallel, compare models side-by-side, keep separate conversations per panel
-- **CLI providers**: Codex, Claude, Gemini — use your existing CLI logins, no API keys in Barnaby
-- **API provider**: OpenRouter — free-tier and paid models via API key (ideal when CLI quotas are exhausted)
-- **UI experience**: Split layouts (horizontal, vertical, grid), workspace window, dark/light themes, zoom, activity timeline
-
-## Installation
-
-### Option 1: Download (recommended)
-
-[Download Barnaby](https://github.com/incendiosoftware/Barnaby/releases) — portable `.exe` for Windows. No install required.
-
-### Option 2: npm (requires Node.js 20+)
-
-**Quick run:**
-```bash
-npx '@barnaby.build/barnaby'
-```
-*PowerShell: use single quotes as shown. Bash/zsh: quotes optional.*
-
-**Global install:**
-```bash
-npm install -g '@barnaby.build/barnaby'
-barnaby
-```
-*PowerShell: use single quotes around the package name.*
-
-**Windows (npm install):** A Start menu shortcut is created automatically. Search "Barnaby" in Start. For correct taskbar icon, **pin the shortcut** (right‑click → Pin to taskbar), not the running window.
-
----
-
-Latest Binary Release  
-[Download Barnaby v0.0.125](https://github.com/incendiosoftware/Barnaby/releases/tag/v0.0.125)
-
-Website: https://barnaby.build  
-Written By: Stuart Mackereth  
-Company: Incendio Trading Limited  
-Email: incendiosoftware@gmail.com  
-
-## Screenshots
-
-![Barnaby dark screenshot](docs/screenshots/barnaby-dark.png)
-
-![Barnaby light screenshot](docs/screenshots/barnaby-light.png)
-
-## Overview
-
-Barnaby provides:
-
-- **Multiple agent panels** with split layouts (horizontal, vertical, grid)
-- **Workspace window** with agent orchestrator, file explorer, Git status, and workspace settings
-- **Workspace selection** and per-workspace model defaults
-- **Provider routing** for Codex, Claude, Gemini (CLI) and OpenRouter (API)
-- **Connectivity checks** for each provider
-- **Streaming chat** with markdown, code blocks, and collapsible activity timeline
-- **Queue-aware sending** and auto-scroll
-- **View menu**: layout, workspace window toggle, zoom, fullscreen
-
-## Why Barnaby
-
-Barnaby unifies **CLI-based** providers (Codex, Claude, Gemini) and **API-based** OpenRouter so you can orchestrate agents without vendor lock-in.
-
-- **Agentic coordination**: Multiple agents side-by-side, workspace-aware context, parallel conversations
-- **Windowed agents**: Split layouts so you can compare models or keep contexts separate
-- **CLI providers**: Use your provider subscriptions via their CLI; Barnaby does not handle keys or billing
-- **OpenRouter**: API key in Barnaby settings; access free-tier and paid models when CLI quotas are exhausted
-
-Compared to single-chat tools: Barnaby gives you parallel windowed agents and workspace-aware orchestration.
-
-## Prerequisites
-
-- Node.js 18+ recommended
-- npm
-- **CLI providers** (optional): Codex, Claude, and/or Gemini CLI installed and authenticated
-- **API provider** (optional): OpenRouter API key from https://openrouter.ai/keys
-
-## Provider Coverage
-
-| Provider   | Type | Setup                                      |
-|------------|------|--------------------------------------------|
-| Codex      | CLI  | Install CLI, sign in via terminal          |
-| Claude     | CLI  | Install CLI, sign in via terminal          |
-| Gemini     | CLI  | Install CLI, sign in with Google          |
-| OpenRouter | API  | API key in Barnaby connectivity settings  |
-
-OpenRouter offers free-tier models (e.g. Llama, Mistral) and paid models; useful when CLI quotas are exhausted.
-
-## CLI Setup (Codex, Claude, Gemini)
-
-For CLI providers, required CLIs must be installed, signed in, and resolvable from your terminal.
-
-1. Install each CLI from its official docs.
-2. Open a new terminal after install.
-3. Verify CLIs are available on `PATH`:
-
-```sh
-codex --version
-claude --version
-gemini --version
-```
-
-4. Authenticate each CLI (follow the provider's login flow).
-5. Sanity-check outside Barnaby by running one simple prompt in each CLI you plan to use.
-
-## OpenRouter Setup
-
-1. Get an API key from https://openrouter.ai/keys
-2. In Barnaby: open connectivity settings, select OpenRouter, enter your API key
-3. Choose a model (e.g. free-tier Llama 3.3 70B) and connect
-
-## Development
-
-From repo root:
-
-```sh
-npm install
-npm run dev
-```
-
-## Build Commands (Standard Nomenclature)
-
-| Command | Meaning | Script |
-|---------|---------|--------|
-| **run dev** | Run in dev mode | `npm run dev` |
-| **build** | Build without version bump | `npm run build` |
-| **package** | Build + bump version + create distributable | `npm run package` |
-| **publish** | Release to GitHub with release notes | `npm run publish` |
-
-Flow: dev → build → package → publish
-
-- **build** = portable `.exe` in `release/<version>/` (uses current version)
-- **package** = bump patch version, build, artifact in `release/<new-version>/`
-- **publish** = trigger GitHub Actions to publish the current version (commit & push first)
-
-Other scripts: `build:dist`, `build:portable:raw`, `build:release`, `release:notes`, `release:prepare`
-
-Release notes: `RELEASE_NOTES_<version>.md` (generate with `npm run release:notes`). The release workflow updates the latest release link in this README automatically.
-
-## Project Structure
-
-```text
-docs/            Documentation (AGENTS.md, BACKLOG.md, STATUS_LOG.md)
-electron/       Electron main and preload
-src/            React renderer UI
-public/         Static assets
-release/        Packaged outputs
-```
-
-## Notes
-
-- Workspace root should be the repository root unless you want broader file scope.
-- If Codex fails with `codex app-server closed`, run `codex app-server` manually in terminal to inspect.
-
-## Manual Test Checklist
-
-- Multi-instance: open two Barnaby executables and confirm both launch
-- Workspace lock: instance A opens workspace X; instance B tries X → blocked with in-use message
-- Different workspaces: instance A on X, instance B on Y → allowed
-- Lock release: close A, confirm B can open X
-- Crash-stale-lock: force-close A, wait for stale timeout, confirm another instance can claim X
+# Barnaby
+
+**Barnaby is a desktop IDE for orchestrating multiple AI coding agents locally.**
+
+Run Codex, Claude, Gemini, and OpenRouter-backed models side-by-side from a single workspace, with separate panels, shared project context, and an optional orchestrator for longer-running agent workflows.
+
+Barnaby lets developers treat AI agents like a team: design with one, code with another, review with a third.
+
+---
+
+## Screenshot
+
+![Barnaby UI](docs/screenshots/barnaby-main.png)
+
+Additional screenshots:
+
+- [Dark theme](docs/screenshots/barnaby-dark.png)
+- [Light theme](docs/screenshots/barnaby-light.png)
+
+---
+
+## Features
+
+- Run multiple AI agent sessions simultaneously
+- Compare models side-by-side in split or grid layouts
+- Orchestrate workflows between agents from a shared workspace
+- Works with existing CLI tools such as Codex, Claude Code, and Gemini CLI
+- Supports OpenRouter for API-based model access when CLI quotas are exhausted
+- Local-first architecture: your code stays on your machine
+- Multi-window agent and workspace management
+- Built for developers, with explorer, Git, settings, and streaming chat timelines
+
+---
+
+## Why Barnaby?
+
+Most AI coding tools operate one agent at a time.
+
+Barnaby is designed for parallel, role-based workflows where different agents handle different parts of the job while staying anchored to the same codebase.
+
+Example workflow:
+
+- Architecture agent: designs the solution
+- Coding agent: implements the change
+- Review agent: validates behavior and catches regressions
+
+All running in parallel from one desktop workspace.
+
+Barnaby is also pragmatic about provider choice. You can use the CLI tools you already pay for and sign into, or route requests through OpenRouter when you need broader model coverage.
+
+---
+
+## Installation
+
+Barnaby currently runs by cloning the repository locally.
+
+Requirements:
+
+- Node.js `>=20 <27` (Node 22 LTS recommended)
+- `npm`
+- Optional provider setup:
+  - Codex CLI
+  - Claude CLI / Claude Code
+  - Gemini CLI
+  - OpenRouter API key
+
+Clone and run in development:
+
+```sh
+git clone https://github.com/incendiosoftware/Barnaby.git
+cd Barnaby
+npm install
+npm run dev
+```
+
+Build a desktop package:
+
+```sh
+npm run build
+```
+
+Releases:
+
+- https://github.com/incendiosoftware/Barnaby/releases
+
+CLI sanity check after installing providers:
+
+```sh
+codex --version
+claude --version
+gemini --version
+```
+
+If the postinstall step reports that a native rebuild was skipped, the embedded terminal will usually still work via prebuilt binaries. Source rebuilds are only needed on platforms where prebuilds are unavailable.
+
+---
+
+## Architecture
+
+Barnaby acts as a local orchestration layer for AI agent processes and provider integrations.
+
+```text
+Barnaby Desktop UI
+        |
+        v
+  Workspace + Panel Manager
+        |
+        v
+ Provider / Agent Runtime Layer
+   |         |         |         |
+   v         v         v         v
+ Codex    Claude    Gemini   OpenRouter
+  CLI       CLI       CLI        API
+```
+
+At a high level:
+
+- `src/` contains the React renderer UI for panels, workspace tools, chat, and layout management
+- `electron/main/` manages desktop runtime concerns, provider clients, permissions, updates, and local orchestration
+- `electron/preload/` exposes the desktop bridge between the Electron main process and the renderer
+- The optional orchestrator plugin extends Barnaby with autonomous agent loops, shared state, and goal persistence
+
+Barnaby is local-first by design. Agent processes run on your machine, workspace context stays in your environment, and provider authentication remains with the CLI tools or API keys you configure.
+
+---
+
+## Roadmap
+
+Current capabilities:
+
+- Multi-agent workspace
+- CLI integration for Codex, Claude, and Gemini
+- OpenRouter model access
+- Local orchestration and workspace-aware context
+- Windowed desktop UI with split layouts and workspace tooling
+
+Planned improvements:
+
+- Richer agent collaboration workflows
+- Better remote and background agent control
+- Plugin ecosystem expansion
+- Stronger automation and orchestration primitives
+- More onboarding polish and demos for new users
+
+---
+
+## Contributing
+
+Contributions and feedback are welcome.
+
+Open an issue or submit a pull request if you want to help improve Barnaby.
+
+Additional docs:
+
+- [Contributing guide](CONTRIBUTING.md)
+- [Security policy](SECURITY.md)
+
+---
+
+## License
+
+MIT

package/bin/barnaby.cjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 'use strict'
 
 const { spawn } = require('child_process')
@@ -8,8 +8,10 @@ const pkgRoot = path.join(__dirname, '..')
 const mainPath = path.join(pkgRoot, 'dist-electron', 'main', 'index.js')
 
 const electron = require('electron')
+// stdio: 'ignore' when no TTY (e.g. Start menu shortcut) prevents a console window.
+// stdio: 'inherit' when run from terminal keeps plugin logs visible for debugging.
 const child = spawn(electron, [mainPath], {
-  stdio: 'inherit',
+  stdio: process.stdout?.isTTY ? 'inherit' : 'ignore',
   cwd: pkgRoot,
   env: { ...process.env }
 })