agency-cli 1.0.0

package/.gitignore

@@ -0,0 +1,2 @@
+/node_modules
+

package/CHANGELOG.md

@@ -0,0 +1,86 @@
+# Changelog
+
+## [0.2.0](https://github.com/tobias-walle/agency/compare/v0.1.1...v0.2.0) (2025-11-11)
+
+
+### Features
+
+* add option to select agent in TUI ([bde32b7](https://github.com/tobias-walle/agency/commit/bde32b74c4f8ed49eb81fea6eab9e22d1bc4fe1d))
+* add override config for socket path ([9f35a10](https://github.com/tobias-walle/agency/commit/9f35a10e8085637995b70ee0c5153c38a661f1b1))
+
+
+### Bug Fixes
+
+* avoid flickering in TUI then opening interactive program ([cc0b13d](https://github.com/tobias-walle/agency/commit/cc0b13d2921868b03006e707d68ae49217ad7e55))
+
+## [0.1.1](https://github.com/tobias-walle/agency/compare/v0.1.0...v0.1.1) (2025-11-10)
+
+
+### Bug Fixes
+
+* always attach to prevent missing cursor issues ([44d8217](https://github.com/tobias-walle/agency/commit/44d8217df9f55f715f20bc0eb112645f9989cee8))
+* don't copy folders if not included ([f6fc4d4](https://github.com/tobias-walle/agency/commit/f6fc4d4c172439e66f3a61a5c2392a430b9faa3d))
+
+## 0.1.0 (2025-11-10)
+
+
+### Features
+
+* add .gitignore entries on `init` ([1538a98](https://github.com/tobias-walle/agency/commit/1538a983e394034a75b5d7e689211a3bcacff37a))
+* add agency merge & agency open ([b17acfd](https://github.com/tobias-walle/agency/commit/b17acfd096e220f7e62b346589526c6d48c30e33))
+* add bootstrap cmd to prepare worktrees and drop attach prepare-only ([de9812d](https://github.com/tobias-walle/agency/commit/de9812d8d064c47f3571ee3ec1703409ecd2f44d))
+* add config loading ([947df9e](https://github.com/tobias-walle/agency/commit/947df9e191ed9ca1e54da0ea5cd3a1bad93faff4))
+* add event-driven tui with subscribe and input overlay ([28ddcfb](https://github.com/tobias-walle/agency/commit/28ddcfbe0b55edb6d298695c462b563f6ce53e0b))
+* add idle detection ([d3b598f](https://github.com/tobias-walle/agency/commit/d3b598f8afeac29c00e1b2f856c3cec036af8d36))
+* add missing commands to cli ([d7ba45f](https://github.com/tobias-walle/agency/commit/d7ba45f5e679bfbefbfd87d2d8748beec16705d3))
+* add multi session pty management ([9d3439f](https://github.com/tobias-walle/agency/commit/9d3439fb2758ee9e18b5f9bfe0be58e1212f95e2))
+* add setup cmd support ([b86cca6](https://github.com/tobias-walle/agency/commit/b86cca6ce82c434c040696c90cf484f0bd4fad72))
+* add TUI (phase 1) ([30da84d](https://github.com/tobias-walle/agency/commit/30da84d24e1e9100b7fe93d6b2a3e35ec3c6e3c5))
+* add worktrees, branches and new CLI commands per PLN-3 with centralized task resolution and tests ([0564b0c](https://github.com/tobias-walle/agency/commit/0564b0cf6f024c47d5fdd138c6ea4ccb5ec3d668))
+* copy ignored files & some folders on worktree creation ([df6ace1](https://github.com/tobias-walle/agency/commit/df6ace115495a214c19c03bd3b1f037dfaba8c3d))
+* copy pty-demo and add attach/daemon to enable PTY sessions ([0f8145a](https://github.com/tobias-walle/agency/commit/0f8145a33ec12b33c2f031c7fc8cebc04f97b125))
+* create setup, defaults and init command ([96a6c71](https://github.com/tobias-walle/agency/commit/96a6c71c87e51a1639d9c3dc24d7643d6ef27ec5))
+* default to attaching new tasks with --no-attach opt-out ([f503367](https://github.com/tobias-walle/agency/commit/f503367d027fcd50dd2a1dd9785f31a5ea2833f1))
+* enable task creation via new command with tty-aware output ([66b6b7a](https://github.com/tobias-walle/agency/commit/66b6b7af83a59492219107282580c6d60ee7965b))
+* extend agency default toml ([2f4df14](https://github.com/tobias-walle/agency/commit/2f4df14737acb99f4e348ee3767bd04867ff051f))
+* improve logging ([b056f52](https://github.com/tobias-walle/agency/commit/b056f520ed30a6ee6e200f389b23fa9199678798))
+* improve tui UX and add Stopped state ([3953ab5](https://github.com/tobias-walle/agency/commit/3953ab5c297a69ed72e9fab589a4db272f5ce89c))
+* improve tui ux by adding command logs ([71b67fc](https://github.com/tobias-walle/agency/commit/71b67fc298640f172986dee6d30a73074da12b42))
+* migrate from git2 to gix & git process ([ac6d417](https://github.com/tobias-walle/agency/commit/ac6d41794904fcf699df57d4a6733d70e7b7e9c0))
+* open editor on new tasks and inherit env and add --no-edit ([692f277](https://github.com/tobias-walle/agency/commit/692f2770b392fb18fc05f9a3f5f18473b00ecf5b))
+* parse keybindings from config and use for detach in client ([e6dfdaa](https://github.com/tobias-walle/agency/commit/e6dfdaa10c400f44ad842fb7807833a6877739bb))
+* **ps:** list tasks with reusable table helper and readable tests ([c765f42](https://github.com/tobias-walle/agency/commit/c765f42f0298f69525b8947aa6146c49b3bfe2a3))
+* record base_branch and use slug title, strip header in attach ([b1e37ef](https://github.com/tobias-walle/agency/commit/b1e37efc0449fba5a3e91f1139fb5f0d923f1fa7))
+* resolve duplicate slugs by auto-incrementing and attach by id ([a7fb6e0](https://github.com/tobias-walle/agency/commit/a7fb6e01c6359c512f1413708048bf6ca41dfa3f))
+* route child I/O to TUI and switch terminal just in time ([5c21a85](https://github.com/tobias-walle/agency/commit/5c21a8525580acfe426dbfbc46432286571a3da9))
+* show only task descriptions in editor ([2a5fcb3](https://github.com/tobias-walle/agency/commit/2a5fcb3f4b7ebcdd570a7ff3db2dd3850e4dc033))
+* soft-reset view after detach and TUI to avoid leftover modes ([0526d82](https://github.com/tobias-walle/agency/commit/0526d826a970eb301d56489f274952ef309bae2f))
+* support per-task agent selection with YAML front matter and reduce duplication ([d953138](https://github.com/tobias-walle/agency/commit/d95313848e1a1334d0639b621485f7e8bd7e81d4))
+* switch detach shortcut to ctrl-q to avoid SIGINT conflicts ([8decfb8](https://github.com/tobias-walle/agency/commit/8decfb888331e4de76be954fa7b7a5d165193541))
+* unify command placeholder expansion for agents and bootstrap ([fda9f16](https://github.com/tobias-walle/agency/commit/fda9f16a9a42ce7c707d872afa6e974f405c2a57))
+* wip ([dcca483](https://github.com/tobias-walle/agency/commit/dcca48384f25dcf7091d031274d4ad34793280fc))
+
+
+### Bug Fixes
+
+* allow merge with unstaged changes ([45e8551](https://github.com/tobias-walle/agency/commit/45e855163d0deaed3979587235ba5e449965c226))
+* allow stop at handshake and add ack with clearer logging to fix stop errors ([4431c97](https://github.com/tobias-walle/agency/commit/4431c97ee664757216ab87156ea6047f38937c81))
+* centralize notification handling and fix bug that tui wasn't updated after merge ([0626194](https://github.com/tobias-walle/agency/commit/0626194ce97e926c610572819315de319db601ba))
+* fix agency ps table formatting ([4500fa2](https://github.com/tobias-walle/agency/commit/4500fa24f46b223026a8782dcea191472bb7bdb8))
+* fix cursor request handling with codex ([d110150](https://github.com/tobias-walle/agency/commit/d110150ddec25de87ce09cdbb1b2aacc1be2e593))
+* fix idle detection and add logs ([a9776f7](https://github.com/tobias-walle/agency/commit/a9776f733eb6172ea6725c844401cbea52726916))
+* fix scroll issue in pty ([61dafdc](https://github.com/tobias-walle/agency/commit/61dafdc45fddd543711bb44ff87dcc938c4e546b))
+* fix tests ([8fa6fe0](https://github.com/tobias-walle/agency/commit/8fa6fe07a0ac3da3bce6e2073795b10ad57dc8fd))
+* fix warnings ([127a2f7](https://github.com/tobias-walle/agency/commit/127a2f7615eac6e76a862dd9fab42b55bc5d40aa))
+* improve error handling if daemon is stopped ([8baf449](https://github.com/tobias-walle/agency/commit/8baf449ae3ec8c43e840dd60fe478d1080b6d5de))
+* make ctrl-q detach work with extended keyboard via termwiz ([15e93d9](https://github.com/tobias-walle/agency/commit/15e93d9034c134aa0c0f560de0ede4db9e375266))
+* make enter reliably restart session and re-arm after each exit ([8c2b035](https://github.com/tobias-walle/agency/commit/8c2b03500ffdb8a39c722aaed95c143520d39d26))
+* reattach to session on same task ([2732a57](https://github.com/tobias-walle/agency/commit/2732a57967d469424b6119e0ef4d4f2fcdf3997b))
+* remove newline from frontmatter ([ee740de](https://github.com/tobias-walle/agency/commit/ee740de0e6543e3a932ee883954b4ea806e98e00))
+* remove redudant tests ([8c2f039](https://github.com/tobias-walle/agency/commit/8c2f0392e3193aea34b1414c167625ac5b32f9fa))
+* resolve clippy pedantic warnings and improve task markdown utils ([84dabc4](https://github.com/tobias-walle/agency/commit/84dabc458277f90eea6ac756a371389e0b1de78e))
+* resolve pedantic clippy lints to make just fix green ([8aa2924](https://github.com/tobias-walle/agency/commit/8aa292473d425c6b4a61deaf1ca5b4455b394f4c))
+* restore terminal state to avoid leftover extended keyboard modes ([63932a1](https://github.com/tobias-walle/agency/commit/63932a1bf94b3acd9c4ff69caf0ef054d200af46))
+* revert workaround ([015c07f](https://github.com/tobias-walle/agency/commit/015c07f9d252d09df5adb07809027a7e52d890aa))
+* track session status and broadcast after restart to update TUI ([e632a7b](https://github.com/tobias-walle/agency/commit/e632a7b8f52af887742a84074a13a1a96f198c61))
+* update fs after merge ([c1e9ed5](https://github.com/tobias-walle/agency/commit/c1e9ed58cfab32d1b0c83251e013a908af8f5851))

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Agency
+
+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,118 @@
+![Agency Logo](./media/logo.svg)
+
+# Agency
+
+Agency is an AI agent orchestrator running purely in the command line.
+
+- User-friendly TUI heavily inspired by [Lazygit](https://github.com/jesseduffield/lazygit)
+- CLI commands for easy automation
+- Supports any CLI coding agent: [Claude Code](https://github.com/anthropics/claude-code), [Codex CLI](https://github.com/openai/codex), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [OpenCode](https://github.com/sst/opencode) and [you can add more](#defining-a-custom-agent)
+  - Isolated environments for each task using Git worktrees
+
+## Getting Started
+
+1. Install Agency with your preferred method (macOS and Linux supported)
+   - Build from source: `cargo install --git <url>`
+   - NPM (_Coming soon_): `npm install -g @tobias-walle/agency`
+   - Homebrew (_Coming soon_): `brew install tobias-walle/tap/agency`
+2. Set up your preferences: `agency setup`
+3. Set up Agency in your project: `agency init`
+4. Start the TUI: `agency`
+
+## TUI or CLI: your choice
+
+The easiest option is to use the TUI; run `agency tui` or just `agency`.
+
+![TUI](./media/tui.png)
+
+Everything available in the TUI is also available via the CLI:
+
+- `agency --help` - See all available commands
+- `agency new my-task` - Start a new task with slug `my-task`; opens your `$EDITOR` to describe what the agent should do.
+- `agency new --draft my-task` - Create a new task as a draft (doesn't start it yet).
+- `agency edit my-task` - Edit a draft task.
+- `agency start my-task` - Start a task that is a draft or stopped.
+- `agency attach my-task` or `agency attach 1` - Open the agent TUI by slug or ID.
+- `agency stop my-task` - Stop a running task (keep its worktree and branch).
+- `agency merge my-task` - Merge the task back into the base branch.
+- `agency path my-task` - Get the worktree path for a task.
+- `agency shell my-task` - Open a shell in the task's worktree.
+- `agency ps` - List all tasks and their status.
+- `agency daemon start|stop|restart` - Manage the background daemon that runs the agents.
+- ... and many more (see `agency --help`).
+
+## Configuration
+
+Configuration is layered in three tiers:
+
+1. Defaults (see [crates/agency/defaults/agency.toml](./crates/agency/defaults/agency.toml) or `agency defaults`)
+2. Global file `~/.config/agency/agency.toml` (created by `agency setup`)
+3. Project overrides at `./.agency/agency.toml`
+
+### Defining a custom agent
+
+You can define custom agents using any CLI command.
+
+```toml
+[agents.my-agent]
+cmd = ["my-agent", "-p", "$AGENCY_TASK"]
+```
+
+The following environment variables are injected into the command:
+
+- `$AGENCY_TASK` - The full prompt for the current task.
+- `$AGENCY_ROOT` - The path to the folder of the main repo (not the worktree).
+
+You can also use the `<root>` placeholder for relative paths (works in any config in which you define a path).
+
+```toml
+[agents.my-local-agent]
+cmd = ["<root>./my-local-agent", "-p", "$AGENCY_TASK"]
+```
+
+Check out the [default config](./crates/agency/defaults/agency.toml) for a few examples.
+
+## Architecture
+
+Agency uses a daemon + client architecture. The daemon manages all PTY sessions that run the agents. Clients (CLI or TUI) communicate with the daemon via a Unix socket.
+
+The socket is stored in one of the following locations:
+
+- `$AGENCY_SOCKET_PATH` env override
+- `daemon.socket_path` in config
+- `$XDG_RUNTIME_DIR/agency.sock`
+- `~/.local/run/agency.sock` (Default)
+
+```mermaid
+flowchart LR
+  U[User] --> C[TUI/CLI]
+  C <--> S[Unix Socket]
+  S <--> D[Agency Daemon]
+  D --> P[PTY Sessions]
+  P --> A[CLI Agents]
+
+  subgraph Project
+    A
+  end
+```
+
+For example, when creating a new task the message flow between daemon and client looks like this:
+
+```mermaid
+sequenceDiagram
+  participant U as User
+  participant C as Agency CLI
+  participant D as Daemon
+  participant P as PTY Manager
+  participant A as Agent
+
+  U->>C: agency new my-task
+  C->>C: Create .agency/tasks/my-task.md
+  C->>D: OpenSession(project, task, cmd, worktree) via socket
+  D->>P: Spawn PTY session
+  P->>A: Exec agent cmd in worktree
+  C->>P: Attach to session (interactive)
+  U<<->>P: Terminal I/O
+  P->>D: Status updates
+  D->>C: Notifications
+```

package/binary-install.js

@@ -0,0 +1,212 @@
+const { createWriteStream, existsSync, mkdirSync, mkdtemp } = require("fs");
+const { join, sep } = require("path");
+const { spawnSync } = require("child_process");
+const { tmpdir } = require("os");
+
+const axios = require("axios");
+const rimraf = require("rimraf");
+const tmpDir = tmpdir();
+
+const error = (msg) => {
+  console.error(msg);
+  process.exit(1);
+};
+
+class Package {
+  constructor(platform, name, url, filename, zipExt, binaries) {
+    let errors = [];
+    if (typeof url !== "string") {
+      errors.push("url must be a string");
+    } else {
+      try {
+        new URL(url);
+      } catch (e) {
+        errors.push(e);
+      }
+    }
+    if (name && typeof name !== "string") {
+      errors.push("package name must be a string");
+    }
+    if (!name) {
+      errors.push("You must specify the name of your package");
+    }
+    if (binaries && typeof binaries !== "object") {
+      errors.push("binaries must be a string => string map");
+    }
+    if (!binaries) {
+      errors.push("You must specify the binaries in the package");
+    }
+
+    if (errors.length > 0) {
+      let errorMsg =
+        "One or more of the parameters you passed to the Binary constructor are invalid:\n";
+      errors.forEach((error) => {
+        errorMsg += error;
+      });
+      errorMsg +=
+        '\n\nCorrect usage: new Package("my-binary", "https://example.com/binary/download.tar.gz", {"my-binary": "my-binary"})';
+      error(errorMsg);
+    }
+
+    this.platform = platform;
+    this.url = url;
+    this.name = name;
+    this.filename = filename;
+    this.zipExt = zipExt;
+    this.installDirectory = join(__dirname, "node_modules", ".bin_real");
+    this.binaries = binaries;
+
+    if (!existsSync(this.installDirectory)) {
+      mkdirSync(this.installDirectory, { recursive: true });
+    }
+  }
+
+  exists() {
+    for (const binaryName in this.binaries) {
+      const binRelPath = this.binaries[binaryName];
+      const binPath = join(this.installDirectory, binRelPath);
+      if (!existsSync(binPath)) {
+        return false;
+      }
+    }
+    return true;
+  }
+
+  install(fetchOptions, suppressLogs = false) {
+    if (this.exists()) {
+      if (!suppressLogs) {
+        console.error(
+          `${this.name} is already installed, skipping installation.`,
+        );
+      }
+      return Promise.resolve();
+    }
+
+    if (existsSync(this.installDirectory)) {
+      rimraf.sync(this.installDirectory);
+    }
+
+    mkdirSync(this.installDirectory, { recursive: true });
+
+    if (!suppressLogs) {
+      console.error(`Downloading release from ${this.url}`);
+    }
+
+    return axios({ ...fetchOptions, url: this.url, responseType: "stream" })
+      .then((res) => {
+        return new Promise((resolve, reject) => {
+          mkdtemp(`${tmpDir}${sep}`, (err, directory) => {
+            let tempFile = join(directory, this.filename);
+            const sink = res.data.pipe(createWriteStream(tempFile));
+            sink.on("error", (err) => reject(err));
+            sink.on("close", () => {
+              if (/\.tar\.*/.test(this.zipExt)) {
+                const result = spawnSync("tar", [
+                  "xf",
+                  tempFile,
+                  // The tarballs are stored with a leading directory
+                  // component; we strip one component in the
+                  // shell installers too.
+                  "--strip-components",
+                  "1",
+                  "-C",
+                  this.installDirectory,
+                ]);
+                if (result.status == 0) {
+                  resolve();
+                } else if (result.error) {
+                  reject(result.error);
+                } else {
+                  reject(
+                    new Error(
+                      `An error occurred untarring the artifact: stdout: ${result.stdout}; stderr: ${result.stderr}`,
+                    ),
+                  );
+                }
+              } else if (this.zipExt == ".zip") {
+                let result;
+                if (this.platform.artifactName.includes("windows")) {
+                  // Windows does not have "unzip" by default on many installations, instead
+                  // we use Expand-Archive from powershell
+                  result = spawnSync("powershell.exe", [
+                    "-NoProfile",
+                    "-NonInteractive",
+                    "-Command",
+                    `& {
+                        param([string]$LiteralPath, [string]$DestinationPath)
+                        Expand-Archive -LiteralPath $LiteralPath -DestinationPath $DestinationPath -Force
+                    }`,
+                    tempFile,
+                    this.installDirectory,
+                  ]);
+                } else {
+                  result = spawnSync("unzip", [
+                    "-q",
+                    tempFile,
+                    "-d",
+                    this.installDirectory,
+                  ]);
+                }
+
+                if (result.status == 0) {
+                  resolve();
+                } else if (result.error) {
+                  reject(result.error);
+                } else {
+                  reject(
+                    new Error(
+                      `An error occurred unzipping the artifact: stdout: ${result.stdout}; stderr: ${result.stderr}`,
+                    ),
+                  );
+                }
+              } else {
+                reject(
+                  new Error(`Unrecognized file extension: ${this.zipExt}`),
+                );
+              }
+            });
+          });
+        });
+      })
+      .then(() => {
+        if (!suppressLogs) {
+          console.error(`${this.name} has been installed!`);
+        }
+      })
+      .catch((e) => {
+        error(`Error fetching release: ${e.message}`);
+      });
+  }
+
+  run(binaryName, fetchOptions) {
+    const promise = !this.exists()
+      ? this.install(fetchOptions, true)
+      : Promise.resolve();
+
+    promise
+      .then(() => {
+        const [, , ...args] = process.argv;
+
+        const options = { cwd: process.cwd(), stdio: "inherit" };
+
+        const binRelPath = this.binaries[binaryName];
+        if (!binRelPath) {
+          error(`${binaryName} is not a known binary in ${this.name}`);
+        }
+        const binPath = join(this.installDirectory, binRelPath);
+        const result = spawnSync(binPath, args, options);
+
+        if (result.error) {
+          error(result.error);
+        }
+
+        process.exit(result.status);
+      })
+      .catch((e) => {
+        error(e.message);
+        process.exit(1);
+      });
+  }
+}
+
+module.exports.Package = Package;

package/binary.js

@@ -0,0 +1,126 @@
+const { Package } = require("./binary-install");
+const os = require("os");
+const cTable = require("console.table");
+const libc = require("detect-libc");
+const { configureProxy } = require("axios-proxy-builder");
+
+const error = (msg) => {
+  console.error(msg);
+  process.exit(1);
+};
+
+const {
+  name,
+  artifactDownloadUrl,
+  supportedPlatforms,
+  glibcMinimum,
+} = require("./package.json");
+
+const builderGlibcMajorVersion = glibcMinimum.major;
+const builderGlibcMInorVersion = glibcMinimum.series;
+
+const getPlatform = () => {
+  const rawOsType = os.type();
+  const rawArchitecture = os.arch();
+
+  // We want to use rust-style target triples as the canonical key
+  // for a platform, so translate the "os" library's concepts into rust ones
+  let osType = "";
+  switch (rawOsType) {
+    case "Windows_NT":
+      osType = "pc-windows-msvc";
+      break;
+    case "Darwin":
+      osType = "apple-darwin";
+      break;
+    case "Linux":
+      osType = "unknown-linux-gnu";
+      break;
+  }
+
+  let arch = "";
+  switch (rawArchitecture) {
+    case "x64":
+      arch = "x86_64";
+      break;
+    case "arm64":
+      arch = "aarch64";
+      break;
+  }
+
+  if (rawOsType === "Linux") {
+    if (libc.familySync() == "musl") {
+      osType = "unknown-linux-musl-dynamic";
+    } else if (libc.isNonGlibcLinuxSync()) {
+      console.warn(
+        "Your libc is neither glibc nor musl; trying static musl binary instead",
+      );
+      osType = "unknown-linux-musl-static";
+    } else {
+      let libcVersion = libc.versionSync();
+      let splitLibcVersion = libcVersion.split(".");
+      let libcMajorVersion = splitLibcVersion[0];
+      let libcMinorVersion = splitLibcVersion[1];
+      if (
+        libcMajorVersion != builderGlibcMajorVersion ||
+        libcMinorVersion < builderGlibcMInorVersion
+      ) {
+        // We can't run the glibc binaries, but we can run the static musl ones
+        // if they exist
+        console.warn(
+          "Your glibc isn't compatible; trying static musl binary instead",
+        );
+        osType = "unknown-linux-musl-static";
+      }
+    }
+  }
+
+  // Assume the above succeeded and build a target triple to look things up with.
+  // If any of it failed, this lookup will fail and we'll handle it like normal.
+  let targetTriple = `${arch}-${osType}`;
+  let platform = supportedPlatforms[targetTriple];
+
+  if (!platform) {
+    error(
+      `Platform with type "${rawOsType}" and architecture "${rawArchitecture}" is not supported by ${name}.\nYour system must be one of the following:\n\n${Object.keys(
+        supportedPlatforms,
+      ).join(",")}`,
+    );
+  }
+
+  return platform;
+};
+
+const getPackage = () => {
+  const platform = getPlatform();
+  const url = `${artifactDownloadUrl}/${platform.artifactName}`;
+  let filename = platform.artifactName;
+  let ext = platform.zipExt;
+  let binary = new Package(platform, name, url, filename, ext, platform.bins);
+
+  return binary;
+};
+
+const install = (suppressLogs) => {
+  if (!artifactDownloadUrl || artifactDownloadUrl.length === 0) {
+    console.warn("in demo mode, not installing binaries");
+    return;
+  }
+  const package = getPackage();
+  const proxy = configureProxy(package.url);
+
+  return package.install(proxy, suppressLogs);
+};
+
+const run = (binaryName) => {
+  const package = getPackage();
+  const proxy = configureProxy(package.url);
+
+  package.run(binaryName, proxy);
+};
+
+module.exports = {
+  install,
+  run,
+  getPackage,
+};

package/install.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+const { install } = require("./binary");
+install(false);