@betterborg/cli 0.1.0 → 0.1.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 BetterBorg
+Copyright (c) 2026 Betterborg
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/NOTICE

@@ -1,7 +1,7 @@
-BetterBorg CLI
-Copyright 2026 BetterBorg
+Betterborg CLI
+Copyright 2026 Betterborg
 
-This product includes software developed by BetterBorg
+This product includes software developed by Betterborg
 (https://github.com/betterborg).
 
-BetterBorg CLI is distributed under the MIT License. See LICENSE.
+Betterborg CLI is distributed under the MIT License. See LICENSE.

package/README.md

@@ -0,0 +1,76 @@
+# @betterborg/cli
+
+Betterborg is an AI engineering team for substantial software projects, not a chat window that makes an isolated edit. You give it a task or a PRD; agents investigate your real code, write a reviewed technical plan, decompose it into a dependency graph of tasks, and implement them, each in its own isolated Git worktree. You approve the plan before anything is decomposed, and the estimate before anything runs. It works locally, on your own Claude Code or Codex subscription.
+
+> [!NOTE]
+> Pre-alpha. Interfaces may change between releases.
+
+This package is a launcher, not the CLI itself. It resolves a `betterborg` matching its own version, then forwards your arguments, stdio, and signals to it. Nothing is downloaded at install time.
+
+## Try it
+
+```bash
+npx --yes @betterborg/cli version
+```
+
+## Install
+
+```bash
+npm install --global @betterborg/cli
+```
+
+Then activate the agent-host integrations, which need a persistent install rather than `npx`:
+
+```bash
+betterborg plugins install --all
+```
+
+Run `/reload-plugins` in any open Claude Code session, and start a new Codex session when prompted.
+
+From inside a Git repository, run the loop:
+
+```bash
+betterborg trust                     # trust this worktree (machine-local)
+betterborg init                      # register and analyze the repository
+betterborg create my-feature         # or: betterborg create my-feature --prd spec.md
+betterborg plan start my-feature     # agents plan, review, and iterate
+betterborg plan approve my-feature   # your gate: nothing is decomposed before this
+betterborg task estimate my-feature  # P50/P80 work and cost
+betterborg execute my-feature        # approve the estimate, then run
+```
+
+`betterborg execute` hands off reviewed local branches. Add `--push` or `--pr` to publish them. `betterborg --help` is the full command index.
+
+## How the launcher finds the CLI
+
+On each run, in order:
+
+1. **An installed `betterborg` on `PATH`**, if `betterborg version` reports this package's exact version. A `pip install betterborg` or the standalone installer takes over from here, and the launcher adds nothing.
+2. **The standalone release binary** for macOS and Linux on arm64 or x86_64. It is fetched from the matching GitHub release, verified against the published SHA-256 digest, and cached under `$XDG_CACHE_HOME/betterborg/cli/<version>`, or `~/.cache/betterborg/cli/<version>`, so later runs reuse it. A binary that fails verification is discarded, never executed.
+3. **`uvx --from betterborg==<version> betterborg`**, if [uv](https://docs.astral.sh/uv/) is on `PATH`.
+
+If none of those resolve, the launcher exits with what it tried and how to fix it.
+
+## Requirements
+
+- Node.js 18+ to run the launcher.
+- macOS or Linux. On Windows, use a WSL2 shell.
+- One agent transport: a `claude` or `codex` CLI on `PATH` and **already logged in**, or `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` exported in your shell.
+
+Step 3 additionally needs Python 3.11+, which `uv` will provide.
+
+Keep provider keys in your shell or a secret manager, never in `.betterborg/config.toml` or any tracked file.
+
+## Documentation
+
+- [Installation guide](https://github.com/betterborg/betterborg-cli/blob/main/docs/installation.md): version pinning, WSL2, providers, recovery
+- [Command guide](https://github.com/betterborg/betterborg-cli/blob/main/docs/commands.md): bootstrap and initialization
+- [Repository](https://github.com/betterborg/betterborg-cli)
+
+## Reporting bugs
+
+File a [GitHub issue](https://github.com/betterborg/betterborg-cli/issues).
+
+## License
+
+Copyright 2026 Betterborg. Licensed under the [MIT License](https://github.com/betterborg/betterborg-cli/blob/main/LICENSE). See [NOTICE](https://github.com/betterborg/betterborg-cli/blob/main/NOTICE) for attribution.

package/lib/launcher.js

@@ -18,7 +18,7 @@ function targetFor(platform, architecture) {
   if (!operatingSystem || !targetArchitecture) {
     return null;
   }
-  return `borg-${operatingSystem}-${targetArchitecture}`;
+  return `betterborg-${operatingSystem}-${targetArchitecture}`;
 }
 
 function translateVersionArguments(arguments_) {
@@ -110,8 +110,8 @@ function launcherExecutables(dependencies) {
       }
       const names =
         dependencies.platform === "win32"
-          ? ["borg", "borg.cmd", "borg.ps1"]
-          : ["borg"];
+          ? ["betterborg", "betterborg.cmd", "betterborg.ps1"]
+          : ["betterborg"];
       for (const shimDirectory of shimDirectories) {
         for (const name of names) {
           executables.push(dependencies.pathModule.resolve(shimDirectory, name));
@@ -158,7 +158,7 @@ function executableOnPath(name, dependencies, excludedPaths = []) {
 
 function installedCli(version, dependencies) {
   const candidate = executableOnPath(
-    "borg",
+    "betterborg",
     dependencies,
     launcherExecutables(dependencies),
   );
@@ -182,7 +182,7 @@ function installedCli(version, dependencies) {
   );
   if (
     completed.status === 0 &&
-    completed.stdout.trim() === `borg ${version}`
+    completed.stdout.trim() === `betterborg ${version}`
   ) {
     return candidate;
   }
@@ -317,7 +317,7 @@ async function resolveCli(version, overrides = {}) {
   if (uvx) {
     return {
       command: uvx,
-      argumentsPrefix: ["--from", `betterborg==${version}`, "borg"],
+      argumentsPrefix: ["--from", `betterborg==${version}`, "betterborg"],
       source: "uvx",
     };
   }
@@ -326,7 +326,7 @@ async function resolveCli(version, overrides = {}) {
     ? `could not install the ${target} release${releaseFailure ? ` (${releaseFailure})` : ""}`
     : `no standalone release supports ${dependencies.platform}/${dependencies.architecture}`;
   throw new Error(
-    `${targetDescription}, and uvx is not on PATH. Install uv from https://docs.astral.sh/uv/ or install betterborg==${version} so borg is on PATH.`,
+    `${targetDescription}, and uvx is not on PATH. Install uv from https://docs.astral.sh/uv/ or install betterborg==${version} so betterborg is on PATH.`,
   );
 }
 
@@ -373,7 +373,7 @@ function launch(resolved, arguments_, overrides = {}) {
       if (settled) return;
       settled = true;
       cleanup();
-      reject(new Error(`could not start BetterBorg CLI: ${error.message}`));
+      reject(new Error(`could not start Betterborg CLI: ${error.message}`));
     });
     child.once("close", (code, signal) => {
       if (settled) return;
@@ -405,7 +405,7 @@ function reportFailure(error, dependencies = {}) {
   const logger = dependencies.console || console;
   const processLike = dependencies.process || process;
   const message = error instanceof Error ? error.message : String(error);
-  logger.error(`borg: ${message}`);
+  logger.error(`betterborg: ${message}`);
   processLike.exitCode = 1;
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@betterborg/cli",
-  "version": "0.1.0",
-  "description": "Installer and launcher for the BetterBorg CLI",
+  "version": "0.1.1",
+  "description": "Installer and launcher for the Betterborg CLI",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -12,11 +12,12 @@
   "bugs": "https://github.com/betterborg/betterborg-cli/issues",
   "type": "commonjs",
   "bin": {
-    "borg": "bin/borg.js"
+    "betterborg": "bin/betterborg.js"
   },
   "files": [
     "LICENSE",
     "NOTICE",
+    "README.md",
     "bin",
     "lib"
   ],
@@ -27,7 +28,7 @@
     "access": "public"
   },
   "scripts": {
-    "lint": "node --check bin/borg.js && node --check lib/launcher.js && node --check test/launcher.test.js",
+    "lint": "node --check bin/betterborg.js && node --check lib/launcher.js && node --check test/launcher.test.js",
     "test": "node --test test/launcher.test.js"
   }
 }