octoally 1.0.7

package/LICENSE

@@ -0,0 +1,223 @@
+Apache License 2.0 with Commons Clause
+
+"Commons Clause" License Condition v1.0
+
+The Software is provided to you by the Licensor under the Apache License,
+Version 2.0 (the "License"), as defined below, subject to the following
+condition.
+
+Without limiting other conditions in the License, the grant of rights under
+the License will not include, and the License does not grant to you, the
+right to Sell the Software.
+
+For purposes of the foregoing, "Sell" means providing to third parties, for a
+fee or other consideration (including without limitation fees for hosting or
+consulting/support services related to the Software), a product or service
+whose value derives, entirely or substantially, from the functionality of the
+Software. Any product or service that incorporates substantial portions of the
+Software must be made available free of charge.
+
+For clarity, the following uses are expressly permitted:
+- Using the Software as a tool or workflow to develop other products or
+  services that you charge for, provided the Software itself is not included
+  in the distributed product.
+- Modifying the Software for private, internal use without distributing it.
+- Distributing modified or unmodified copies of the Software, provided such
+  distribution is free of charge.
+
+Original Author: AI Genius Automations (https://aigeniusautomations.com)
+
+---
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 AI Genius Automations (https://aigeniusautomations.com)
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+   Subject to the "Commons Clause" License Condition v1.0 above.

package/README.md

@@ -0,0 +1,281 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/ai-genius-automations/octoally/59dc5a2/dashboard/public/octoally-logo-lg.png" alt="OctoAlly" width="500">
+  <p align="center">
+    <strong>AI Coding Session Orchestration Dashboard</strong>
+  </p>
+  <p align="center">
+    The dashboard for Claude Code &amp; OpenAI Codex. Launch, monitor, and manage AI coding sessions<br>
+    with <a href="https://github.com/ruvnet/ruflo">RuFlo</a> multi-agent orchestration — all from one place.
+  </p>
+</p>
+
+<p align="center">
+  <a href="https://github.com/ai-genius-automations/octoally/stargazers"><img src="https://img.shields.io/github/stars/ai-genius-automations/octoally?style=flat&color=gold" alt="GitHub Stars"></a>
+  <a href="https://github.com/ai-genius-automations/octoally/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0%20+%20Commons%20Clause-blue" alt="License"></a>
+  <a href="https://github.com/ai-genius-automations/octoally/releases"><img src="https://img.shields.io/github/v/release/ai-genius-automations/octoally?color=green" alt="Release"></a>
+  <a href="https://octoally.com"><img src="https://img.shields.io/badge/website-octoally.com-blue" alt="Website"></a>
+  <a href="https://aigeniusautomations.com"><img src="https://img.shields.io/badge/by-AI%20Genius%20Automations-purple" alt="AI Genius Automations"></a>
+</p>
+
+---
+
+> **OctoAlly** is a local-first orchestration dashboard for [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [OpenAI Codex](https://github.com/openai/codex), and [RuFlo](https://github.com/ruvnet/ruflo). Run multi-agent hive-mind sessions, single-agent workflows, and interactive terminals — with both Claude and Codex CLIs — all from a beautiful web UI with real-time streaming.
+
+---
+
+## Screenshots
+
+<p align="center">
+<img src="docs/screenshots/active-sessions.png" alt="Active Sessions Grid" width="100%">
+</p>
+
+**Active Sessions Grid** — Monitor all your AI coding sessions at a glance. The grid view shows every running session across all projects — hive-mind agents, solo Claude Code sessions, and terminals — each with live-streaming output. Click any cell to expand, or use the column controls to fit your screen.
+
+<table>
+<tr>
+<td width="50%">
+<img src="docs/screenshots/projects.png" alt="Project Management">
+<p><b>Project Management</b> — Organize all your projects in one place. Add project folders, track RuFlo status, manage git repos and branches, and launch sessions directly from the project card. Each project gets its own configuration and session history.</p>
+</td>
+<td width="50%">
+<img src="docs/screenshots/hivemind.png" alt="Hive-Mind Session">
+<p><b>Hive-Mind Session</b> — Multi-agent orchestration powered by RuFlo. A coordinator agent breaks your objective into subtasks, delegates to specialized workers, and uses Byzantine consensus to merge results. Shared memory and HNSW vector search let agents build on each other's work.</p>
+</td>
+</tr>
+<tr>
+<td width="50%">
+<img src="docs/screenshots/terminal.png" alt="Terminal Session">
+<p><b>Interactive Terminals</b> — Full terminal sessions managed through tmux. Pop out to a system terminal anytime, do your work, then adopt the session back into OctoAlly — it picks up right where you left off. Sessions persist across server restarts.</p>
+</td>
+<td width="50%">
+<img src="docs/screenshots/source.png" alt="Git Source Control">
+<p><b>Git Source Control</b> — Built-in git integration with side-by-side diffs, staged/unstaged changes, commit history, and a file explorer. Review what your AI agents changed, stage files, and commit — all without leaving the dashboard.</p>
+</td>
+</tr>
+</table>
+
+**More highlights:**
+
+- **Reconnect anytime** — Close a tab, restart the server, even reboot — every session is backed by tmux and persists. Reconnect and pick up exactly where you left off with full scrollback.
+- **Pop out & adopt back** — Open any session in your system terminal (`tmux attach`), work with your favorite tools, then bring it back into the dashboard. No lock-in.
+- **Voice dictation** — Speak your instructions using local Whisper STT (no cloud, no data leaves your machine) or cloud APIs like OpenAI/Groq. API keys are encrypted at rest with AES-256-GCM.
+- **Per-project agents** — Define custom agent personas in `.claude/agents/*.md` and launch them from the dashboard. Each project gets its own RuFlo config and agent definitions.
+- **Dual CLI support** — Launch sessions with either Claude Code or OpenAI Codex. Each session tracks which CLI it uses, with branded icons and separate configuration.
+
+---
+
+## Features
+
+- **Active Sessions Grid** — See every running session across all projects in a live-updating grid with real-time streaming output
+- **Hive-Mind Sessions** — Launch multi-agent orchestration via [RuFlo](https://github.com/ruvnet/ruflo) with shared memory and consensus — supports both Claude Code and Codex
+- **Agent Sessions** — Run single-agent sessions with Claude Code (`.claude/agents/*.md`) or Codex
+- **Dual CLI Support** — Switch between Claude Code and OpenAI Codex per-session with branded icons, separate commands, and per-CLI settings
+- **Interactive Terminals** — Full terminal sessions with tmux persistence — pop out to system terminal and adopt back anytime
+- **Built-in Web Browser** — Browse and test web apps alongside your coding sessions with full OAuth support
+- **Git Source Control** — Side-by-side diffs, staged changes, commit history, and file explorer — review and commit AI-generated changes in-app
+- **File Explorer** — Browse your project files, open and edit them, all from the sidebar
+- **Session Persistence** — Every session survives server restarts, tab closes, and reboots — reconnect with full scrollback
+- **Real-Time Streaming** — WebSocket-powered live output, tool calls, and progress tracking
+- **Multi-Project Support** — Per-project RuFlo initialization, agent configurations, and task queues
+- **Voice Dictation** — Speak your instructions via local Whisper or cloud APIs (OpenAI, Groq) — keys encrypted at rest
+- **Desktop App** — Electron system tray app with auto-launch, server management, and native STT
+
+---
+
+## Quick Install
+
+### Supported Platforms
+
+| Platform | Status |
+|----------|--------|
+| **Linux** (Ubuntu/Debian) | Fully supported |
+| **macOS** (Intel & Apple Silicon) | Fully supported |
+
+### Prerequisites
+
+| Requirement | Why | Install |
+|-------------|-----|---------|
+| **Node.js 20+** | Runtime for the server | [nodejs.org](https://nodejs.org) |
+| **Claude Code** | Anthropic's AI coding agent | `npm install -g @anthropic-ai/claude-code` |
+| **Codex CLI** *(optional)* | OpenAI's AI coding agent | `npm install -g @openai/codex` |
+
+> **Important:** Before installing OctoAlly, you must run Claude Code at least once to accept terms and enable non-interactive mode:
+> ```bash
+> claude                              # Accept terms & sign in
+> claude --dangerously-skip-permissions  # Enable non-interactive agent sessions
+> ```
+>
+> For Codex support, also run:
+> ```bash
+> codex                               # Accept terms & sign in
+> ```
+
+### One-Line Install
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ai-genius-automations/octoally/main/scripts/install.sh | bash
+```
+
+The installer will:
+1. Check for Node.js and Claude Code (offer to install if missing)
+2. Verify Claude Code has been initialized
+3. Download and extract the pre-built release
+4. Install the `octoally` CLI
+5. Start the server
+6. Optionally install the desktop app
+
+> **Custom install location:** `OCTOALLY_INSTALL_DIR=/opt/octoally bash install.sh`
+
+### What you get
+
+- **Web Dashboard:** http://localhost:42010
+- **CLI:** `octoally start | stop | restart | status | update | logs`
+- **Desktop App:** Optional Electron app with system tray and speech-to-text
+
+### Manual Install (Development)
+
+```bash
+git clone https://github.com/ai-genius-automations/octoally.git
+cd octoally
+
+# Server
+cd server && npm install && npm run build && cd ..
+
+# Dashboard
+cd dashboard && npm install && npm run build && cd ..
+
+# Start
+cd server && npm start
+```
+
+- **Dashboard:** http://localhost:42010
+- **Dev mode (with hot reload):** `cd server && npm run dev` + `cd dashboard && npm run dev`
+
+---
+
+## How It Works
+
+OctoAlly is a dashboard that sits on top of **Claude Code**, **OpenAI Codex**, and **RuFlo**:
+
+- **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** is Anthropic's CLI agent for coding tasks (uses `CLAUDE.md` for project instructions)
+- **[OpenAI Codex](https://github.com/openai/codex)** is OpenAI's CLI agent for coding tasks (uses `AGENTS.md` for project instructions)
+- **[RuFlo](https://github.com/ruvnet/ruflo)** adds multi-agent orchestration, hive-mind coordination, and memory to both CLIs
+- **OctoAlly** provides the UI to manage projects, launch sessions, and monitor everything in real-time
+
+When you add a project and enable RuFlo, OctoAlly automatically initializes the project with agent definitions, hive-mind support, and the configuration files both CLIs need (`CLAUDE.md` + `AGENTS.md`). You can then launch sessions with either Claude or Codex directly from the dashboard — each session tracks which CLI is running, with branded icons and per-CLI settings.
+
+---
+
+## CLI Commands
+
+```bash
+octoally start              # Start the server (background)
+octoally stop               # Stop the server
+octoally restart            # Restart
+octoally status             # Show version, channel, and update info
+octoally update             # Check for and apply updates
+octoally channel [name]     # Switch release channel (stable/beta/canary)
+octoally logs               # Tail server logs
+octoally install-service    # Install as systemd/launchd service (auto-start)
+octoally uninstall-service  # Remove the system service
+```
+
+---
+
+## Architecture
+
+```
+┌──────────────────────┐     WebSocket      ┌─────────────────────────┐
+│   Dashboard (React)  │ <────────────────> │    Server (Fastify)     │
+│   Vite + Tailwind    │                    │    SQLite + WebSocket   │
+│   TanStack Query     │                    │                         │
+│   Zustand            │                    │    PTY Worker           │
+└──────────────────────┘                    │    ├── tmux sessions    │
+                                            │    ├── Claude Code      │
+┌──────────────────────┐                    │    ├── RuFlo agents     │
+│   Desktop (Electron) │                    │    └── Terminal shells  │
+│   System tray        │ <────────────────> │                         │
+│   Speech-to-text     │                    └─────────────────────────┘
+└──────────────────────┘
+```
+
+| Layer | Stack |
+|-------|-------|
+| **Frontend** | React 19, Vite, Tailwind CSS 4, TanStack Query, Zustand, xterm.js |
+| **Backend** | Fastify, TypeScript, SQLite (better-sqlite3), node-pty, WebSocket |
+| **Desktop** | Electron, system tray, local Whisper STT, AES-256-GCM config encryption |
+| **Sessions** | tmux for persistence, dtach for detach/reattach, Claude Code + RuFlo |
+
+---
+
+## Project Structure
+
+```
+octoally/
+├── server/              # Fastify backend
+│   └── src/
+│       ├── routes/      # REST API endpoints
+│       ├── services/    # Session manager, PTY worker, state tracking
+│       └── db/          # SQLite schema and migrations
+├── dashboard/           # React frontend
+│   └── src/
+│       ├── components/  # UI components
+│       └── lib/         # API client, stores, utilities
+├── desktop-electron/    # Electron desktop app
+│   └── src/
+│       └── speech/      # Whisper STT integration
+├── bin/                 # CLI launcher
+└── scripts/             # Install, release, build-archive, update, and service scripts
+```
+
+---
+
+## Configuration
+
+Copy `.env.example` to `.env` in the project root:
+
+```bash
+cp .env.example .env
+```
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `PORT` | `42010` | Server port |
+| `OCTOALLY_TOKEN` | *(none)* | Auth token for API/WebSocket — leave empty for local use |
+| `DB_PATH` | `~/.octoally/octoally.db` | SQLite database path |
+| `LOG_LEVEL` | `info` | Log verbosity (`trace` / `debug` / `info` / `warn` / `error`) |
+| `OCTOALLY_USE_TMUX` | `true` | Use tmux for session management |
+| `OCTOALLY_USE_DTACH` | `true` | Use dtach for session persistence |
+
+---
+
+## Desktop App
+
+The Electron desktop app adds:
+- System tray with quick server access
+- Automatic server lifecycle management
+- Local speech-to-text via Whisper (no cloud needed)
+- Cloud STT via OpenAI Whisper API or Groq (API keys encrypted at rest)
+
+The desktop app is offered during installation, or can be downloaded from [GitHub Releases](https://github.com/ai-genius-automations/octoally/releases).
+
+---
+
+## Contributing
+
+Contributions are welcome! Please open an issue or pull request.
+
+1. Fork the repo
+2. Create a feature branch (`git checkout -b feature/my-feature`)
+3. Commit your changes
+4. Push and open a PR
+
+---
+
+## License
+
+**Apache License 2.0 with Commons Clause** — see [LICENSE](LICENSE) for full details.
+
+You are free to use, modify, and distribute OctoAlly. You may use it as a tool in your workflow to build products you charge for. However, you may not sell products or services whose value derives substantially from OctoAlly itself. Any product that incorporates OctoAlly source code must be distributed free of charge.
+
+Copyright 2025 [AI Genius Automations](https://aigeniusautomations.com)

package/cli.mjs

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+// OctoAlly CLI — thin npm wrapper
+// Installs OctoAlly from GitHub releases, then proxies commands to the local CLI.
+
+import { execSync, spawn } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { createInterface } from "node:readline";
+
+const INSTALL_DIR = process.env.OCTOALLY_INSTALL_DIR || join(homedir(), "octoally");
+const GITHUB_REPO = "ai-genius-automations/octoally";
+const LOCAL_CLI = join(INSTALL_DIR, "bin", "octoally");
+
+const CYAN = "\x1b[36m";
+const GREEN = "\x1b[32m";
+const YELLOW = "\x1b[33m";
+const RED = "\x1b[31m";
+const BOLD = "\x1b[1m";
+const NC = "\x1b[0m";
+
+function log(color, msg) {
+  console.log(`${color}[OctoAlly]${NC} ${msg}`);
+}
+
+function isInstalled() {
+  return existsSync(LOCAL_CLI) && existsSync(join(INSTALL_DIR, "server", "dist"));
+}
+
+async function getLatestVersion() {
+  const res = await fetch(`https://api.github.com/repos/${GITHUB_REPO}/releases?per_page=5`);
+  if (!res.ok) throw new Error(`GitHub API error: ${res.status}`);
+  const releases = await res.json();
+  const stable = releases.find((r) => !r.draft && !r.prerelease) || releases[0];
+  if (!stable) throw new Error("No releases found");
+  return { tag: stable.tag_name, version: stable.tag_name.replace(/^v/, ""), url: stable.html_url };
+}
+
+async function install() {
+  log(CYAN, "Installing OctoAlly...");
+  log(CYAN, `Install directory: ${INSTALL_DIR}`);
+
+  // Check prerequisites
+  try {
+    execSync("node --version", { stdio: "pipe" });
+  } catch {
+    log(RED, "Node.js is required. Install it from https://nodejs.org");
+    process.exit(1);
+  }
+
+  // Get latest release
+  log(CYAN, "Fetching latest release...");
+  const { version } = await getLatestVersion();
+  log(CYAN, `Latest version: v${version}`);
+
+  // Clone and build
+  if (!existsSync(INSTALL_DIR)) {
+    log(CYAN, "Cloning repository...");
+    execSync(`git clone --depth 1 https://github.com/${GITHUB_REPO}.git "${INSTALL_DIR}"`, {
+      stdio: "inherit",
+    });
+  } else {
+    log(CYAN, "Updating existing installation...");
+    execSync("git pull --ff-only", { cwd: INSTALL_DIR, stdio: "inherit" });
+  }
+
+  // Install dependencies
+  log(CYAN, "Installing dependencies...");
+  execSync("npm install", { cwd: INSTALL_DIR, stdio: "inherit" });
+  execSync("npm install", { cwd: join(INSTALL_DIR, "server"), stdio: "inherit" });
+  execSync("npm install", { cwd: join(INSTALL_DIR, "dashboard"), stdio: "inherit" });
+
+  // Build
+  log(CYAN, "Building...");
+  execSync("npm run build", { cwd: INSTALL_DIR, stdio: "inherit" });
+
+  // Symlink CLI to PATH
+  const binDir = join(homedir(), ".local", "bin");
+  mkdirSync(binDir, { recursive: true });
+  const symlinkTarget = join(binDir, "octoally");
+  try {
+    execSync(`ln -sf "${LOCAL_CLI}" "${symlinkTarget}"`, { stdio: "pipe" });
+    log(GREEN, `Symlinked to ${symlinkTarget}`);
+  } catch {
+    log(YELLOW, `Could not create symlink at ${symlinkTarget}`);
+  }
+
+  log(GREEN, `OctoAlly v${version} installed successfully!`);
+  log(CYAN, `Start with: octoally start`);
+  log(CYAN, `Dashboard:  http://localhost:42010`);
+}
+
+function proxyCommand(args) {
+  const child = spawn(LOCAL_CLI, args, {
+    stdio: "inherit",
+    cwd: INSTALL_DIR,
+  });
+  child.on("exit", (code) => process.exit(code ?? 0));
+  child.on("error", (err) => {
+    log(RED, `Failed to run: ${err.message}`);
+    process.exit(1);
+  });
+}
+
+// Main
+const args = process.argv.slice(2);
+const command = args[0] || "help";
+
+if (command === "install" || !isInstalled()) {
+  if (!isInstalled()) {
+    log(YELLOW, "OctoAlly is not installed yet.");
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise((resolve) => {
+      rl.question(`${BOLD}Install to ${INSTALL_DIR}? [Y/n]:${NC} `, resolve);
+    });
+    rl.close();
+    if (answer.toLowerCase() === "n") {
+      log(CYAN, "Installation cancelled.");
+      process.exit(0);
+    }
+  }
+  try {
+    await install();
+    // If there were additional args beyond "install", run them
+    if (command !== "install" && command !== "help") {
+      proxyCommand(args);
+    }
+  } catch (err) {
+    log(RED, `Installation failed: ${err.message}`);
+    process.exit(1);
+  }
+} else {
+  proxyCommand(args);
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "octoally",
+  "version": "1.0.7",
+  "description": "AI coding session orchestration dashboard — launch, monitor, and manage Claude Code & OpenAI Codex sessions from a web UI",
+  "type": "module",
+  "bin": {
+    "octoally": "cli.mjs"
+  },
+  "files": [
+    "cli.mjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "claude-code",
+    "codex",
+    "ai",
+    "dashboard",
+    "terminal",
+    "orchestration",
+    "multi-agent",
+    "developer-tools",
+    "cli"
+  ],
+  "scripts": {
+    "dev": "concurrently \"npm run dev:server\" \"npm run dev:dashboard\"",
+    "dev:server": "cd server && npm run dev",
+    "dev:dashboard": "cd dashboard && npm run dev",
+    "build": "npm run build:dashboard && npm run build:server",
+    "build:server": "cd server && npm run build",
+    "build:dashboard": "cd dashboard && npm run build",
+    "start": "cd server && npm start",
+    "install:all": "npm install && cd server && npm install && cd ../dashboard && npm install",
+    "clean": "cd server && rm -rf dist && cd ../dashboard && rm -rf dist"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "better-sqlite3": "^12.8.0",
+    "concurrently": "^9.1.0"
+  },
+  "author": "AI Genius Automations <support@aigeniusautomations.com>",
+  "license": "Apache-2.0 WITH Commons-Clause",
+  "homepage": "https://octoally.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ai-genius-automations/octoally.git"
+  },
+  "dependencies": {
+    "@xterm/addon-web-links": "^0.12.0"
+  }
+}