@benkoppe/claude-tree 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ben Koppe
+
+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

@@ -1,3 +1,74 @@
-# Temporary Holding Version
+# claude-tree
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`/tree` (from `pi` agent) for Claude Code and other agents.
+
+`claude-tree` frees you from a linear history & turns a project's agent conversations into a navigable message tree. Every leaf corresponds to a distinct session:
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/benkoppe/claude-tree/main/docs/images/conversation-tree.png"
+       alt="claude-tree showing branching conversations with live sessions and new updates"
+       width="600">
+</p>
+
+Claude Code is used by default. To use Codex, pass `--codex`. Optionally, you can pass the project directory:
+
+```sh
+claude-tree /path/to/project
+claude-tree --codex /path/to/project
+```
+
+## Quick Start
+
+`claude-tree` is project-scoped. Run it inside your project folder.
+
+### npm (recommended)
+
+Requires Linux or macOS, Node.js 20+, Claude Code or Codex installed on `$PATH`, and a truecolor terminal using a Nerd Font.
+
+```sh
+npm install -g @benkoppe/claude-tree
+
+cd /path/to/project
+claude-tree
+```
+
+Run the install command again to update.
+
+### Bun (from source)
+
+With Bun 1.3.13+ installed, you can install the current `main` branch instead of a release:
+
+```sh
+bun add --global github:benkoppe/claude-tree
+```
+
+Run that command again to update. If the command is not found, add `$BUN_INSTALL/bin` (normally `$HOME/.bun/bin`) to `$PATH`.
+
+On musl Linux, please set `OPENTUI_LIBC=musl`.
+
+### Nix
+
+```sh
+nix run github:benkoppe/claude-tree
+```
+
+This command also installs separate Claude/Codex agents. To use your own system-installed agents, use `#unwrapped`:
+
+```sh
+nix run github:benkoppe/claude-tree#unwrapped
+```
+
+## Development
+
+The development shell includes Bun and the validated provider CLIs available for the platform:
+
+```sh
+nix develop
+bun install --frozen-lockfile
+bun run check # or nix flake check
+bun run start
+```
+
+Without Nix, install Bun and at least one supported provider CLI before running the last three commands.
+
+After changing `bun.lock`, regenerate the Nix dependency set with `nix develop -c bun2nix -o bun.nix`.

package/bin/claude-tree.cjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawn } = require("node:child_process");
+const { dirname, join } = require("node:path");
+const { name } = require("../package.json");
+
+const platform = process.platform;
+const arch = process.arch;
+if (!["linux", "darwin"].includes(platform) || !["x64", "arm64"].includes(arch)) {
+  console.error(`claude-tree: unsupported platform ${platform}/${arch}`);
+  process.exit(1);
+}
+let libc;
+if (platform === "linux") {
+  const report = process.report?.getReport();
+  libc = report?.header?.glibcVersionRuntime ? "glibc" : "musl";
+}
+const suffix = `${platform}-${arch}${libc ? `-${libc}` : ""}`;
+const platformPackage = `${name}-${suffix}`;
+let executable;
+try {
+  executable = join(dirname(require.resolve(`${platformPackage}/package.json`)), "claude-tree");
+} catch {
+  console.error(`claude-tree: missing platform package ${platformPackage}. Reinstall with optional dependencies enabled.`);
+  process.exit(1);
+}
+// Only the launcher receives foreground process-group signals; forward each once.
+const child = spawn(executable, process.argv.slice(2), { detached: true, stdio: "inherit", env: { ...process.env, ...(libc ? { OPENTUI_LIBC: libc } : {}) } });
+const handlers = new Map();
+for (const signal of ["SIGINT", "SIGTERM", "SIGHUP", "SIGQUIT"]) {
+  const handler = () => { if (child.exitCode === null && child.signalCode === null) child.kill(signal); };
+  handlers.set(signal, handler);
+  process.on(signal, handler);
+}
+child.on("error", (error) => { console.error(`claude-tree: ${error.message}`); process.exitCode = 1; });
+child.on("exit", (code, signal) => {
+  for (const [name, handler] of handlers) process.removeListener(name, handler);
+  if (signal) process.kill(process.pid, signal);
+  else process.exitCode = code ?? 1;
+});

package/package.json

@@ -1,6 +1,29 @@
 {
   "name": "@benkoppe/claude-tree",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Explore and run coding-agent conversations as a tree",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/benkoppe/claude-tree.git"
+  },
+  "homepage": "https://github.com/benkoppe/claude-tree#readme",
+  "bin": {
+    "claude-tree": "bin/claude-tree.cjs"
+  },
+  "files": [
+    "bin",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "optionalDependencies": {
+    "@benkoppe/claude-tree-linux-x64-glibc": "0.1.0",
+    "@benkoppe/claude-tree-linux-arm64-glibc": "0.1.0",
+    "@benkoppe/claude-tree-linux-x64-musl": "0.1.0",
+    "@benkoppe/claude-tree-linux-arm64-musl": "0.1.0",
+    "@benkoppe/claude-tree-darwin-arm64": "0.1.0"
+  }
+}