git-codex 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arshaan ABH
+
+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,249 @@
+# git-codex
+
+`git-codex` is a TypeScript CLI that adds a `git codex` subcommand for task-oriented Git worktrees.
+
+## Status
+
+Phase 1 scaffold is implemented:
+
+- `git codex add <task>`
+- `git codex rm <task>`
+- `git codex list`
+
+## Install
+
+Published install (after release):
+
+```bash
+pnpm add -g git-codex
+git codex --help
+```
+
+Zero-install execution:
+
+```bash
+pnpm dlx git-codex --help
+```
+
+Local development install:
+
+```bash
+pnpm install
+pnpm build
+```
+
+For local subcommand testing:
+
+```bash
+pnpm link --global
+git codex --help
+```
+
+## Commands
+
+Global flags (all commands):
+
+- `-q, --quiet` suppress non-error output
+- `--json` emit structured JSON output for CI/automation
+
+### `git codex add <task>`
+
+Creates a worktree and branch for the task.
+
+Key flags:
+
+- `--base <ref>` default `origin/main`
+- `--branch-prefix <prefix>` default `codex/`
+- `--dir <path>` default sibling directory of repo root
+- `--no-open` skip `code -n <worktree>`
+- `--no-copy-env` skip env copy
+- `--env-globs ".env,.env.*"` customize env-like patterns
+- `--env-scope <scope>` env file scan scope: `root`, `all`, or `packages`
+- `--overwrite-env` allow overwriting env-like files
+- `--template` generate `.codex/INSTRUCTIONS.md` for the new task worktree
+- `--template-file <path>` use a custom template file (supports `{{task}}`, `{{taskSlug}}`, `{{branch}}`, `{{worktreePath}}`)
+- `--template-type <type>` choose built-in template skeleton: `default`, `bugfix`, or `feature`
+- `--overwrite-template` replace an existing generated instructions file
+- `--no-fetch` skip `git fetch`
+
+### `git codex rm <task>`
+
+Removes the task worktree mapping and prunes stale entries.
+
+Key flags:
+
+- `--dir <path>` worktree parent directory override
+- `--force-delete` also delete worktree folder from disk
+
+### `git codex list`
+
+Default:
+
+- proxies `git worktree list`
+
+Optional:
+
+- `--pretty` filters by branch prefix and prints a compact table
+- `--branch-prefix <prefix>` default `codex/`
+
+In `--json` mode, `list` emits a structured `worktree.list` event with entries.
+
+### `git codex open <task>`
+
+Opens an existing task worktree.
+
+Key flags:
+
+- `--dir <path>` worktree parent directory override
+- `--branch-prefix <prefix>` override expected branch prefix
+- `--no-open` print metadata only (do not launch VS Code)
+
+In `--json` mode, `open` emits `worktree.opened`.
+
+### `git codex prompt <task> <message>`
+
+Generates a task bootstrap prompt including task/branch/worktree metadata.
+
+Key flags:
+
+- `--dir <path>` worktree parent directory override
+- `--branch-prefix <prefix>` override branch prefix
+- `--copy` copy generated prompt text to clipboard
+
+In `--json` mode, `prompt` emits `prompt.generated`.
+
+## Phase 2 Config
+
+`git-codex` supports both file-based and git-config-based settings.
+
+Supported keys:
+
+- `base`
+- `branchPrefix`
+- `dir`
+- `copyEnv`
+- `envGlobs`
+- `overwriteEnv`
+- `envScope`
+- `template`
+- `templateFile`
+- `templateType`
+- `overwriteTemplate`
+- `fetch`
+- `open` or `openVsCodeByDefault`
+
+File locations:
+
+- Repo config: `.git-codexrc.json`
+- Global config: `~/.config/git-codex/config.json`
+
+Git config keys:
+
+- `codex.base`
+- `codex.branchPrefix`
+- `codex.dir`
+- `codex.copyEnv`
+- `codex.envGlobs`
+- `codex.overwriteEnv`
+- `codex.envScope`
+- `codex.template`
+- `codex.templateFile`
+- `codex.templateType`
+- `codex.overwriteTemplate`
+- `codex.fetch`
+- `codex.open`
+
+Precedence:
+
+1. CLI flags
+2. Repo config file
+3. Repo git config
+4. Global config file
+5. Global git config
+6. Built-in defaults
+
+Example `.git-codexrc.json`:
+
+```json
+{
+  "base": "origin/main",
+  "branchPrefix": "codex/",
+  "fetch": false,
+  "copyEnv": true,
+  "envGlobs": [".env", ".env.*", ".npmrc"],
+  "envScope": "packages",
+  "template": true,
+  "templateFile": "task-template.md",
+  "templateType": "bugfix",
+  "openVsCodeByDefault": false
+}
+```
+
+## Troubleshooting
+
+### Windows locks when removing worktrees
+
+Symptom:
+
+- `git codex rm <task>` fails with directory-not-empty or lock-related errors.
+
+Common causes:
+
+- VS Code window is still open for that worktree.
+- A file watcher/dev server is still running.
+- A terminal has CWD inside the worktree path.
+- Antivirus/indexer still holds a file handle.
+
+Recovery steps:
+
+1. Close VS Code windows opened at that worktree.
+2. Stop watchers/dev servers (for example `pnpm dev`, `vite`, `webpack --watch`).
+3. Ensure no shell is `cd`'d into the target directory.
+4. Retry remove with disk cleanup enabled:
+   - `git codex rm <task> --force-delete`
+5. If needed, wait a few seconds and retry after lock release.
+
+See also:
+
+- `docs/parallel-codex-workflows.md` for end-to-end usage.
+- Phase 2 config (`README.md`) for default worktree/env options.
+
+## Development
+
+```bash
+pnpm lint
+pnpm test
+pnpm build
+```
+
+## Versioning and Releases
+
+`git-codex` uses Changesets for semantic versioning and changelog updates.
+
+Release flow:
+
+1. Create a changeset for user-facing changes:
+   - `pnpm changeset`
+2. Bump version and update `CHANGELOG.md`:
+   - `pnpm version-packages`
+3. Commit release metadata (version + changelog + changeset updates), then tag:
+   - `git tag v<version>`
+4. Pre-publish dry-run validation:
+   - `pnpm release:check`
+5. Publish:
+   - `pnpm release`
+
+Helpful checks before publish:
+
+- `pnpm lint`
+- `pnpm typecheck`
+- `pnpm test`
+- `pnpm build`
+
+## Parallel Workflow Guide
+
+See `docs/parallel-codex-workflows.md` for a full parallel task workflow from creation to cleanup, including naming, prompt generation, and cleanup hygiene.
+
+## Release Checklist
+
+See `docs/release-checklist.md` for the full semver/changelog/tag/publish procedure, including package dry-run validation.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { runAddCommand } from "./commands/add.js";
+import { runListCommand } from "./commands/list.js";
+import { runOpenCommand } from "./commands/open.js";
+import { runPromptCommand } from "./commands/prompt.js";
+import { runRmCommand } from "./commands/rm.js";
+import { parseOptionalEnvScope } from "./lib/env-scope.js";
+import { toErrorMessage } from "./lib/errors.js";
+import { createOutput } from "./lib/output.js";
+async function main() {
+    const program = new Command();
+    program
+        .name("git codex")
+        .description("Manage task worktrees for parallel Codex workflows.")
+        .option("-q, --quiet", "Suppress non-error output")
+        .option("--json", "Emit structured JSON output for automation")
+        .showHelpAfterError();
+    program
+        .command("add")
+        .description("Create a task worktree and branch.")
+        .argument("<task>", "Task label used for branch and folder names")
+        .option("--base <ref>", "Base ref for new worktree branches")
+        .option("--branch-prefix <prefix>", "Branch prefix for generated branches")
+        .option("--dir <path>", "Parent directory for worktrees (default: sibling of repo root)")
+        .option("--env-globs <patterns>", "Comma-separated env-like file globs from repo root")
+        .option("--env-scope <scope>", "Env copy scope: root, all, or packages")
+        .option("--overwrite-env", "Overwrite env-like files in existing worktree")
+        .option("--template", "Generate .codex/INSTRUCTIONS.md in the new worktree")
+        .option("--template-file <path>", "Custom template source file (supports {{task}}, {{taskSlug}}, {{branch}}, {{worktreePath}})")
+        .option("--template-type <type>", "Built-in template skeleton type: default, bugfix, or feature")
+        .option("--overwrite-template", "Overwrite existing .codex/INSTRUCTIONS.md when generating template")
+        .option("--reuse", "Reuse existing worktree path (must already be registered with expected branch)")
+        .option("--rm-first", "Remove existing target worktree path first, then recreate it")
+        .option("--no-open", "Do not open a new VS Code window")
+        .option("--no-copy-env", "Skip env-like file copy")
+        .option("--no-fetch", "Skip git fetch before worktree creation")
+        .action(async (task, opts, command) => {
+        const output = createOutput(readGlobalOutputOptions(command));
+        await runAddCommand(task, {
+            open: readExplicitOption(command, "open", Boolean(opts.open)),
+            base: readExplicitOption(command, "base", toOptionalString(opts.base)),
+            branchPrefix: readExplicitOption(command, "branchPrefix", toOptionalString(opts.branchPrefix)),
+            dir: readExplicitOption(command, "dir", toOptionalString(opts.dir)),
+            copyEnv: readExplicitOption(command, "copyEnv", Boolean(opts.copyEnv)),
+            envGlobs: readExplicitOption(command, "envGlobs", toOptionalString(opts.envGlobs)),
+            envScope: readExplicitOption(command, "envScope", parseOptionalEnvScope(toOptionalString(opts.envScope), "CLI --env-scope")),
+            overwriteEnv: readExplicitOption(command, "overwriteEnv", Boolean(opts.overwriteEnv)),
+            template: readExplicitOption(command, "template", Boolean(opts.template)),
+            templateFile: readExplicitOption(command, "templateFile", toOptionalString(opts.templateFile)),
+            templateType: readExplicitOption(command, "templateType", toOptionalString(opts.templateType)),
+            overwriteTemplate: readExplicitOption(command, "overwriteTemplate", Boolean(opts.overwriteTemplate)),
+            reuse: Boolean(opts.reuse),
+            rmFirst: Boolean(opts.rmFirst),
+            fetch: readExplicitOption(command, "fetch", Boolean(opts.fetch)),
+        }, output);
+    });
+    program
+        .command("rm")
+        .description("Remove a task worktree.")
+        .argument("<task>", "Task label")
+        .option("--dir <path>", "Parent directory for worktrees (default: sibling of repo root)")
+        .option("--force-delete", "Delete the worktree directory after removing mapping")
+        .action(async (task, opts, command) => {
+        const output = createOutput(readGlobalOutputOptions(command));
+        await runRmCommand(task, {
+            dir: readExplicitOption(command, "dir", toOptionalString(opts.dir)),
+            forceDelete: readExplicitOption(command, "forceDelete", Boolean(opts.forceDelete)),
+        }, output);
+    });
+    program
+        .command("list")
+        .description("List git worktrees.")
+        .option("--pretty", "Show a filtered table for branches using the configured prefix")
+        .option("--branch-prefix <prefix>", "Branch prefix used by --pretty filtering")
+        .action(async (opts, command) => {
+        const output = createOutput(readGlobalOutputOptions(command));
+        await runListCommand({
+            pretty: readExplicitOption(command, "pretty", Boolean(opts.pretty)),
+            branchPrefix: readExplicitOption(command, "branchPrefix", toOptionalString(opts.branchPrefix)),
+        }, output);
+    });
+    program
+        .command("open")
+        .description("Open an existing task worktree.")
+        .argument("<task>", "Task label")
+        .option("--dir <path>", "Parent directory for worktrees (default: sibling of repo root)")
+        .option("--branch-prefix <prefix>", "Branch prefix for expected branch name")
+        .option("--no-open", "Only print worktree metadata without opening VS Code")
+        .action(async (task, opts, command) => {
+        const output = createOutput(readGlobalOutputOptions(command));
+        await runOpenCommand(task, {
+            dir: readExplicitOption(command, "dir", toOptionalString(opts.dir)),
+            branchPrefix: readExplicitOption(command, "branchPrefix", toOptionalString(opts.branchPrefix)),
+            open: readExplicitOption(command, "open", Boolean(opts.open)),
+        }, output);
+    });
+    program
+        .command("prompt")
+        .description("Generate an initial prompt for a task worktree.")
+        .argument("<task>", "Task label")
+        .argument("<message>", "Prompt message")
+        .option("--dir <path>", "Parent directory for worktrees (default: sibling of repo root)")
+        .option("--branch-prefix <prefix>", "Branch prefix for generated branch name")
+        .option("--copy", "Copy generated prompt to clipboard")
+        .action(async (task, message, opts, command) => {
+        const output = createOutput(readGlobalOutputOptions(command));
+        await runPromptCommand(task, message, {
+            dir: readExplicitOption(command, "dir", toOptionalString(opts.dir)),
+            branchPrefix: readExplicitOption(command, "branchPrefix", toOptionalString(opts.branchPrefix)),
+            copy: readExplicitOption(command, "copy", Boolean(opts.copy)),
+        }, output);
+    });
+    await program.parseAsync(process.argv);
+}
+main().catch((error) => {
+    const output = createOutput({
+        json: process.argv.includes("--json"),
+        quiet: process.argv.includes("--quiet") || process.argv.includes("-q"),
+    });
+    const message = toErrorMessage(error);
+    output.error(message);
+    process.exitCode = 1;
+});
+function isExplicitOptionSource(source) {
+    return source === "cli" || source === "env";
+}
+function readExplicitOption(command, optionName, value) {
+    const source = command.getOptionValueSource(optionName);
+    return isExplicitOptionSource(source) ? value : undefined;
+}
+function toOptionalString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed || undefined;
+}
+function readGlobalOutputOptions(command) {
+    const options = command.optsWithGlobals();
+    return {
+        quiet: Boolean(options.quiet),
+        json: Boolean(options.json),
+    };
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/add.d.ts

@@ -0,0 +1,20 @@
+import { type EnvScope } from "../lib/env-scope.js";
+import { type Output } from "../lib/output.js";
+export interface AddCommandOptions {
+    open?: boolean;
+    base?: string;
+    branchPrefix?: string;
+    dir?: string;
+    copyEnv?: boolean;
+    envGlobs?: string;
+    envScope?: EnvScope;
+    overwriteEnv?: boolean;
+    template?: boolean;
+    templateFile?: string;
+    templateType?: string;
+    overwriteTemplate?: boolean;
+    reuse?: boolean;
+    rmFirst?: boolean;
+    fetch?: boolean;
+}
+export declare function runAddCommand(task: string, options: AddCommandOptions, output?: Output): Promise<void>;