@ferueda/grove-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 grove contributors
+
+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,7 @@
+# Grove CLI
+
+> A fast, secure pool of reusable git worktrees
+
+This is the CLI package for Grove.
+
+Please see the [main documentation](https://github.com/ferueda/grove#readme) for full usage and installation instructions!

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,22 @@
+import { Command } from "commander";
+import { acquireCmd } from "./commands/acquire.js";
+import { releaseCmd } from "./commands/release.js";
+import { statusCmd } from "./commands/status.js";
+import { destroyCmd, destroyAllCmd } from "./commands/destroy.js";
+const program = new Command();
+program
+    .name("grove")
+    .description("CLI for Grove - A programmatic git worktree pool manager")
+    .version("0.1.0");
+program.addCommand(acquireCmd);
+program.addCommand(releaseCmd);
+program.addCommand(statusCmd);
+program.addCommand(destroyCmd);
+program.addCommand(destroyAllCmd);
+try {
+    await program.parseAsync(process.argv);
+}
+catch (err) {
+    console.error(`Error: ${err.message}`);
+    process.exit(1);
+}

package/dist/commands/acquire.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const acquireCmd: Command;
+//# sourceMappingURL=acquire.d.ts.map

package/dist/commands/acquire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquire.d.ts","sourceRoot":"","sources":["../../src/commands/acquire.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,UAAU,SA4CnB,CAAC"}

package/dist/commands/acquire.js

@@ -0,0 +1,47 @@
+import { Command } from "commander";
+import { loadGrove } from "../utils.js";
+import { spawn } from "node:child_process";
+import pc from "picocolors";
+export const acquireCmd = new Command("acquire")
+    .description("Acquire a worktree from the pool")
+    .option("--shell", "Drop into an interactive subshell inside the worktree")
+    .option("-r, --repo <path>", "Path to repository root")
+    .action(async (options) => {
+    try {
+        const grove = await loadGrove({ repo: options.repo });
+        const slot = await grove.acquire();
+        if (options.shell) {
+            console.error(pc.green(`🌳 Entered worktree at ${slot.path}. Type 'exit' to return.`));
+            const shell = process.env.SHELL || "/bin/sh";
+            const env = { ...process.env, GROVE_DIR: slot.path };
+            const sigHandler = () => { };
+            process.on("SIGINT", sigHandler);
+            process.on("SIGTERM", sigHandler);
+            const child = spawn(shell, [], {
+                stdio: "inherit",
+                env,
+                cwd: slot.path,
+            });
+            child.on("exit", async (code) => {
+                process.off("SIGINT", sigHandler);
+                process.off("SIGTERM", sigHandler);
+                try {
+                    await grove.release(slot.path);
+                    console.error(pc.green("🌳 Worktree returned to pool."));
+                }
+                catch (err) {
+                    console.error(pc.red(`🌳 Warning: failed to release worktree: ${err.message}`));
+                }
+                process.exit(code ?? 0);
+            });
+        }
+        else {
+            // Output raw path to stdout for pipeability
+            process.stdout.write(slot.path + "\n");
+        }
+    }
+    catch (err) {
+        console.error(pc.red(err.message));
+        process.exit(1);
+    }
+});

package/dist/commands/destroy.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+export declare const destroyCmd: Command;
+export declare const destroyAllCmd: Command;
+//# sourceMappingURL=destroy.d.ts.map

package/dist/commands/destroy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destroy.d.ts","sourceRoot":"","sources":["../../src/commands/destroy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,UAAU,SAcnB,CAAC;AAEL,eAAO,MAAM,aAAa,SAatB,CAAC"}

package/dist/commands/destroy.js

@@ -0,0 +1,34 @@
+import { Command } from "commander";
+import { loadGrove } from "../utils.js";
+import pc from "picocolors";
+export const destroyCmd = new Command("destroy")
+    .description("Destroy a specific worktree from the pool")
+    .argument("<path>", "Path to the worktree to destroy")
+    .option("-f, --force", "Force destroy even if in use")
+    .option("-r, --repo <path>", "Path to repository root")
+    .action(async (worktreePath, options) => {
+    try {
+        const grove = await loadGrove({ repo: options.repo });
+        await grove.destroy(worktreePath, { force: options.force });
+        console.error(pc.green(`🌳 Destroyed worktree at ${worktreePath}`));
+    }
+    catch (err) {
+        console.error(pc.red(err.message));
+        process.exit(1);
+    }
+});
+export const destroyAllCmd = new Command("destroy-all")
+    .description("Destroy all worktrees in the pool")
+    .option("-f, --force", "Force destroy even if in use")
+    .option("-r, --repo <path>", "Path to repository root")
+    .action(async (options) => {
+    try {
+        const grove = await loadGrove({ repo: options.repo });
+        await grove.destroyAll({ force: options.force });
+        console.error(pc.green("🌳 Destroyed all worktrees in the pool."));
+    }
+    catch (err) {
+        console.error(pc.red(err.message));
+        process.exit(1);
+    }
+});

package/dist/commands/release.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const releaseCmd: Command;
+//# sourceMappingURL=release.d.ts.map

package/dist/commands/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../src/commands/release.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,UAAU,SAenB,CAAC"}

package/dist/commands/release.js

@@ -0,0 +1,19 @@
+import { Command } from "commander";
+import { loadGrove } from "../utils.js";
+import pc from "picocolors";
+export const releaseCmd = new Command("release")
+    .description("Release a worktree back to the pool")
+    .argument("[path]", "Path to the worktree to release (defaults to CWD)")
+    .option("-r, --repo <path>", "Path to repository root")
+    .action(async (worktreePath, options) => {
+    try {
+        const targetPath = worktreePath || process.cwd();
+        const grove = await loadGrove({ repo: options.repo });
+        await grove.release(targetPath);
+        console.error(pc.green("🌳 Worktree returned to pool."));
+    }
+    catch (err) {
+        console.error(pc.red(err.message));
+        process.exit(1);
+    }
+});

package/dist/commands/status.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const statusCmd: Command;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,SAAS,SAgDlB,CAAC"}

package/dist/commands/status.js

@@ -0,0 +1,47 @@
+import { Command } from "commander";
+import { loadGrove } from "../utils.js";
+import pc from "picocolors";
+export const statusCmd = new Command("status")
+    .description("Show the status of all worktrees in the pool")
+    .option("-r, --repo <path>", "Path to repository root")
+    .action(async (options) => {
+    try {
+        const grove = await loadGrove({ repo: options.repo });
+        const trees = await grove.list();
+        if (trees.length === 0) {
+            console.log("🌳 No worktrees in pool.");
+            return;
+        }
+        console.log(pc.bold("ID\tStatus\t\tPath"));
+        console.log("----------------------------------------");
+        for (const wt of trees) {
+            let statusStr = "";
+            switch (wt.status) {
+                case "available":
+                    statusStr = pc.green(wt.status);
+                    break;
+                case "in-use":
+                    statusStr = pc.red(wt.status);
+                    break;
+                case "dirty":
+                    statusStr = pc.yellow(wt.status);
+                    break;
+                case "you're here":
+                    statusStr = pc.cyan(wt.status);
+                    break;
+            }
+            const coloredPadded = statusStr + " ".repeat(12 - wt.status.length);
+            console.log(`${wt.name}\t${coloredPadded}\t${wt.path}`);
+            if (wt.processes.length > 0) {
+                console.log(pc.gray(`  └─ Processes:`));
+                for (const p of wt.processes) {
+                    console.log(pc.gray(`     - PID: ${p.PID} ${p.Name ? `(${p.Name})` : ""}`));
+                }
+            }
+        }
+    }
+    catch (err) {
+        console.error(pc.red(err.message));
+        process.exit(1);
+    }
+});

package/dist/utils.d.ts

@@ -0,0 +1,7 @@
+import type { Grove } from "@ferueda/grove";
+export declare function findRepoRoot(cwd?: string): Promise<string>;
+export declare function loadGrove(options: {
+    repo?: string;
+    dir?: string;
+}): Promise<Grove>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,wBAAsB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAO/E;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAOxF"}

package/dist/utils.js

@@ -0,0 +1,19 @@
+import { execa } from "execa";
+import { createGrove } from "@ferueda/grove";
+export async function findRepoRoot(cwd = process.cwd()) {
+    try {
+        const { stdout } = await execa("git", ["rev-parse", "--show-toplevel"], { cwd });
+        return stdout.trim();
+    }
+    catch {
+        throw new Error(`Directory ${cwd} is not inside a git repository`);
+    }
+}
+export async function loadGrove(options) {
+    let repoRoot = options.repo || process.env.GROVE_REPO_ROOT;
+    if (!repoRoot) {
+        repoRoot = await findRepoRoot();
+    }
+    const groveDir = options.dir || process.env.GROVE_DIR;
+    return createGrove({ repoRoot, groveDir });
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@ferueda/grove-cli",
+  "version": "0.1.0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "bin": {
+    "grove": "./dist/cli.js"
+  },
+  "dependencies": {
+    "commander": "^13.0.0",
+    "execa": "^9.6.0",
+    "picocolors": "^1.1.0",
+    "@ferueda/grove": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsgo -p tsconfig.json"
+  }
+}