arbors 0.1.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,7 @@
+{
+  "name": "arbors",
+  "description": "Git worktree manager — create, switch, and remove worktrees with auto dependency install, exclude file copying, and interactive fuzzy search TUI. Use this plugin when working with git worktrees or managing parallel development branches.",
+  "author": {
+    "name": "sonsu"
+  }
+}

package/.oxlintrc.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "rules": {
+    "eslint/no-unused-vars": "warn",
+    "eslint/no-console": "off",
+    "eslint/eqeqeq": "error"
+  },
+  "ignorePatterns": ["dist", "node_modules"]
+}

package/README.ja.md

@@ -0,0 +1,131 @@
+# arbors
+
+[한국어](./README.ko.md) | [English](./README.md)
+
+git worktreeを簡単に扱うためのCLIツール。
+
+ブランチごとに別ディレクトリを作成し、**stash/switchなしで**複数ブランチを同時に作業できる。worktree作成時にexcludeファイルのコピーと依存関係のインストールを自動で行う。
+
+## Install
+
+```sh
+git clone git@github.com:sungsulee/arbors.git
+cd arbors
+pnpm install && pnpm build
+npm link
+```
+
+Shell integration（worktree切り替え後の自動`cd`）：
+
+```sh
+# ~/.zshrc
+source /path/to/arbors/shell/arbors-wrapper.zsh
+
+# ~/.bashrc
+source /path/to/arbors/shell/arbors-wrapper.sh
+```
+
+## Workflows
+
+### 新機能開発
+
+```sh
+# mainを基準に新しいブランチ + worktreeを作成
+arbors add -c feature/login --base main
+
+# 自動で以下を実行:
+#   1. git fetch origin main
+#   2. ~/arbors/{repo}/feature-login にworktreeを作成
+#   3. .git/info/excludeに記載されたファイルをコピー（.envなど）
+#   4. pnpm install（lockfileから自動検出）
+
+cd ~/arbors/my-project/feature-login
+# 作業開始
+```
+
+作業が終わったら：
+
+```sh
+arbors remove feature/login
+# コミットされていない変更がある場合は削除を拒否する
+```
+
+### 同僚のPRコードレビュー
+
+リモートブランチをローカルworktreeとしてチェックアウト：
+
+```sh
+# originから自動でfetch + worktree作成
+arbors add feature/payment
+
+# ローカルに既にあるブランチならworktreeのみ作成
+# → ローカル優先、なければoriginから取得
+```
+
+レビューが終わったら：
+
+```sh
+arbors remove feature/payment
+```
+
+### 複数ブランチの同時作業
+
+```sh
+arbors add -c feature/auth --base main
+arbors add -c fix/header-bug --base main
+
+arbors list
+# feature/auth    ~/arbors/my-project/feature-auth
+# fix/header-bug  ~/arbors/my-project/fix-header-bug
+
+# 各ディレクトリで独立して作業。stash不要。
+```
+
+## Commands
+
+```
+arbors add <branch>                     既存ブランチをチェックアウト（ローカル → リモート自動）
+arbors add -c <branch> [--base <branch>]  新しいブランチ + worktree作成
+arbors remove <branch>                  worktree削除（安全チェック付き）
+arbors list [--plain]                   管理中のworktree一覧
+arbors excluded                         excludeパターン確認
+arbors config                           現在の設定確認
+```
+
+## Configuration
+
+`~/.arbors/config.json`（グローバル）または `.arbors/config.json`（プロジェクト別、優先）：
+
+```json
+{
+  "runtime": "node",
+  "language": "ja",
+  "packageManager": "auto",
+  "copyExcludes": true,
+  "copySkip": ["node_modules"],
+  "worktreeDir": "~/arbors/{repo}"
+}
+```
+
+| Key              | Values                                | Default             |
+| ---------------- | ------------------------------------- | ------------------- |
+| `runtime`        | `"node"`, `"bun"`                     | `"node"`            |
+| `language`       | `"en"`, `"ko"`, `"ja"`               | `"en"`              |
+| `packageManager` | `"auto"`, `"pnpm"`, `"yarn"`, `"npm"` | `"auto"`            |
+| `copyExcludes`   | `true`, `false`                       | `true`              |
+| `copySkip`       | `string[]`                            | `["node_modules"]`  |
+| `worktreeDir`    | string (`{repo}` placeholder)         | `"~/arbors/{repo}"` |
+
+## Development
+
+```sh
+pnpm test       # vitest
+pnpm lint       # oxlint
+pnpm format     # oxfmt
+pnpm build      # tsup
+pnpm typecheck  # tsc --noEmit
+```
+
+## License
+
+MIT

package/README.ko.md

@@ -0,0 +1,131 @@
+# arbors
+
+[English](./README.md) | [日本語](./README.ja.md)
+
+git worktree를 편하게 쓰기 위한 CLI 도구.
+
+브랜치마다 별도의 디렉토리를 만들어서, **stash/switch 없이** 여러 브랜치를 동시에 작업할 수 있다. worktree 생성 시 exclude 파일 복사, 의존성 설치까지 자동으로 처리한다.
+
+## Install
+
+```sh
+git clone git@github.com:sungsulee/arbors.git
+cd arbors
+pnpm install && pnpm build
+npm link
+```
+
+Shell integration (worktree 전환 후 자동 `cd`):
+
+```sh
+# ~/.zshrc
+source /path/to/arbors/shell/arbors-wrapper.zsh
+
+# ~/.bashrc
+source /path/to/arbors/shell/arbors-wrapper.sh
+```
+
+## Workflows
+
+### 새 기능 개발
+
+```sh
+# main 기준으로 새 브랜치 + worktree 생성
+arbors add -c feature/login --base main
+
+# 자동으로 다음을 수행:
+#   1. git fetch origin main
+#   2. ~/arbors/{repo}/feature-login 에 worktree 생성
+#   3. .git/info/exclude에 있는 파일들 복사 (.env 등)
+#   4. pnpm install (lockfile 기준 자동 감지)
+
+cd ~/arbors/my-project/feature-login
+# 작업 시작
+```
+
+작업이 끝나면:
+
+```sh
+arbors remove feature/login
+# 커밋되지 않은 변경사항이 있으면 삭제를 거부한다
+```
+
+### 동료의 PR 코드리뷰
+
+원격 브랜치를 로컬 worktree로 바로 체크아웃:
+
+```sh
+# origin에 있는 브랜치를 자동으로 fetch + worktree 생성
+arbors add feature/payment
+
+# 이미 로컬에 있는 브랜치라면 그대로 worktree만 생성
+# → 로컬 우선, 없으면 origin에서 가져옴
+```
+
+리뷰가 끝나면:
+
+```sh
+arbors remove feature/payment
+```
+
+### 동시에 여러 브랜치 작업
+
+```sh
+arbors add -c feature/auth --base main
+arbors add -c fix/header-bug --base main
+
+arbors list
+# feature/auth    ~/arbors/my-project/feature-auth
+# fix/header-bug  ~/arbors/my-project/fix-header-bug
+
+# 각 디렉토리에서 독립적으로 작업. stash 불필요.
+```
+
+## Commands
+
+```
+arbors add <branch>                     기존 브랜치 체크아웃 (로컬 → 원격 자동)
+arbors add -c <branch> [--base <branch>]  새 브랜치 + worktree 생성
+arbors remove <branch>                  worktree 삭제 (안전 검사 포함)
+arbors list [--plain]                   관리 중인 worktree 목록
+arbors excluded                         exclude 패턴 확인
+arbors config                           현재 설정 확인
+```
+
+## Configuration
+
+`~/.arbors/config.json` (글로벌) 또는 `.arbors/config.json` (프로젝트별 우선):
+
+```json
+{
+  "runtime": "node",
+  "language": "ko",
+  "packageManager": "auto",
+  "copyExcludes": true,
+  "copySkip": ["node_modules"],
+  "worktreeDir": "~/arbors/{repo}"
+}
+```
+
+| Key              | Values                                | Default             |
+| ---------------- | ------------------------------------- | ------------------- |
+| `runtime`        | `"node"`, `"bun"`                     | `"node"`            |
+| `language`       | `"en"`, `"ko"`, `"ja"`               | `"en"`              |
+| `packageManager` | `"auto"`, `"pnpm"`, `"yarn"`, `"npm"` | `"auto"`            |
+| `copyExcludes`   | `true`, `false`                       | `true`              |
+| `copySkip`       | `string[]`                            | `["node_modules"]`  |
+| `worktreeDir`    | string (`{repo}` placeholder)         | `"~/arbors/{repo}"` |
+
+## Development
+
+```sh
+pnpm test       # vitest
+pnpm lint       # oxlint
+pnpm format     # oxfmt
+pnpm build      # tsup
+pnpm typecheck  # tsc --noEmit
+```
+
+## License
+
+MIT

package/README.md

@@ -0,0 +1,131 @@
+# arbors
+
+[한국어](./README.ko.md) | [日本語](./README.ja.md)
+
+A CLI tool for managing git worktrees.
+
+Create a separate directory for each branch and work on multiple branches simultaneously — no stash or switch needed. Automatically copies exclude files and installs dependencies when creating worktrees.
+
+## Install
+
+```sh
+git clone git@github.com:sungsulee/arbors.git
+cd arbors
+pnpm install && pnpm build
+npm link
+```
+
+Shell integration (auto `cd` after worktree selection):
+
+```sh
+# ~/.zshrc
+source /path/to/arbors/shell/arbors-wrapper.zsh
+
+# ~/.bashrc
+source /path/to/arbors/shell/arbors-wrapper.sh
+```
+
+## Workflows
+
+### New feature development
+
+```sh
+# Create a new branch + worktree based on main
+arbors add -c feature/login --base main
+
+# This automatically:
+#   1. git fetch origin main
+#   2. Creates worktree at ~/arbors/{repo}/feature-login
+#   3. Copies files listed in .git/info/exclude (.env, etc.)
+#   4. Runs pnpm install (auto-detects from lockfile)
+
+cd ~/arbors/my-project/feature-login
+# Start working
+```
+
+When done:
+
+```sh
+arbors remove feature/login
+# Refuses to delete if there are uncommitted changes
+```
+
+### Code reviewing a colleague's PR
+
+Check out a remote branch as a local worktree:
+
+```sh
+# Automatically fetches from origin and creates worktree
+arbors add feature/payment
+
+# If the branch already exists locally, just creates the worktree
+# → Tries local first, falls back to origin
+```
+
+When review is done:
+
+```sh
+arbors remove feature/payment
+```
+
+### Working on multiple branches at once
+
+```sh
+arbors add -c feature/auth --base main
+arbors add -c fix/header-bug --base main
+
+arbors list
+# feature/auth    ~/arbors/my-project/feature-auth
+# fix/header-bug  ~/arbors/my-project/fix-header-bug
+
+# Work independently in each directory. No stashing needed.
+```
+
+## Commands
+
+```
+arbors add <branch>                     Checkout existing branch (local → remote auto)
+arbors add -c <branch> [--base <branch>]  Create new branch + worktree
+arbors remove <branch>                  Remove worktree (with safety checks)
+arbors list [--plain]                   List managed worktrees
+arbors excluded                         Show exclude patterns
+arbors config                           Show current config
+```
+
+## Configuration
+
+`~/.arbors/config.json` (global) or `.arbors/config.json` (per-project, takes precedence):
+
+```json
+{
+  "runtime": "node",
+  "language": "en",
+  "packageManager": "auto",
+  "copyExcludes": true,
+  "copySkip": ["node_modules"],
+  "worktreeDir": "~/arbors/{repo}"
+}
+```
+
+| Key              | Values                                | Default             |
+| ---------------- | ------------------------------------- | ------------------- |
+| `runtime`        | `"node"`, `"bun"`                     | `"node"`            |
+| `language`       | `"en"`, `"ko"`, `"ja"`               | `"en"`              |
+| `packageManager` | `"auto"`, `"pnpm"`, `"yarn"`, `"npm"` | `"auto"`            |
+| `copyExcludes`   | `true`, `false`                       | `true`              |
+| `copySkip`       | `string[]`                            | `["node_modules"]`  |
+| `worktreeDir`    | string (`{repo}` placeholder)         | `"~/arbors/{repo}"` |
+
+## Development
+
+```sh
+pnpm test       # vitest
+pnpm lint       # oxlint
+pnpm format     # oxfmt
+pnpm build      # tsup
+pnpm typecheck  # tsc --noEmit
+```
+
+## License
+
+MIT

package/bin/arbors.ts

@@ -0,0 +1,278 @@
+import chalk from "chalk";
+import { loadConfig } from "../src/config.js";
+import { copyExcludedFiles, getExcludePatterns } from "../src/git/exclude.js";
+import { validateWorktreeName, canSafelyRemove } from "../src/git/safety.js";
+import {
+  branchExists,
+  checkoutRemoteWorktree,
+  checkoutWorktree,
+  createWorktree,
+  getRepoRoot,
+  listWorktrees,
+  remoteBranchExists,
+  removeWorktree,
+} from "../src/git/worktree.js";
+import { loadMessages } from "../src/i18n/index.js";
+import { getWorktrees, registerProject, registerWorktree, unregisterWorktree } from "../src/project/registry.js";
+import { runSetup } from "../src/project/setup.js";
+import { createAdapter } from "../src/runtime/index.js";
+
+const parseArgs = (argv: string[]) => {
+  const args = argv.slice(2);
+  const command = args[0];
+
+  const flags = args.reduce<Record<string, string>>((acc, arg, i) => {
+    if (arg.startsWith("--") && args[i + 1] && !args[i + 1].startsWith("-")) {
+      acc[arg.slice(2)] = args[i + 1];
+    }
+    if (arg === "--plain") acc.plain = "true";
+    if (arg === "--create" || arg === "-c") acc.create = "true";
+    if (arg === "--help" || arg === "-h") acc.help = "true";
+    if (arg === "--version" || arg === "-v") acc.version = "true";
+    return acc;
+  }, {});
+
+  const name = args.slice(1).find((a) => !a.startsWith("-"));
+
+  return { command, name, flags };
+};
+
+const printHelp = (msg: typeof import("../src/i18n/en.js").en) => {
+  console.log(chalk.cyan.bold(msg.version));
+  console.log();
+  console.log(chalk.white(msg.usage));
+  console.log();
+  console.log(chalk.white(msg.commands));
+  console.log("  add <branch>                    Checkout existing branch (local or remote)");
+  console.log("  add -c <branch> [--base <br>]   Create a new branch worktree");
+  console.log("  remove <branch>                 Remove a worktree");
+  console.log("  list                            List worktrees");
+  console.log("  excluded                        Show exclude patterns");
+  console.log("  config                          Show current config");
+  console.log();
+  console.log(chalk.white(msg.options));
+  console.log("  --plain                       Machine-readable output");
+  console.log("  -h, --help                    Show help");
+  console.log("  -v, --version                 Show version");
+};
+
+const main = async () => {
+  const { command, name, flags } = parseArgs(process.argv);
+  const config = await loadConfig(
+    async (p) => {
+      const { readFile } = await import("node:fs/promises");
+      return readFile(p, "utf-8");
+    },
+    async (p) => {
+      const { stat } = await import("node:fs/promises");
+      try {
+        await stat(p);
+        return true;
+      } catch {
+        return false;
+      }
+    },
+  );
+
+  const msg = await loadMessages(config.language);
+  const adapter = await createAdapter(config.runtime);
+
+  if (flags.version) {
+    console.log(msg.version);
+    return;
+  }
+
+  if (flags.help || !command) {
+    printHelp(msg);
+    return;
+  }
+
+  switch (command) {
+    case "add": {
+      if (!name) {
+        console.error(chalk.red("✗ Usage: arbors add [-c] <branch> [--base <branch>]"));
+        process.exitCode = 1;
+        return;
+      }
+      if (!validateWorktreeName(name)) {
+        console.error(chalk.red(`✗ ${msg.invalidName}`));
+        process.exitCode = 1;
+        return;
+      }
+
+      console.log();
+      console.log(chalk.cyan.bold("arbors add"));
+      console.log();
+
+      let worktreePath: string;
+      let created = false;
+      let newBranch = false;
+
+      if (flags.create) {
+        // arbors add -c <branch> [--base main]
+        console.log(chalk.gray(msg.creating));
+        worktreePath = await createWorktree(adapter, name, config.worktreeDir, flags.base);
+        created = true;
+        newBranch = true;
+        console.log(chalk.green(`✓ ${msg.created}: ${worktreePath}`));
+        console.log(chalk.gray(`  Branch: ${name} (from ${flags.base ?? "default"})`));
+      } else if (await branchExists(adapter, name)) {
+        console.log(chalk.gray(`Checking out ${name}...`));
+        const result = await checkoutWorktree(adapter, name, config.worktreeDir);
+        worktreePath = result.path;
+        created = result.created;
+        console.log(chalk.green(`✓ ${msg.created}: ${worktreePath}`));
+        console.log(chalk.gray(`  Branch: ${name}`));
+      } else if (await remoteBranchExists(adapter, name)) {
+        console.log(chalk.gray(`Fetching ${name} from origin...`));
+        const result = await checkoutRemoteWorktree(adapter, name, config.worktreeDir);
+        worktreePath = result.path;
+        created = result.created;
+        newBranch = result.created;
+        console.log(chalk.green(`✓ ${msg.created}: ${worktreePath}`));
+        console.log(chalk.gray(`  Branch: ${name} (from origin/${name})`));
+      } else {
+        console.error(
+          chalk.red(`✗ Branch '${name}' not found locally or on origin. Use 'arbors add -c' to create.`),
+        );
+        process.exitCode = 1;
+        return;
+      }
+
+      try {
+        if (config.copyExcludes) {
+          console.log();
+          console.log(chalk.gray(msg.copying));
+          const copied = await copyExcludedFiles(adapter, worktreePath, config.copySkip);
+          console.log(chalk.green(`✓ ${msg.copied} (${copied.length} files)`));
+        }
+
+        console.log();
+        console.log(chalk.gray(msg.installing));
+        await runSetup(adapter, worktreePath, config.packageManager);
+        console.log(chalk.green(`✓ ${msg.installed}`));
+
+        const repoRoot = await getRepoRoot(adapter);
+        await registerProject(adapter, name, repoRoot);
+        await registerWorktree(adapter, worktreePath, name, repoRoot);
+      } catch (setupErr) {
+        console.error(chalk.red(`✗ ${(setupErr as Error).message}`));
+        if (created) {
+          console.log(chalk.gray("Rolling back worktree..."));
+          await adapter
+            .exec("git", ["worktree", "remove", "--force", worktreePath])
+            .catch(() => {});
+          if (newBranch) {
+            await adapter.exec("git", ["branch", "-D", name]).catch(() => {});
+          }
+        }
+        process.exitCode = 1;
+        return;
+      }
+
+      console.log();
+      console.log(chalk.gray(`  cd ${worktreePath}`));
+      break;
+    }
+
+    case "remove": {
+      if (!name) {
+        console.error(chalk.red("✗ Usage: arbors remove <branch>"));
+        process.exitCode = 1;
+        return;
+      }
+
+      console.log();
+      console.log(chalk.cyan.bold("arbors remove"));
+      console.log();
+
+      // Find the worktree by branch name
+      const worktrees = await listWorktrees(adapter);
+      const target = worktrees.find((wt) => wt.branch === name);
+
+      if (!target) {
+        console.error(chalk.red(`✗ No worktree found for branch '${name}'`));
+        process.exitCode = 1;
+        return;
+      }
+
+      const { safe, reason } = await canSafelyRemove(adapter, target.path);
+      if (!safe) {
+        const errorMsg = reason ? msg[reason as keyof typeof msg] : "Cannot remove";
+        console.error(chalk.red(`✗ ${errorMsg}`));
+        process.exitCode = 1;
+        return;
+      }
+
+      console.log(chalk.gray(msg.removing));
+      await removeWorktree(adapter, target.path, target.branch);
+      await unregisterWorktree(adapter, target.path);
+      console.log(chalk.green(`✓ ${msg.removed}: ${name}`));
+      break;
+    }
+
+    case "list": {
+      const repoRootForList = await getRepoRoot(adapter);
+      const dbWorktrees = await getWorktrees(adapter, repoRootForList);
+      const gitWorktrees = await listWorktrees(adapter);
+      const gitPaths = new Set(gitWorktrees.map((wt) => wt.path));
+
+      // Reconcile: remove db entries that no longer exist in git
+      const stale = dbWorktrees.filter((w) => !gitPaths.has(w.path));
+      for (const w of stale) {
+        await unregisterWorktree(adapter, w.path);
+      }
+
+      const managedWorktrees = dbWorktrees.filter((w) => gitPaths.has(w.path));
+
+      if (flags.plain) {
+        managedWorktrees.forEach((wt) => console.log(`${wt.branch}\t${wt.path}`));
+      } else if (managedWorktrees.length === 0) {
+        console.log(chalk.gray(msg.noWorktrees));
+      } else {
+        console.log();
+        console.log(chalk.cyan.bold("arbors list"));
+        console.log();
+        managedWorktrees.forEach((wt) => {
+          console.log(chalk.white(wt.branch));
+          console.log(chalk.gray(`  ${wt.path}`));
+        });
+      }
+      break;
+    }
+
+    case "excluded": {
+      const patterns = await getExcludePatterns(adapter);
+      if (patterns.length === 0) {
+        console.log(chalk.gray("No exclude patterns found in .git/info/exclude"));
+      } else {
+        console.log();
+        console.log(chalk.cyan.bold("arbors excluded"));
+        console.log();
+        patterns.forEach((p) => console.log(`  ${p}`));
+      }
+      break;
+    }
+
+    case "config": {
+      console.log();
+      console.log(chalk.cyan.bold("arbors config"));
+      console.log();
+      Object.entries(config).forEach(([key, value]) => {
+        console.log(`  ${chalk.white(key)}: ${chalk.gray(String(value))}`);
+      });
+      break;
+    }
+
+    default: {
+      console.error(chalk.red(`✗ Unknown command: ${command}`));
+      printHelp(msg);
+      process.exitCode = 1;
+    }
+  }
+};
+
+main().catch((err: Error) => {
+  console.error(chalk.red(`✗ ${err.message}`));
+  process.exitCode = 1;
+});