@getsolaris/copse 1.0.0 → 1.0.1

package/README.md

@@ -12,35 +12,35 @@ Manage git worktrees with ease. Create, switch, and clean up worktrees with conf
 
 ## Features
 
-- **TUI mode** — interactive terminal UI (`cop`)
-- **CLI mode** — scriptable commands (`cop add`, `cop list`, etc.)
+- **TUI mode** — interactive terminal UI (`copse`)
+- **CLI mode** — scriptable commands (`copse add`, `copse list`, etc.)
 - **Config-driven** — per-repo hooks, file copying, symlinks
 - **Monorepo support** — auto-detect packages, per-package hooks, focus tracking
-- **Health checks** — `cop doctor` diagnoses worktree issues
+- **Health checks** — `copse doctor` diagnoses worktree issues
 - **Centralized worktrees** — all worktrees under `~/.copse/worktrees/` by default
 - **Smart cleanup** — auto-detect and remove merged worktrees
 - **Themes** — 9 built-in color themes (OpenCode, Tokyo Night, Dracula, Nord, Catppuccin, GitHub Dark, One Dark, Monokai, GitHub Light)
-- **Templates** — reusable worktree presets (`cop add --template review`)
-- **Cross-worktree exec** — run commands across all worktrees (`cop exec "bun test"`)
-- **GitHub PR integration** — create worktrees from PRs (`cop add --pr 123`)
+- **Templates** — reusable worktree presets (`copse add --template review`)
+- **Cross-worktree exec** — run commands across all worktrees (`copse exec "bun test"`)
+- **GitHub PR integration** — create worktrees from PRs (`copse add --pr 123`)
 - **Fuzzy branch picker** — interactive branch selection in TUI with type-ahead filtering
 - **Lifecycle management** — auto-detect stale/merged worktrees, configurable limits
 - **Shared dependencies** — save disk with hardlink/symlink strategies for `node_modules`
-- **Worktree diff** — compare changes between worktrees (`cop diff feature/a feature/b`)
-- **Pin protection** — protect worktrees from auto-cleanup (`cop pin`)
-- **Activity log** — track create/delete/switch/rename/archive/import events (`cop log`)
-- **Archive** — preserve worktree changes as patches before removal (`cop archive`)
-- **Branch rename** — rename worktree branches with metadata migration (`cop rename`)
-- **Clone & init** — clone repos with cop config initialization (`cop clone`)
-- **Import worktrees** — adopt manually-created worktrees (`cop import`)
+- **Worktree diff** — compare changes between worktrees (`copse diff feature/a feature/b`)
+- **Pin protection** — protect worktrees from auto-cleanup (`copse pin`)
+- **Activity log** — track create/delete/switch/rename/archive/import events (`copse log`)
+- **Archive** — preserve worktree changes as patches before removal (`copse archive`)
+- **Branch rename** — rename worktree branches with metadata migration (`copse rename`)
+- **Clone & init** — clone repos with copse config initialization (`copse clone`)
+- **Import worktrees** — adopt manually-created worktrees (`copse import`)
 - **Detail view** — expanded worktree info with commits, diff stats, upstream status (TUI)
 - **Bulk actions** — multi-select and batch operations on worktrees (TUI)
 - **Toast notifications** — non-blocking operation feedback (TUI)
-- **Shell completions** — tab completion for bash/zsh/fish (`cop shell-init --completions`)
-- **Config profiles** — switch between configuration sets (`cop config --profiles`)
-- **Tmux sessions** — auto-create/kill tmux sessions per worktree with layout templates (`cop session`)
+- **Shell completions** — tab completion for bash/zsh/fish (`copse shell-init --completions`)
+- **Config profiles** — switch between configuration sets (`copse config --profiles`)
+- **Tmux sessions** — auto-create/kill tmux sessions per worktree with layout templates (`copse session`)
 - **Workspaces** — auto-discover git repos under parent directories with per-workspace defaults (`workspaces` config)
-- **AI agent init** — create config by default or install cop skill for Claude Code, Codex, OpenCode (`cop init`, `cop init --skill`)
+- **AI agent init** — create config by default or install copse skill for Claude Code, Codex, OpenCode (`copse init`, `copse init --skill`)
 
 ## Requirements
 
@@ -48,7 +48,7 @@ Manage git worktrees with ease. Create, switch, and clean up worktrees with conf
 - git 2.17+
 - macOS or Linux
 - [gh CLI](https://cli.github.com) (optional, for `--pr` flag)
-- [tmux](https://github.com/tmux/tmux) (optional, for `cop session`)
+- [tmux](https://github.com/tmux/tmux) (optional, for `copse session`)
 
 ## Installation
 
@@ -91,75 +91,75 @@ Prefer targeted tests first when you change covered code, then run the full chec
 
 ```bash
 # Launch TUI
-cop
+copse
 
 # List worktrees
-cop list
+copse list
 
 # Create a new worktree
-cop add feature/my-feature
+copse add feature/my-feature
 
 # Create with monorepo focus
-cop add feature/my-feature --focus apps/web,apps/api
+copse add feature/my-feature --focus apps/web,apps/api
 
 # Create from a GitHub PR
-cop add --pr 123
+copse add --pr 123
 
 # Use a template
-cop add feature/login --template review
+copse add feature/login --template review
 
 # Pin a worktree to protect from cleanup
-cop pin feature/important --reason "active sprint"
+copse pin feature/important --reason "active sprint"
 
 # View activity log
-cop log
+copse log
 
 # Archive worktree changes before removing
-cop archive feature/done --yes
+copse archive feature/done --yes
 
 # Rename a worktree branch
-cop rename old-name new-name
+copse rename old-name new-name
 
-# Clone and initialize cop
-cop clone https://github.com/user/repo.git
+# Clone and initialize copse
+copse clone https://github.com/user/repo.git
 
 # Import an existing worktree
-cop import /path/to/worktree
+copse import /path/to/worktree
 
 # Open/attach tmux session for a worktree
-cop session feature/my-feature
+copse session feature/my-feature
 
 # Create worktree with tmux session
-cop add feature/new --session
+copse add feature/new --session
 
 # Run command across all worktrees
-cop exec "bun test"
+copse exec "bun test"
 
 # Compare two worktrees
-cop diff feature/a feature/b --stat
+copse diff feature/a feature/b --stat
 
 # Check worktree health
-cop doctor
+copse doctor
 
 # Switch to a worktree (requires shell integration)
-cop switch feature/my-feature
+copse switch feature/my-feature
 
 # Remove a worktree
-cop remove feature/my-feature --yes
+copse remove feature/my-feature --yes
 
 # Clean up merged worktrees
-cop clean --dry-run
+copse clean --dry-run
 
 # Initialize config file
-cop init
+copse init
 
 # Generate AI agent skill file
-cop init --skill claude-code
+copse init --skill claude-code
 ```
 
 ## TUI Usage
 
-Launch with `cop` (no arguments).
+Launch with `copse` (no arguments).
 
 ### Keyboard Shortcuts
 
@@ -270,50 +270,50 @@ Every commit runs `validateConfig` before writing. Invalid input surfaces as an
 
 | Command                  | Description                          |
 | ------------------------ | ------------------------------------ |
-| `cop`                    | Launch TUI                           |
-| `cop list`               | List all worktrees (with focus info) |
-| `cop add <branch>`       | Create worktree                      |
-| `cop remove <branch>`    | Remove worktree                      |
-| `cop switch <branch>`    | Switch to worktree                   |
-| `cop clean`              | Remove merged worktrees              |
-| `cop doctor`             | Check worktree health                |
-| `cop config`             | Manage configuration                 |
-| `cop exec <command>`     | Run command in each worktree         |
-| `cop diff <ref1> [ref2]` | Diff between worktrees/branches      |
-| `cop pin <branch>`       | Pin/unpin worktree (protect from cleanup) |
-| `cop log`                | Show worktree activity log           |
-| `cop archive <branch>`   | Archive changes and optionally remove |
-| `cop rename <old> <new>` | Rename worktree branch               |
-| `cop clone <url>`        | Clone repo and initialize cop        |
-| `cop import <path>`      | Adopt worktree with cop metadata     |
-| `cop session [branch]`   | Manage tmux sessions for worktrees   |
-| `cop open [branch]`      | Open a worktree in your editor (focus-aware) |
-| `cop init`               | Initialize config or install AI agent skills |
-
-### `cop add`
+| `copse`                    | Launch TUI                           |
+| `copse list`               | List all worktrees (with focus info) |
+| `copse add <branch>`       | Create worktree                      |
+| `copse remove <branch>`    | Remove worktree                      |
+| `copse switch <branch>`    | Switch to worktree                   |
+| `copse clean`              | Remove merged worktrees              |
+| `copse doctor`             | Check worktree health                |
+| `copse config`             | Manage configuration                 |
+| `copse exec <command>`     | Run command in each worktree         |
+| `copse diff <ref1> [ref2]` | Diff between worktrees/branches      |
+| `copse pin <branch>`       | Pin/unpin worktree (protect from cleanup) |
+| `copse log`                | Show worktree activity log           |
+| `copse archive <branch>`   | Archive changes and optionally remove |
+| `copse rename <old> <new>` | Rename worktree branch               |
+| `copse clone <url>`        | Clone repo and initialize copse        |
+| `copse import <path>`      | Adopt worktree with copse metadata     |
+| `copse session [branch]`   | Manage tmux sessions for worktrees   |
+| `copse open [branch]`      | Open a worktree in your editor (focus-aware) |
+| `copse init`               | Initialize config or install AI agent skills |
+
+### `copse add`
 
 ```bash
-cop add feature/login                        # Create branch if needed + worktree
-cop add feature/login --base main            # New branches start from main
-cop add existing-branch                      # Worktree for existing branch
+copse add feature/login                        # Create branch if needed + worktree
+copse add feature/login --base main            # New branches start from main
+copse add existing-branch                      # Worktree for existing branch
 
 # Monorepo: create with focus packages
-cop add feature/login --focus apps/web,apps/api
-cop add feature/login --focus apps/web --focus apps/api
+copse add feature/login --focus apps/web,apps/api
+copse add feature/login --focus apps/web --focus apps/api
 
 # Use a template
-cop add feature/login --template review
+copse add feature/login --template review
 
 # Create from a GitHub PR (requires gh CLI)
-cop add --pr 123
-cop add --pr 456 --template review
+copse add --pr 123
+copse add --pr 456 --template review
 ```
 
-### `cop doctor`
+### `copse doctor`
 
 ```bash
-cop doctor              # Human-readable output
-cop doctor --json       # JSON output for scripting
+copse doctor              # Human-readable output
+copse doctor --json       # JSON output for scripting
 ```
 
 Exit code: `0` if healthy, `1` if any warnings or errors.
@@ -331,43 +331,43 @@ copse doctor
 All checks passed.
 ```
 
-### `cop list`
+### `copse list`
 
 ```bash
-cop list                # Table with Focus column
-cop list --json         # JSON with focus array
-cop list --porcelain    # Machine-readable
+copse list                # Table with Focus column
+copse list --json         # JSON with focus array
+copse list --porcelain    # Machine-readable
 ```
 
 Output includes a `Focus` column showing monorepo focus paths per worktree.
 
-### `cop remove`
+### `copse remove`
 
 ```bash
-cop remove feature/login               # Remove by branch name
-cop remove feature/login --force        # Force remove (dirty worktree)
-cop remove feature/login --yes          # Skip confirmation
+copse remove feature/login               # Remove by branch name
+copse remove feature/login --force        # Force remove (dirty worktree)
+copse remove feature/login --yes          # Skip confirmation
 ```
 
-### `cop clean`
+### `copse clean`
 
 ```bash
-cop clean --dry-run    # Preview what would be removed
-cop clean              # Remove all merged worktrees
-cop clean --stale      # Also show stale worktrees (uses lifecycle config)
+copse clean --dry-run    # Preview what would be removed
+copse clean              # Remove all merged worktrees
+copse clean --stale      # Also show stale worktrees (uses lifecycle config)
 ```
 
-### `cop exec`
+### `copse exec`
 
 Run a shell command in every non-main worktree.
 
 ```bash
-cop exec "bun test"                   # Run in all worktrees (sequential)
-cop exec "bun test" --parallel        # Run in parallel
-cop exec "git pull" --all             # Across all configured repos
-cop exec "bun install" --dirty        # Only dirty worktrees
-cop exec "git rebase main" --behind   # Only worktrees behind upstream
-cop exec "bun test" --json            # JSON output
+copse exec "bun test"                   # Run in all worktrees (sequential)
+copse exec "bun test" --parallel        # Run in parallel
+copse exec "git pull" --all             # Across all configured repos
+copse exec "bun install" --dirty        # Only dirty worktrees
+copse exec "git rebase main" --behind   # Only worktrees behind upstream
+copse exec "bun test" --json            # JSON output
 ```
 
 | Flag                | Description                           |
@@ -379,116 +379,116 @@ cop exec "bun test" --json            # JSON output
 | `--behind`          | Only run in worktrees behind upstream |
 | `--json` / `-j`     | Output results as JSON                |
 
-Environment variables available in commands: `COP_BRANCH`, `COP_WORKTREE_PATH`, `COP_REPO_PATH`.
+Environment variables available in commands: `COPSE_BRANCH`, `COPSE_WORKTREE_PATH`, `COPSE_REPO_PATH`.
 
-### `cop diff`
+### `copse diff`
 
 Show diff between two worktree branches.
 
 ```bash
-cop diff feature/a feature/b         # Full diff
-cop diff feature/a feature/b --stat  # Diffstat summary
-cop diff feature/a --name-only       # Changed file names only
-cop diff feature/a                   # Compare against current HEAD
+copse diff feature/a feature/b         # Full diff
+copse diff feature/a feature/b --stat  # Diffstat summary
+copse diff feature/a --name-only       # Changed file names only
+copse diff feature/a                   # Compare against current HEAD
 ```
 
-### `cop pin`
+### `copse pin`
 
 ```bash
-cop pin feature/auth --reason "active sprint"  # Pin with reason
-cop pin --list                                  # List pinned worktrees
-cop pin --list --json                           # JSON output
-cop unpin feature/auth                          # Unpin
+copse pin feature/auth --reason "active sprint"  # Pin with reason
+copse pin --list                                  # List pinned worktrees
+copse pin --list --json                           # JSON output
+copse unpin feature/auth                          # Unpin
 ```
 
-Pinned worktrees are excluded from `cop clean` and lifecycle auto-cleanup.
+Pinned worktrees are excluded from `copse clean` and lifecycle auto-cleanup.
 
-### `cop log`
+### `copse log`
 
 ```bash
-cop log                # Show last 20 events
-cop log --limit 50     # Show last 50 events
-cop log --json         # JSON output
-cop log --clear        # Clear activity log
+copse log                # Show last 20 events
+copse log --limit 50     # Show last 50 events
+copse log --json         # JSON output
+copse log --clear        # Clear activity log
 ```
 
 Events are color-coded: create (green), delete (red), switch (blue), rename (yellow), archive (magenta), import (cyan).
 
-### `cop archive`
+### `copse archive`
 
 ```bash
-cop archive feature/done --yes       # Archive and remove
-cop archive feature/wip --keep       # Archive without removing
-cop archive --list                   # List all archives
-cop archive --list --json            # JSON output
+copse archive feature/done --yes       # Archive and remove
+copse archive feature/wip --keep       # Archive without removing
+copse archive --list                   # List all archives
+copse archive --list --json            # JSON output
 ```
 
 Archives are stored as patch files in `~/.copse/archives/`.
 
-### `cop rename`
+### `copse rename`
 
 ```bash
-cop rename old-branch new-branch             # Rename branch
-cop rename old-branch new-branch --move-path # Also move worktree directory
+copse rename old-branch new-branch             # Rename branch
+copse rename old-branch new-branch --move-path # Also move worktree directory
 ```
 
-### `cop clone`
+### `copse clone`
 
 ```bash
-cop clone https://github.com/user/repo.git              # Clone and init
-cop clone https://github.com/user/repo.git ./my-dir     # Custom target path
-cop clone https://github.com/user/repo.git --template review # Apply template
-cop clone https://github.com/user/repo.git --no-init-config  # Skip config init
+copse clone https://github.com/user/repo.git              # Clone and init
+copse clone https://github.com/user/repo.git ./my-dir     # Custom target path
+copse clone https://github.com/user/repo.git --template review # Apply template
+copse clone https://github.com/user/repo.git --no-init-config  # Skip config init
 ```
 
-### `cop import`
+### `copse import`
 
 ```bash
-cop import /path/to/worktree                           # Adopt worktree
-cop import /path/to/worktree --focus apps/web,apps/api # With focus
-cop import /path/to/worktree --pin                     # Pin immediately
+copse import /path/to/worktree                           # Adopt worktree
+copse import /path/to/worktree --focus apps/web,apps/api # With focus
+copse import /path/to/worktree --pin                     # Pin immediately
 ```
 
-### `cop session`
+### `copse session`
 
 Manage tmux sessions for worktrees. Requires tmux.
 
 ```bash
-cop session feature/auth              # Open/attach session (create if needed)
-cop session feature/auth --layout api # Use named layout from config
-cop session --list                    # List active cop sessions
-cop session --list --json             # JSON output
-cop session feature/auth --kill       # Kill session for worktree
-cop session --kill-all                # Kill all cop sessions
+copse session feature/auth              # Open/attach session (create if needed)
+copse session feature/auth --layout api # Use named layout from config
+copse session --list                    # List active copse sessions
+copse session --list --json             # JSON output
+copse session feature/auth --kill       # Kill session for worktree
+copse session --kill-all                # Kill all copse sessions
 ```
 
 Sessions are auto-created/killed when `sessions.autoCreate` / `sessions.autoKill` are enabled in config.
 
 ```bash
 # Create worktree with tmux session
-cop add feature/login --session
-cop add feature/login --session --layout api
+copse add feature/login --session
+copse add feature/login --session --layout api
 ```
 
-When `sessions.enabled` is `true` and you're inside tmux, `cop switch` automatically switches to the target worktree's tmux session.
+When `sessions.enabled` is `true` and you're inside tmux, `copse switch` automatically switches to the target worktree's tmux session.
 
-### `cop open`
+### `copse open`
 
 Open a worktree in your editor or IDE. Auto-detects `$VISUAL` / `$EDITOR` and falls back to a known list (`code`, `cursor`, `vim`, `nvim`, `emacs`, `nano`, `subl`, `zed`, `idea`, `webstorm`).
 
 ```bash
-cop open                              # Open the current worktree
-cop open feature/auth                 # Open a specific worktree
-cop open feature/auth -e nvim         # Override editor
+copse open                              # Open the current worktree
+copse open feature/auth                 # Open a specific worktree
+copse open feature/auth -e nvim         # Override editor
 
 # Focus-aware behavior (when the worktree was created with --focus)
-cop open feature/auth                 # 1 focus path → opens that focus
+copse open feature/auth                 # 1 focus path → opens that focus
                                       # 2+ focus paths → errors with hint
-cop open feature/auth --focus apps/web   # Pick a specific focus path
-cop open feature/auth -f apps/api        # Same with the short alias
-cop open feature/auth --root             # Force the worktree root, ignore focus
+copse open feature/auth --focus apps/web   # Pick a specific focus path
+copse open feature/auth -f apps/api        # Same with the short alias
+copse open feature/auth --root             # Force the worktree root, ignore focus
 
-cop open --list-editors               # List detected editors
+copse open --list-editors               # List detected editors
 ```
 
 | Flag | Alias | Description |
@@ -504,22 +504,22 @@ cop open --list-editors               # List detected editors
 - 1 focus path set → opens `<worktree>/<focus>` automatically.
 - 2+ focus paths set → errors out and asks for `--focus <path>` or `--root` (the TUI shows an interactive picker instead).
 
-### `cop init`
+### `copse init`
 
-Initialize cop config by default, or install cop skill for AI coding agents so they can use cop commands.
+Initialize copse config by default, or install copse skill for AI coding agents so they can use copse commands.
 
 ```bash
-cop init                         # → ~/.config/copse/config.json
-cop init --skill claude-code   # → ~/.claude/skills/cop/
-cop init --skill codex          # → ~/.agents/skills/cop/
-cop init --skill opencode       # → ~/.config/opencode/skill/cop/
+copse init                         # → ~/.config/copse/config.json
+copse init --skill claude-code   # → ~/.claude/skills/copse/
+copse init --skill codex          # → ~/.agents/skills/copse/
+copse init --skill opencode       # → ~/.config/opencode/skill/copse/
 ```
 
 | Platform | Skill Path |
 |----------|-----------|
-| `claude-code` | `~/.claude/skills/cop/` |
-| `codex` | `~/.agents/skills/cop/` |
-| `opencode` | `~/.config/opencode/skill/cop/` |
+| `claude-code` | `~/.claude/skills/copse/` |
+| `codex` | `~/.agents/skills/copse/` |
+| `opencode` | `~/.config/opencode/skill/copse/` |
 
 Each skill directory contains:
 - `SKILL.md` — overview and common workflows
@@ -530,19 +530,19 @@ The command is idempotent — running it again updates the skill directory.
 
 #### Auto-init on first run
 
-You don't have to run `cop init` manually. The first time you run any `cop` command (including launching the TUI), if `~/.config/copse/config.json` does not exist, cop creates it with the default template and prints a one-line notice to stderr:
+You don't have to run `copse init` manually. The first time you run any `copse` command (including launching the TUI), if `~/.config/copse/config.json` does not exist, copse creates it with the default template and prints a one-line notice to stderr:
 
 ```
-cop: created default config at /Users/you/.config/copse/config.json
+copse: created default config at /Users/you/.config/copse/config.json
 ```
 
-The notice is suppressed when stdout is not a TTY (so pipes, scripts, and CI stay quiet) and when you run `cop init` explicitly (to avoid duplicate messages with init's own success line). Auto-init is fully idempotent — subsequent runs do nothing.
+The notice is suppressed when stdout is not a TTY (so pipes, scripts, and CI stay quiet) and when you run `copse init` explicitly (to avoid duplicate messages with init's own success line). Auto-init is fully idempotent — subsequent runs do nothing.
 
 ## Configuration
 
 Config file: `~/.config/copse/config.json`
 
-Initialize with: `cop config --init` (or just run any `cop` command — see [Auto-init on first run](#auto-init-on-first-run))
+Initialize with: `copse config --init` (or just run any `copse` command — see [Auto-init on first run](#auto-init-on-first-run))
 
 ### Full Example
 
@@ -588,7 +588,7 @@ Initialize with: `cop config --init` (or just run any `cop` command — see [Aut
     "enabled": true,
     "autoCreate": false,
     "autoKill": true,
-    "prefix": "cop",
+    "prefix": "copse",
     "defaultLayout": "dev",
     "layouts": {
       "dev": {
@@ -809,13 +809,13 @@ Named presets for worktree creation. Each template can override any default fiel
 | `autoUpstream` | `boolean`  | Override upstream tracking         |
 | `base`         | `string`   | Default base branch for newly created branches |
 
-Usage: `cop add feature/login --template review`
+Usage: `copse add feature/login --template review`
 
 Template values override the resolved repo config. The `base` field sets a default for `--base` if not explicitly provided.
 
 #### `lifecycle`
 
-Automatic worktree lifecycle management. Used by `cop clean --stale`.
+Automatic worktree lifecycle management. Used by `copse clean --stale`.
 
 ```json
 {
@@ -838,9 +838,9 @@ Automatic worktree lifecycle management. Used by `cop clean --stale`.
 Switch between different configuration sets.
 
 ```bash
-cop config --profiles                    # List profiles
-cop config --profile work --activate     # Activate profile
-cop config --profile personal --delete   # Delete profile
+copse config --profiles                    # List profiles
+copse config --profile work --activate     # Activate profile
+copse config --profile personal --delete   # Delete profile
 ```
 
 #### `sessions`
@@ -853,7 +853,7 @@ Tmux session management for worktrees.
     "enabled": true,
     "autoCreate": true,
     "autoKill": true,
-    "prefix": "cop",
+    "prefix": "copse",
     "defaultLayout": "dev",
     "layouts": {
       "dev": {
@@ -871,9 +871,9 @@ Tmux session management for worktrees.
 | Field           | Type      | Default | Description                                        |
 | --------------- | --------- | ------- | -------------------------------------------------- |
 | `enabled`       | `boolean` | `false` | Enable session integration (auto-switch in tmux)   |
-| `autoCreate`    | `boolean` | `false` | Auto-create tmux session on `cop add`              |
-| `autoKill`      | `boolean` | `false` | Auto-kill tmux session on `cop remove`             |
-| `prefix`        | `string`  | `"cop"` | Prefix for tmux session names                      |
+| `autoCreate`    | `boolean` | `false` | Auto-create tmux session on `copse add`              |
+| `autoKill`      | `boolean` | `false` | Auto-kill tmux session on `copse remove`             |
+| `prefix`        | `string`  | `"copse"` | Prefix for tmux session names                      |
 | `defaultLayout` | `string`  | —       | Default layout name for new sessions               |
 | `layouts`       | `object`  | `{}`    | Named layouts with window definitions              |
 
@@ -884,7 +884,7 @@ Tmux session management for worktrees.
 | `name`    | `string` | Yes      | Window name                    |
 | `command` | `string` | No       | Command to run in the window   |
 
-Session naming: branch `feat/auth-token` → tmux session `cop_feat-auth-token`.
+Session naming: branch `feat/auth-token` → tmux session `copse_feat-auth-token`.
 
 #### `sharedDeps`
 
@@ -919,12 +919,12 @@ Share dependencies between main repo and worktrees to save disk space. Can be se
 Track which monorepo packages a worktree is working on.
 
 ```bash
-cop add feature/login --focus apps/web,apps/api
+copse add feature/login --focus apps/web,apps/api
 ```
 
 - Supports comma-separated, space-separated, or multiple `--focus` flags
 - Focus metadata is stored in git internals (not in the worktree root)
-- `cop list` shows focus paths per worktree
+- `copse list` shows focus paths per worktree
 - Monorepo hooks only fire for matching focus paths
 - Focus is optional — omitting it creates a normal worktree
 
@@ -961,41 +961,41 @@ Available: `opencode`, `tokyo-night`, `dracula`, `nord`, `catppuccin`, `github-d
 
 ## Shell Integration
 
-Use `cop shell-init` to install shell integration for `cop switch`.
+Use `copse shell-init` to install shell integration for `copse switch`.
 
 ### Completions
 
 ```bash
 # Add completions (bash)
-eval "$(cop shell-init --completions bash)"
+eval "$(copse shell-init --completions bash)"
 
 # Add completions (zsh)
-eval "$(cop shell-init --completions zsh)"
+eval "$(copse shell-init --completions zsh)"
 
 # Add completions (fish)
-cop shell-init --completions fish | source
+copse shell-init --completions fish | source
 ```
 
 ### Examples
 
 ```bash
 # zsh
-echo 'eval "$(cop shell-init zsh)"' >> ~/.zshrc
+echo 'eval "$(copse shell-init zsh)"' >> ~/.zshrc
 source ~/.zshrc
 
 # bash
-echo 'eval "$(cop shell-init bash)"' >> ~/.bashrc
+echo 'eval "$(copse shell-init bash)"' >> ~/.bashrc
 source ~/.bashrc
 
 # fish
-cop shell-init fish >> ~/.config/fish/config.fish
+copse shell-init fish >> ~/.config/fish/config.fish
 source ~/.config/fish/config.fish
 ```
 
 You can also preview the generated wrapper before saving it:
 
 ```bash
-cop shell-init zsh
+copse shell-init zsh
 ```
 
 ## License