@patrickdappollonio/dux 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Patrick D'appollonio
+
+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,41 @@
+# dux
+
+<img src="assets/dux-logo.png" width="200" align="right" />
+
+Your AI agents deserve a proper office. **dux** (pronounced "dooks") is a terminal UI that lets you run multiple AI coding agents side by side, each in its own git worktree, with full companion terminals, macros, commit generation, and a command palette that knows more tricks than you do.
+
+No protocol layers. No adapters. No JSON-RPC. Just real CLIs running in real terminals.
+
+dux is fast and keeps resource usage low, leaving more RAM for Claude, Codex, Gemini, OpenCode, or any other agent CLI you bring.
+
+## Why dux?
+
+Most AI coding tools give you one agent in one directory. dux gives you multiple agents across multiple worktrees, all visible at once. Spawn agents on separate branches, let them work in parallel, fork a session to try a different approach, and open companion terminals next to your agents for builds, tests, or manual inspection.
+
+Every agent runs through a PTY, the same pseudo-terminal your shell uses. Your MCP servers, hooks, skills, slash commands, and permission dialogs keep working because dux runs the real CLI tools you already use.
+
+## Install with npm
+
+Run dux directly with npx:
+
+```bash
+npx -y @patrickdappollonio/dux
+```
+
+Or install it globally:
+
+```bash
+npm install -g @patrickdappollonio/dux
+dux
+```
+
+## Prerequisites
+
+- **`git`** is required because dux is built around git worktrees.
+- **`gh` CLI** is optional. If authenticated, dux can pull PR statuses and check details inside the interface.
+
+## Documentation
+
+The full README, release downloads, Homebrew install instructions, shell installer, screenshots, and configuration documentation live in the GitHub repository:
+
+https://github.com/patrickdappollonio/dux

package/bin/dux.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const PLATFORM_TARGETS = [
+  { platform: "darwin", arch: "x64", key: "darwin-x64" },
+  { platform: "darwin", arch: "arm64", key: "darwin-arm64" },
+  { platform: "linux", arch: "x64", key: "linux-x64" },
+  { platform: "linux", arch: "arm64", key: "linux-arm64" }
+];
+
+const current = PLATFORM_TARGETS.find(
+  (target) => target.platform === process.platform && target.arch === process.arch
+);
+
+if (!current) {
+  throw new Error(
+    `Unsupported platform combination: ${process.platform}/${process.arch}. ` +
+      "Please open an issue to request support: " +
+      "https://github.com/patrickdappollonio/dux/issues/new"
+  );
+}
+
+const binaryName = "dux";
+const vendorRoot = path.join(__dirname, "..", "vendor", current.key);
+const binaryPath = path.join(vendorRoot, binaryName);
+
+if (!existsSync(binaryPath)) {
+  throw new Error(
+    `dux binary not found for ${current.key}. ` +
+      "Please reinstall the package or open an issue: " +
+      "https://github.com/patrickdappollonio/dux/issues/new"
+  );
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: process.env
+});
+
+child.on("error", (err) => {
+  console.error(`Failed to start dux: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 1);
+});

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@patrickdappollonio/dux",
+  "version": "0.1.0",
+  "description": "A terminal UI for running multiple AI coding agents side by side in isolated git worktrees.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "dux": "bin/dux.js"
+  },
+  "files": [
+    "bin",
+    "vendor",
+    "README.md",
+    "LICENSE",
+    "assets"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/patrickdappollonio/dux"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "cli",
+    "terminal",
+    "tui",
+    "worktrees"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}