@ogpoyraz/wtx 0.6.0

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@ogpoyraz/wtx",
+  "version": "0.6.0",
+  "description": "Multi-repo git worktree manager",
+  "type": "module",
+  "bin": {
+    "wtx": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist/cli.mjs",
+    "share",
+    "skills",
+    "completions"
+  ],
+  "scripts": {
+    "dev": "bun run src/index.ts --",
+    "build": "bun build src/index.ts --compile --outfile dist/wtx",
+    "build:npm": "bun build src/index.ts --target=node --external @opentui/core --external @opentui/react --external react --external react-reconciler --outfile dist/cli.mjs",
+    "prepublishOnly": "bun run build:npm",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "git",
+    "worktree",
+    "monorepo",
+    "multi-repo",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OGPoyraz/wtx.git"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^26.2.0",
+    "@types/react": "^19.2.18",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "dependencies": {
+    "@opentui/core": "^0.5.6",
+    "@opentui/react": "^0.5.6",
+    "chalk": "^6.0.0",
+    "commander": "^15.0.0",
+    "execa": "^10.0.1",
+    "react": "^19.2.8",
+    "zod": "^4.4.3"
+  },
+  "license": "MIT"
+}

package/share/wtx.sh

@@ -0,0 +1,16 @@
+# Usage: eval "$(wtx init zsh)" or source this file
+
+wtx() {
+  if [ "$1" = "cd" ]; then
+    if [ $# -lt 2 ]; then
+      command wtx cd
+      return $?
+    fi
+    shift
+    local _wtx_path
+    _wtx_path=$(command wtx _resolve-path "$@") || return $?
+    builtin cd "$_wtx_path" || return $?
+  else
+    command wtx "$@"
+  fi
+}

package/skills/claude.md

@@ -0,0 +1,134 @@
+# wtx — Worktree Manager
+
+`wtx` is a multi-repo git worktree manager. It allows you to create, manage, and sync git worktrees across multiple repositories concurrently.
+
+## Commands
+
+By default, if you are inside a repository's directory (either the main checkout or a worktree), `wtx` automatically scopes commands to that repository. If you are outside, it will run the command across **all** repositories defined in the config, unless you restrict it using the `--repo` flag.
+
+### `wtx create <branch>`
+Creates a new worktree for the specified branch.
+- **Flags**:
+  - `-r, --repo <repos...>`: Target specific repo(s) (comma-separated or multiple flags).
+  - `--base <ref>`: Base ref to create branch from (defaults to tracking remote branch, or creating from `origin/main`).
+  - `-o, --open`: Open worktree(s) in IDE after creation.
+  - `--ide <editor>`: IDE to open with (used with `--open`).
+  - `--track`: Track the remote branch even if ownership detection says it belongs to someone else.
+- **Hooks & Sync**: Automatically copies files specified in `sync_files` from the main checkout, and runs `post_create` hooks.
+
+### `wtx remove <branch>`
+Removes a worktree and deletes the branch.
+- **Flags**: `-r, --repo <repos...>`
+
+### `wtx ls`
+Lists all worktrees across repositories. Owned-by-someone-else branches show a dim `@handle` suffix.
+
+### `wtx prs`
+Shows pull request status for worktree branches across repositories. Requires the GitHub CLI (`gh`) to be installed and authenticated. Read-only — never modifies PRs.
+- **Flags**:
+  - `-r, --repo <repos...>`: Target specific repo(s).
+  - `--json`: Machine-readable JSON output with an `author` field.
+  - `--all`: Include drafts and closed/merged PRs.
+
+`wtx ls --pr` adds a PR column to the worktree listing, `wtx prs` shows the same dim owner tag per row and a mixed-ownership summary, and `wtx status <branch>` shows a PR section (state, checks, unresolved threads, URL, owner line for foreign branches). Worktrees with local modifications count as yours. Use `wtx config set user <handle>` to enable ownership tags.
+
+`wtx prune [--force]` removes worktrees whose branch has a merged PR. Dirty or locked worktrees are skipped without `--force`; repos with failed PR lookups are left untouched.
+
+### `wtx pull <pr-link>`
+Fetches a GitHub PR by URL and creates its worktree. Requires the GitHub CLI (`gh`) to be installed and authenticated.
+- **Flags**: `-r, --repo <repo>`
+- Auto-detects the owning repo from the PR link, warns on merged or closed PRs, and skips existing branches or worktrees with a warning.
+- Supports fork PRs without adding persistent remotes.
+
+### `wtx terminal`
+Opens an interactive full-screen dashboard for browsing and acting on worktrees across all configured repos. Requires Bun runtime and a TTY; exits with guidance under Node.js or non-interactive shells.
+
+- Lists worktrees as two-line entries: branch with status badge (clean / dirty count / locked / missing / rebasing), then commit hash, divergence vs main (`↑n ↓n`), PR number/state/checks, and owner tags.
+- Keys: `r` refresh · `j/k` navigate · `n` create · `b` rebase · `d` remove · `s` sync · `o` open in IDE · `c` edit config · `?` help · `q` quit.
+- Actions run as child processes with output streamed inside the dashboard; destructive actions confirm first (`y/n`). The config editor (`c`) persists through atomic config writes and refreshes the view automatically.
+
+### `wtx status`
+Shows git statuses for all worktrees.
+
+### `wtx rebase <branch>`
+Fetches the main branch from origin and rebases the given worktree's branch onto it.
+- **Flags**: `-r, --repo <repos...>`
+
+### `wtx sync <branch>`
+Re-copies `sync_files` from the main checkout to the worktree and runs `post_sync` hooks. Also checks for package lockfile differences if `node_modules` is symlinked.
+- **Flags**: `-r, --repo <repos...>`
+
+### `wtx deps [branch]`
+Manages the `node_modules` strategy for a worktree. By default, `wtx deps <branch>` shows the current strategy (independent or symlinked) and lockfile status.
+- **Flags**:
+  - `--install`: Switch to independent `node_modules` and run install (e.g. `npm install`).
+  - `--symlink`: Switch to symlinked `node_modules` (points to the main checkout's `node_modules`).
+
+### `wtx open <branch>`
+Opens the worktree in your configured IDE.
+- **Flags**: `--ide <editor>` (defaults to config or `$EDITOR`), `-r, --repo <repos...>`
+
+### `wtx cd <repo> <branch>`
+If shell integration is enabled via `wtx init`, this changes the current directory to the worktree path.
+
+## Configuration
+
+Located at `~/.config/wtx/config.json`:
+
+```json
+{
+  "version": 1,
+  "root": "~/Repos",
+  "postfix": "-wt",
+  "ide": "cursor",
+  "default_main_branch": "main",
+  "user": null,
+  "repos": {
+    "my-frontend": {
+      "main_branch": "auto",
+      "sync_files": [".env", ".env.local"],
+      "post_create": ["npm install", "npm run build"]
+    },
+    "my-backend": {
+      "main_branch": "master",
+      "post_sync": ["docker-compose restart"]
+    }
+  }
+}
+```
+
+### Template Variables
+Hooks (`post_create` and `post_sync`) support the following template variables:
+- `{root}`: Base directory (`~/Repos`)
+- `{repo}`: Repository name
+- `{branch}`: Branch name
+- `{main}`: Absolute path to the main checkout
+- `{wt}`: Absolute path to the worktree
+- `{postfix}`: Worktree directory postfix
+
+## Typical Workflows
+
+1. **Creating a feature across repos**:
+   ```bash
+   wtx create feature-xyz
+   ```
+   *Creates a `feature-xyz` worktree in every configured repo, syncs `.env` files, and runs post-create hooks.*
+
+2. **Rebasing daily**:
+   ```bash
+   wtx rebase feature-xyz
+   ```
+   *Fetches the latest main branch from origin and rebases the `feature-xyz` worktrees.*
+
+3. **Syncing environment variables**:
+   If the `.env` file in the main checkout was updated, run:
+   ```bash
+   wtx sync feature-xyz
+   ```
+
+4. **Managing node_modules dependencies**:
+   If a worktree requires different dependencies than the main branch (e.g. you're testing an upgrade):
+   ```bash
+   wtx deps feature-xyz --install
+   ```
+   *This removes the symlink to the main repo's `node_modules` and does a fresh install isolated to the worktree.*

package/skills/cursor.md

@@ -0,0 +1,134 @@
+# wtx — Worktree Manager
+
+`wtx` is a multi-repo git worktree manager. It allows you to create, manage, and sync git worktrees across multiple repositories concurrently.
+
+## Commands
+
+By default, if you are inside a repository's directory (either the main checkout or a worktree), `wtx` automatically scopes commands to that repository. If you are outside, it will run the command across **all** repositories defined in the config, unless you restrict it using the `--repo` flag.
+
+### `wtx create <branch>`
+Creates a new worktree for the specified branch.
+- **Flags**:
+  - `-r, --repo <repos...>`: Target specific repo(s) (comma-separated or multiple flags).
+  - `--base <ref>`: Base ref to create branch from (defaults to tracking remote branch, or creating from `origin/main`).
+  - `-o, --open`: Open worktree(s) in IDE after creation.
+  - `--ide <editor>`: IDE to open with (used with `--open`).
+  - `--track`: Track the remote branch even if ownership detection says it belongs to someone else.
+- **Hooks & Sync**: Automatically copies files specified in `sync_files` from the main checkout, and runs `post_create` hooks.
+
+### `wtx remove <branch>`
+Removes a worktree and deletes the branch.
+- **Flags**: `-r, --repo <repos...>`
+
+### `wtx ls`
+Lists all worktrees across repositories. Owned-by-someone-else branches show a dim `@handle` suffix.
+
+### `wtx prs`
+Shows pull request status for worktree branches across repositories. Requires the GitHub CLI (`gh`) to be installed and authenticated. Read-only — never modifies PRs.
+- **Flags**:
+  - `-r, --repo <repos...>`: Target specific repo(s).
+  - `--json`: Machine-readable JSON output with an `author` field.
+  - `--all`: Include drafts and closed/merged PRs.
+
+`wtx ls --pr` adds a PR column to the worktree listing, `wtx prs` shows the same dim owner tag per row and a mixed-ownership summary, and `wtx status <branch>` shows a PR section (state, checks, unresolved threads, URL, owner line for foreign branches). Worktrees with local modifications count as yours. Use `wtx config set user <handle>` to enable ownership tags.
+
+`wtx prune [--force]` removes worktrees whose branch has a merged PR. Dirty or locked worktrees are skipped without `--force`; repos with failed PR lookups are left untouched.
+
+### `wtx pull <pr-link>`
+Fetches a GitHub PR by URL and creates its worktree. Requires the GitHub CLI (`gh`) to be installed and authenticated.
+- **Flags**: `-r, --repo <repo>`
+- Auto-detects the owning repo from the PR link, warns on merged or closed PRs, and skips existing branches or worktrees with a warning.
+- Supports fork PRs without adding persistent remotes.
+
+### `wtx terminal`
+Opens an interactive full-screen dashboard for browsing and acting on worktrees across all configured repos. Requires Bun runtime and a TTY; exits with guidance under Node.js or non-interactive shells.
+
+- Lists worktrees as two-line entries: branch with status badge (clean / dirty count / locked / missing / rebasing), then commit hash, divergence vs main (`↑n ↓n`), PR number/state/checks, and owner tags.
+- Keys: `r` refresh · `j/k` navigate · `n` create · `b` rebase · `d` remove · `s` sync · `o` open in IDE · `c` edit config · `?` help · `q` quit.
+- Actions run as child processes with output streamed inside the dashboard; destructive actions confirm first (`y/n`). The config editor (`c`) persists through atomic config writes and refreshes the view automatically.
+
+### `wtx status`
+Shows git statuses for all worktrees.
+
+### `wtx rebase <branch>`
+Fetches the main branch from origin and rebases the given worktree's branch onto it.
+- **Flags**: `-r, --repo <repos...>`
+
+### `wtx sync <branch>`
+Re-copies `sync_files` from the main checkout to the worktree and runs `post_sync` hooks. Also checks for package lockfile differences if `node_modules` is symlinked.
+- **Flags**: `-r, --repo <repos...>`
+
+### `wtx deps [branch]`
+Manages the `node_modules` strategy for a worktree. By default, `wtx deps <branch>` shows the current strategy (independent or symlinked) and lockfile status.
+- **Flags**:
+  - `--install`: Switch to independent `node_modules` and run install (e.g. `npm install`).
+  - `--symlink`: Switch to symlinked `node_modules` (points to the main checkout's `node_modules`).
+
+### `wtx open <branch>`
+Opens the worktree in your configured IDE.
+- **Flags**: `--ide <editor>` (defaults to config or `$EDITOR`), `-r, --repo <repos...>`
+
+### `wtx cd <repo> <branch>`
+If shell integration is enabled via `wtx init`, this changes the current directory to the worktree path.
+
+## Configuration
+
+Located at `~/.config/wtx/config.json`:
+
+```json
+{
+  "version": 1,
+  "root": "~/Repos",
+  "postfix": "-wt",
+  "ide": "cursor",
+  "default_main_branch": "main",
+  "user": null,
+  "repos": {
+    "my-frontend": {
+      "main_branch": "auto",
+      "sync_files": [".env", ".env.local"],
+      "post_create": ["npm install", "npm run build"]
+    },
+    "my-backend": {
+      "main_branch": "master",
+      "post_sync": ["docker-compose restart"]
+    }
+  }
+}
+```
+
+### Template Variables
+Hooks (`post_create` and `post_sync`) support the following template variables:
+- `{root}`: Base directory (`~/Repos`)
+- `{repo}`: Repository name
+- `{branch}`: Branch name
+- `{main}`: Absolute path to the main checkout
+- `{wt}`: Absolute path to the worktree
+- `{postfix}`: Worktree directory postfix
+
+## Typical Workflows
+
+1. **Creating a feature across repos**:
+   ```bash
+   wtx create feature-xyz
+   ```
+   *Creates a `feature-xyz` worktree in every configured repo, syncs `.env` files, and runs post-create hooks.*
+
+2. **Rebasing daily**:
+   ```bash
+   wtx rebase feature-xyz
+   ```
+   *Fetches the latest main branch from origin and rebases the `feature-xyz` worktrees.*
+
+3. **Syncing environment variables**:
+   If the `.env` file in the main checkout was updated, run:
+   ```bash
+   wtx sync feature-xyz
+   ```
+
+4. **Managing node_modules dependencies**:
+   If a worktree requires different dependencies than the main branch (e.g. you're testing an upgrade):
+   ```bash
+   wtx deps feature-xyz --install
+   ```
+   *This removes the symlink to the main repo's `node_modules` and does a fresh install isolated to the worktree.*

package/skills/opencode.md

@@ -0,0 +1,138 @@
+---
+description: Manage git worktrees across multiple repos using wtx CLI. Trigger phrases: "create worktree", "remove worktree", "rebase worktree", "list worktrees", "open worktree", "fetch main".
+---
+
+# wtx — Worktree Manager
+
+`wtx` is a multi-repo git worktree manager. It allows you to create, manage, and sync git worktrees across multiple repositories concurrently.
+
+## Commands
+
+By default, if you are inside a repository's directory (either the main checkout or a worktree), `wtx` automatically scopes commands to that repository. If you are outside, it will run the command across **all** repositories defined in the config, unless you restrict it using the `--repo` flag.
+
+### `wtx create <branch>`
+Creates a new worktree for the specified branch.
+- **Flags**:
+  - `-r, --repo <repos...>`: Target specific repo(s) (comma-separated or multiple flags).
+  - `--base <ref>`: Base ref to create branch from (defaults to tracking remote branch, or creating from `origin/main`).
+  - `-o, --open`: Open worktree(s) in IDE after creation.
+  - `--ide <editor>`: IDE to open with (used with `--open`).
+  - `--track`: Track the remote branch even if ownership detection says it belongs to someone else.
+- **Hooks & Sync**: Automatically copies files specified in `sync_files` from the main checkout, and runs `post_create` hooks.
+
+### `wtx remove <branch>`
+Removes a worktree and deletes the branch.
+- **Flags**: `-r, --repo <repos...>`
+
+### `wtx ls`
+Lists all worktrees across repositories. Owned-by-someone-else branches show a dim `@handle` suffix.
+
+### `wtx prs`
+Shows pull request status for worktree branches across repositories. Requires the GitHub CLI (`gh`) to be installed and authenticated. Read-only — never modifies PRs.
+- **Flags**:
+  - `-r, --repo <repos...>`: Target specific repo(s).
+  - `--json`: Machine-readable JSON output with an `author` field.
+  - `--all`: Include drafts and closed/merged PRs.
+
+`wtx ls --pr` adds a PR column to the worktree listing, `wtx prs` shows the same dim owner tag per row and a mixed-ownership summary, and `wtx status <branch>` shows a PR section (state, checks, unresolved threads, URL, owner line for foreign branches). Worktrees with local modifications count as yours. Use `wtx config set user <handle>` to enable ownership tags.
+
+`wtx prune [--force]` removes worktrees whose branch has a merged PR. Dirty or locked worktrees are skipped without `--force`; repos with failed PR lookups are left untouched.
+
+### `wtx pull <pr-link>`
+Fetches a GitHub PR by URL and creates its worktree. Requires the GitHub CLI (`gh`) to be installed and authenticated.
+- **Flags**: `-r, --repo <repo>`
+- Auto-detects the owning repo from the PR link, warns on merged or closed PRs, and skips existing branches or worktrees with a warning.
+- Supports fork PRs without adding persistent remotes.
+
+### `wtx terminal`
+Opens an interactive full-screen dashboard for browsing and acting on worktrees across all configured repos. Requires Bun runtime and a TTY; exits with guidance under Node.js or non-interactive shells.
+
+- Lists worktrees as two-line entries: branch with status badge (clean / dirty count / locked / missing / rebasing), then commit hash, divergence vs main (`↑n ↓n`), PR number/state/checks, and owner tags.
+- Keys: `r` refresh · `j/k` navigate · `n` create · `b` rebase · `d` remove · `s` sync · `o` open in IDE · `c` edit config · `?` help · `q` quit.
+- Actions run as child processes with output streamed inside the dashboard; destructive actions confirm first (`y/n`). The config editor (`c`) persists through atomic config writes and refreshes the view automatically.
+
+### `wtx status`
+Shows git statuses for all worktrees.
+
+### `wtx rebase <branch>`
+Fetches the main branch from origin and rebases the given worktree's branch onto it.
+- **Flags**: `-r, --repo <repos...>`
+
+### `wtx sync <branch>`
+Re-copies `sync_files` from the main checkout to the worktree and runs `post_sync` hooks. Also checks for package lockfile differences if `node_modules` is symlinked.
+- **Flags**: `-r, --repo <repos...>`
+
+### `wtx deps [branch]`
+Manages the `node_modules` strategy for a worktree. By default, `wtx deps <branch>` shows the current strategy (independent or symlinked) and lockfile status.
+- **Flags**:
+  - `--install`: Switch to independent `node_modules` and run install (e.g. `npm install`).
+  - `--symlink`: Switch to symlinked `node_modules` (points to the main checkout's `node_modules`).
+
+### `wtx open <branch>`
+Opens the worktree in your configured IDE.
+- **Flags**: `--ide <editor>` (defaults to config or `$EDITOR`), `-r, --repo <repos...>`
+
+### `wtx cd <repo> <branch>`
+If shell integration is enabled via `wtx init`, this changes the current directory to the worktree path.
+
+## Configuration
+
+Located at `~/.config/wtx/config.json`:
+
+```json
+{
+  "version": 1,
+  "root": "~/Repos",
+  "postfix": "-wt",
+  "ide": "cursor",
+  "default_main_branch": "main",
+  "user": null,
+  "repos": {
+    "my-frontend": {
+      "main_branch": "auto",
+      "sync_files": [".env", ".env.local"],
+      "post_create": ["npm install", "npm run build"]
+    },
+    "my-backend": {
+      "main_branch": "master",
+      "post_sync": ["docker-compose restart"]
+    }
+  }
+}
+```
+
+### Template Variables
+Hooks (`post_create` and `post_sync`) support the following template variables:
+- `{root}`: Base directory (`~/Repos`)
+- `{repo}`: Repository name
+- `{branch}`: Branch name
+- `{main}`: Absolute path to the main checkout
+- `{wt}`: Absolute path to the worktree
+- `{postfix}`: Worktree directory postfix
+
+## Typical Workflows
+
+1. **Creating a feature across repos**:
+   ```bash
+   wtx create feature-xyz
+   ```
+   *Creates a `feature-xyz` worktree in every configured repo, syncs `.env` files, and runs post-create hooks.*
+
+2. **Rebasing daily**:
+   ```bash
+   wtx rebase feature-xyz
+   ```
+   *Fetches the latest main branch from origin and rebases the `feature-xyz` worktrees.*
+
+3. **Syncing environment variables**:
+   If the `.env` file in the main checkout was updated, run:
+   ```bash
+   wtx sync feature-xyz
+   ```
+
+4. **Managing node_modules dependencies**:
+   If a worktree requires different dependencies than the main branch (e.g. you're testing an upgrade):
+   ```bash
+   wtx deps feature-xyz --install
+   ```
+   *This removes the symlink to the main repo's `node_modules` and does a fresh install isolated to the worktree.*