@barnaby.build/barnaby 0.0.132 → 0.0.171

package/README.md

@@ -9,42 +9,60 @@ Barnaby is a desktop AI agent orchestrator for **agentic coordination** — conn
 
 ## Installation
 
-### Option 1: Download (recommended)
+You can run Barnaby without cloning the repository. Choose one of the options below.
 
-[Download Barnaby](https://github.com/incendiosoftware/Barnaby/releases) — portable `.exe` for Windows. No install required.
+### Option 1: Download (recommended for Windows)
+
+[Download Barnaby](https://github.com/incendiosoftware/Barnaby/releases) — portable `.exe` for Windows. No install required. Best for correct Start menu and taskbar integration.
+
+1. Go to [Releases](https://github.com/incendiosoftware/Barnaby/releases)
+2. Download the latest `Barnaby_*_portable.exe`
+3. Run it — no installer, no Node.js needed
 
 ### Option 2: npm (requires Node.js 20+)
 
-**Quick run:**
+If you have Node.js installed, you can run Barnaby via npm without cloning:
+
+**Quick run (no install):**
 ```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.
+*PowerShell: use single quotes around the package name (e.g. `'@barnaby.build/barnaby'`). Without quotes, `@` is interpreted as a variable.*
 
----
+**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. Pinning the window shows "Electron" because npm runs the electron binary directly.
+- If the shortcut has no icon: **Edit → Application Settings → Preferences** → **Repair Start menu shortcut**.
+- For the full experience (correct icon everywhere), use the [portable exe](https://github.com/incendiosoftware/Barnaby/releases).
 
-Latest Binary Release  
-[Download Barnaby v0.0.125](https://github.com/incendiosoftware/Barnaby/releases/tag/v0.0.125)
+### Orchestrator plugin (optional)
 
-Website: https://barnaby.build  
-Written By: Stuart Mackereth  
-Company: Incendio Trading Limited  
-Email: incendiosoftware@gmail.com  
+The Orchestrator is an optional add-on for autonomous agent loops. It is **not** bundled with Barnaby.
 
-## Screenshots
+- **Install:** Edit → Application Settings → Orchestrator → **Install from npm**
+- **Uninstall:** Edit → Application Settings → Orchestrator → **Uninstall**
+- **Manual:** `cd ~/.barnaby/plugins` (or `%USERPROFILE%\.barnaby\plugins` on Windows), then `npm install '@barnaby.build/orchestrator'` or `npm uninstall '@barnaby.build/orchestrator'`
+
+---
+
+Stuart Mackereth  
+https://barnaby.build  
+incendiosoftware@gmail.com  
+Incendio Trading Limited  
 
-![Barnaby dark screenshot](docs/screenshots/barnaby-dark.png)
+## Screenshots
 
-![Barnaby light screenshot](docs/screenshots/barnaby-light.png)
+<p align="center">
+  <img src="docs/screenshots/barnaby-dark.png" width="45%" alt="Barnaby dark" />
+  <img src="docs/screenshots/barnaby-light.png" width="45%" alt="Barnaby light" />
+</p>
 
 ## Overview
 
@@ -70,13 +88,28 @@ Barnaby unifies **CLI-based** providers (Codex, Claude, Gemini) and **API-based*
 
 Compared to single-chat tools: Barnaby gives you parallel windowed agents and workspace-aware orchestration.
 
+## Orchestrator (optional add-on)
+
+The **Orchestrator** is an optional plugin that extends Barnaby beyond single-turn chat. It is a persistent management engine for **autonomous agent loops** — set a goal, define guardrails, and let agents work until the task is complete.
+
+**What it does:**
+- **Cross-agent state sync** — Agents share context across panels (e.g. backend signals schema changes to frontend)
+- **Goal persistence** — Stores a hierarchy of goals; pauses and resumes on failure or rate limits
+- **Deterministic guardrails** — Intercepts output to verify linting and security rules before committing to the workspace
+
+The Orchestrator is **not** bundled with Barnaby. Install it from Settings (Edit → Application Settings → Orchestrator → Install from npm) if you want autonomous, multi-stage development. See [barnaby.build](https://barnaby.build) for more details.
+
 ## Prerequisites
 
-- Node.js 18+ recommended
-- npm
+- **Node.js 20+** (recommended: Node 22 LTS)
+- **npm**
 - **CLI providers** (optional): Codex, Claude, and/or Gemini CLI installed and authenticated
 - **API provider** (optional): OpenRouter API key from https://openrouter.ai/keys
 
+### Built-in terminal note
+
+The embedded terminal uses `node-pty`, which ships with prebuilt binaries for Windows, macOS, and Linux. No extra tools are needed. If the prebuilds don't load on your platform, `npm install` will attempt a source rebuild (requires Python 3 and C++ build tools). This is rare — the prebuilds work on most systems.
+
 ## Provider Coverage
 
 | Provider   | Type | Setup                                      |
@@ -111,15 +144,19 @@ gemini --version
 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
+## Development (from source)
 
-From repo root:
+To build and run from the cloned repository:
 
 ```sh
+git clone https://github.com/incendiosoftware/Barnaby.git
+cd Barnaby
 npm install
 npm run dev
 ```
 
+If the postinstall step reports "Native module rebuild skipped", the terminal may still work via prebuilt binaries. If not, see [Prerequisites](#built-in-terminal-note).
+
 ## Build Commands (Standard Nomenclature)
 
 | Command | Meaning | Script |

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 }
 })