copa-cli 0.6.0__tar.gz → 0.7.0__tar.gz

{copa_cli-0.6.0 → copa_cli-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: copa-cli
-Version: 0.6.0
+Version: 0.7.0
 Summary: Command Palette — smart command tracking, ranking, and sharing for your shell
 Author: Mark Stanford
 License-Expression: MIT
@@ -46,7 +46,9 @@ Copa tracks the commands you run, ranks them by frequency and recency, and gives
 - **LLM descriptions** — `copa fix --auto` uses Claude or ollama to generate descriptions for undescribed commands
 - **Script protocol** — `#@ Description:` / `#@ Usage:` / `#@ Purpose:` / `#@ Flag:` headers in your scripts are auto-detected by `copa scan` across all `$PATH` directories
 - **Flag documentation** — document command flags with descriptions; flags are searchable, visible in the preview pane, and preserved in `.copa` exports
+- **Inline suggestions** — ghost text appears as you type; Tab accepts or opens a completion menu with the suggestion highlighted
 - **Groups & Ctrl+G** — organize commands by project, device, or workflow; assign groups inline from the fzf palette with Ctrl+G
+- **Bulk operations** — Ctrl+B enters select mode for batch group assignment, batch deletion, or batch LLM description
 - **Sharing & `copa create`** — export/import command sets as `.copa` JSON files; `copa create` scaffolds a `.copa` file from an existing group
 - **Set filtering** — scope list, search, and fzf to a specific shared set with `--set`
 - **MCP server** — expose your commands to Claude Code (or any MCP client)
@@ -85,24 +87,47 @@ pip install -e .
 pip install copa-cli[ollama]
 ```
 
-### Shell integration (required)
+### Setup
 
-Add this line to your `~/.zshrc`:
+Run the interactive setup wizard:
 
 ```bash
-eval "$(copa init zsh)"
+copa setup
 ```
 
-Then restart your shell or run `source ~/.zshrc`. This does three things:
+This walks you through everything:
+1. Checks that **fzf** is installed (tells you how to install if missing)
+2. Creates the Copa database (`~/.copa/copa.db`)
+3. Adds shell integration to your `~/.zshrc` (prompts for confirmation)
+4. Optionally imports your zsh history
+
+Then activate Copa in your current terminal:
+
+```bash
+source ~/.zshrc
+```
+
+### What shell integration does
+
+The `eval "$(copa init zsh)"` line added to your `.zshrc` does three things:
 
 1. **Records every command you run** — a `precmd` hook silently calls `copa _record` in the background after each command, building up frequency and recency data with zero latency impact.
 2. **Replaces Ctrl+R** — the default zsh reverse-history-search is replaced with Copa's fzf-powered command palette (see below).
 3. **Supplements tab completion** — Copa registers as a completer so that any command gets completion candidates from your Copa database. The behavior is configurable (`fallback`, `hybrid`, `always`, or `never`) — see [Tab Completion](#tab-completion).
 
-Initialize the database:
+### Manual setup
+
+If you prefer to set up manually instead of using `copa setup`:
 
 ```bash
-copa _init
+# Add shell integration to ~/.zshrc
+echo 'eval "$(copa init zsh)"' >> ~/.zshrc
+
+# Activate in current terminal
+source ~/.zshrc
+
+# Import your history (optional)
+copa sync
 ```
 
 ## Ctrl+R — fzf Command Palette
@@ -151,11 +176,40 @@ While the fzf palette is open, these keys are available:
 | **Ctrl+N** | Cycle group | Cycles through groups: (all) → group1 → group2 → ... → (all) |
 | **Ctrl+D** | Describe | Generate/edit a description using LLM (with tty-aware input) |
 | **Ctrl+F** | Edit flags | Add flag documentation to the highlighted command |
+| **Ctrl+B** | Select mode | Enter multi-select for bulk operations (see below) |
 | **Ctrl+H** | Toggle header | Show/hide the key hints for more screen space |
 | **ESC** | Cancel/back | In scope/group mode: returns to command list. Otherwise: closes fzf |
 
 Keybindings are configurable via `~/.copa/config.toml`. See [Configuration](#configuration).
 
+### Select mode (bulk operations)
+
+Press **Ctrl+B** from the Ctrl+R palette to enter **select mode**. This opens a new fzf view with multi-select enabled:
+
+- **Tab** toggles selection on individual commands
+- **Ctrl+R** cycles modes (all → frequent → recent) just like the main palette
+- **Enter** confirms your selection and shows the batch action menu
+- **ESC** cancels and returns to your prompt
+
+After selecting commands, Copa shows a batch action menu:
+
+```
+Selected 5 command(s).
+  g = assign group
+  d = delete
+  a = auto-describe (LLM)
+  q = cancel
+Action:
+```
+
+| Action | What it does |
+|--------|-------------|
+| **g** | Assign all selected commands to a group (or clear their group) |
+| **d** | Delete all selected commands (with confirmation) |
+| **a** | Auto-generate descriptions for all selected commands using your configured LLM backend |
+
+This is useful for organizing large command sets — select 20 undescribed commands and batch-describe them, or move a set of related commands into a group in one step.
+
 ### Preview pane
 
 The right side shows a detail card for the highlighted command: full description, usage, purpose, flag documentation, score breakdown, frequency, last used, source, group, shared set, and tags.
@@ -241,9 +295,29 @@ $ git pu█sh origin main     ← grey ghost text
 
 ### Tab accept mode
 
-By default (`tab_accept = 2`), pressing Tab when a suggestion is showing highlights the ghost text (changes from dim grey to cyan/bold) to indicate it's ready to be accepted. Pressing Tab again accepts it into the buffer. Pressing Esc reverts to dim grey without accepting. This two-step flow gives you a visual confirmation before committing.
+Copa supports two Tab behaviors when a suggestion is showing:
 
-Set `tab_accept = 1` to restore the old behavior where a single Tab directly accepts the suggestion.
+**Menu select** (`tab_accept = 2`, default):
+1. Press **Tab** — ghost text clears, a completion menu opens with the Copa suggestion highlighted at the top, alongside native completions below
+2. Press **Tab** or **Space** — accepts the highlighted item
+3. Press **Escape** — cancels the menu, restores your original text
+4. Use **arrow keys** to navigate if you want a different completion
+
+This gives you a chance to see alternatives before committing. The Copa suggestion is always the first item in the menu.
+
+**Inline accept** (`tab_accept = 1`):
+- Press **Tab** — the suggestion is accepted directly into your command line. One keystroke, done.
+
+### Completion menu navigation
+
+When the completion menu is open (from Tab in `tab_accept = 2` mode or from normal tab completion):
+
+| Key | Action |
+|-----|--------|
+| **Tab** | Accept the highlighted completion |
+| **Space** | Accept the highlighted completion |
+| **Escape** | Cancel — dismiss menu, restore original text |
+| **Arrow keys** | Navigate between completions |
 
 ### Backspace latch
 
@@ -259,8 +333,11 @@ Press **Tab** to unlatch and re-enable suggestions. The next new prompt (Enter)
 enabled = true       # set to false to disable inline suggestions
 min_length = 2       # minimum characters before querying (default: 2)
 tab_accept = 2       # 1 = Tab accepts directly, 2 = Tab opens menu first (default)
+color = 242          # ghost text color (256-color palette, default: 242 mid-grey)
 ```
 
+The `color` value is a [256-color palette](https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit) number. Some useful values: `240` (darker grey), `242` (default mid-grey), `245` (lighter grey), `8` (bright black), `244` (light grey).
+
 Inline suggestions are enabled by default. Set `enabled = false` to disable them entirely (zero performance overhead when disabled).
 
 ## Quick Start
@@ -438,10 +515,20 @@ Copa ships with ready-to-use `.copa` files in the [`examples/`](examples/) direc
 | [`git.copa`](examples/git.copa) | Essential Git commands |
 | [`docker.copa`](examples/docker.copa) | Docker container management |
 | [`python-dev.copa`](examples/python-dev.copa) | Python development workflow |
+| [`npm.copa`](examples/npm.copa) | Node.js package management |
 | [`network.copa`](examples/network.copa) | Network diagnostics |
+| [`curl-http.copa`](examples/curl-http.copa) | HTTP requests and API testing |
+| [`ssh-remote.copa`](examples/ssh-remote.copa) | SSH, SCP, and remote server management |
 | [`adb.copa`](examples/adb.copa) | Android Debug Bridge |
+| [`aws.copa`](examples/aws.copa) | AWS CLI cloud infrastructure |
+| [`terraform.copa`](examples/terraform.copa) | Terraform infrastructure-as-code |
 | [`k8s.copa`](examples/k8s.copa) | Kubernetes cluster management |
+| [`systemd.copa`](examples/systemd.copa) | Linux service management |
 | [`sysadmin.copa`](examples/sysadmin.copa) | System administration |
+| [`process-monitoring.copa`](examples/process-monitoring.copa) | Process management and debugging |
+| [`disk-files.copa`](examples/disk-files.copa) | Disk usage and file management |
+| [`tmux.copa`](examples/tmux.copa) | Terminal multiplexer sessions |
+| [`homebrew.copa`](examples/homebrew.copa) | Homebrew package manager (macOS) |
 
 Load any of them:
 
@@ -560,6 +647,7 @@ group = "ctrl-g"            # assign group (inline modal)
 flags = "ctrl-f"            # edit flags
 filter_group = "ctrl-s"     # scope by group (inline modal)
 cycle_group = "ctrl-n"      # cycle through groups
+select = "ctrl-b"           # enter select mode (bulk operations)
 toggle_header = "ctrl-h"    # show/hide key hints
 
 # Tab completion behavior
@@ -572,6 +660,7 @@ branding = true             # show "Copa history" group header
 enabled = true              # set to false to disable
 min_length = 2              # minimum chars before querying
 tab_accept = 2              # 1 = accept directly, 2 = open menu first
+color = 242                 # ghost text color (256-color palette)
 
 # Composition key behavior (continue vs close)
 # "continue" keys re-open fzf so you can chain another command
@@ -607,6 +696,7 @@ continue = []
 
 | Command | Purpose |
 |---------|---------|
+| `copa setup` | Interactive setup wizard |
 | `copa add "cmd" -d "desc" -g group -f "flag: desc"` | Save a command (with optional flags) |
 | `copa edit ID [-d desc] [-g group] [-f flags] [--pin]` | Edit a command's metadata |
 | `copa remove ID` | Remove a command |
@@ -628,6 +718,7 @@ continue = []
 | `copa share list` | List shared sets |
 | `copa share sync DIR` | Sync .copa files from dir |
 | `copa import FILE [-g group]` | Import commands from markdown |
+| `copa reset` | Wipe database and start fresh (keeps config) |
 | `copa uninstall` | Remove Copa data and show cleanup steps |
 
 ## How Scoring Works

{copa_cli-0.6.0 → copa_cli-0.7.0}/README.md

@@ -16,7 +16,9 @@ Copa tracks the commands you run, ranks them by frequency and recency, and gives
 - **LLM descriptions** — `copa fix --auto` uses Claude or ollama to generate descriptions for undescribed commands
 - **Script protocol** — `#@ Description:` / `#@ Usage:` / `#@ Purpose:` / `#@ Flag:` headers in your scripts are auto-detected by `copa scan` across all `$PATH` directories
 - **Flag documentation** — document command flags with descriptions; flags are searchable, visible in the preview pane, and preserved in `.copa` exports
+- **Inline suggestions** — ghost text appears as you type; Tab accepts or opens a completion menu with the suggestion highlighted
 - **Groups & Ctrl+G** — organize commands by project, device, or workflow; assign groups inline from the fzf palette with Ctrl+G
+- **Bulk operations** — Ctrl+B enters select mode for batch group assignment, batch deletion, or batch LLM description
 - **Sharing & `copa create`** — export/import command sets as `.copa` JSON files; `copa create` scaffolds a `.copa` file from an existing group
 - **Set filtering** — scope list, search, and fzf to a specific shared set with `--set`
 - **MCP server** — expose your commands to Claude Code (or any MCP client)
@@ -55,24 +57,47 @@ pip install -e .
 pip install copa-cli[ollama]
 ```
 
-### Shell integration (required)
+### Setup
 
-Add this line to your `~/.zshrc`:
+Run the interactive setup wizard:
 
 ```bash
-eval "$(copa init zsh)"
+copa setup
 ```
 
-Then restart your shell or run `source ~/.zshrc`. This does three things:
+This walks you through everything:
+1. Checks that **fzf** is installed (tells you how to install if missing)
+2. Creates the Copa database (`~/.copa/copa.db`)
+3. Adds shell integration to your `~/.zshrc` (prompts for confirmation)
+4. Optionally imports your zsh history
+
+Then activate Copa in your current terminal:
+
+```bash
+source ~/.zshrc
+```
+
+### What shell integration does
+
+The `eval "$(copa init zsh)"` line added to your `.zshrc` does three things:
 
 1. **Records every command you run** — a `precmd` hook silently calls `copa _record` in the background after each command, building up frequency and recency data with zero latency impact.
 2. **Replaces Ctrl+R** — the default zsh reverse-history-search is replaced with Copa's fzf-powered command palette (see below).
 3. **Supplements tab completion** — Copa registers as a completer so that any command gets completion candidates from your Copa database. The behavior is configurable (`fallback`, `hybrid`, `always`, or `never`) — see [Tab Completion](#tab-completion).
 
-Initialize the database:
+### Manual setup
+
+If you prefer to set up manually instead of using `copa setup`:
 
 ```bash
-copa _init
+# Add shell integration to ~/.zshrc
+echo 'eval "$(copa init zsh)"' >> ~/.zshrc
+
+# Activate in current terminal
+source ~/.zshrc
+
+# Import your history (optional)
+copa sync
 ```
 
 ## Ctrl+R — fzf Command Palette
@@ -121,11 +146,40 @@ While the fzf palette is open, these keys are available:
 | **Ctrl+N** | Cycle group | Cycles through groups: (all) → group1 → group2 → ... → (all) |
 | **Ctrl+D** | Describe | Generate/edit a description using LLM (with tty-aware input) |
 | **Ctrl+F** | Edit flags | Add flag documentation to the highlighted command |
+| **Ctrl+B** | Select mode | Enter multi-select for bulk operations (see below) |
 | **Ctrl+H** | Toggle header | Show/hide the key hints for more screen space |
 | **ESC** | Cancel/back | In scope/group mode: returns to command list. Otherwise: closes fzf |
 
 Keybindings are configurable via `~/.copa/config.toml`. See [Configuration](#configuration).
 
+### Select mode (bulk operations)
+
+Press **Ctrl+B** from the Ctrl+R palette to enter **select mode**. This opens a new fzf view with multi-select enabled:
+
+- **Tab** toggles selection on individual commands
+- **Ctrl+R** cycles modes (all → frequent → recent) just like the main palette
+- **Enter** confirms your selection and shows the batch action menu
+- **ESC** cancels and returns to your prompt
+
+After selecting commands, Copa shows a batch action menu:
+
+```
+Selected 5 command(s).
+  g = assign group
+  d = delete
+  a = auto-describe (LLM)
+  q = cancel
+Action:
+```
+
+| Action | What it does |
+|--------|-------------|
+| **g** | Assign all selected commands to a group (or clear their group) |
+| **d** | Delete all selected commands (with confirmation) |
+| **a** | Auto-generate descriptions for all selected commands using your configured LLM backend |
+
+This is useful for organizing large command sets — select 20 undescribed commands and batch-describe them, or move a set of related commands into a group in one step.
+
 ### Preview pane
 
 The right side shows a detail card for the highlighted command: full description, usage, purpose, flag documentation, score breakdown, frequency, last used, source, group, shared set, and tags.
@@ -211,9 +265,29 @@ $ git pu█sh origin main     ← grey ghost text
 
 ### Tab accept mode
 
-By default (`tab_accept = 2`), pressing Tab when a suggestion is showing highlights the ghost text (changes from dim grey to cyan/bold) to indicate it's ready to be accepted. Pressing Tab again accepts it into the buffer. Pressing Esc reverts to dim grey without accepting. This two-step flow gives you a visual confirmation before committing.
+Copa supports two Tab behaviors when a suggestion is showing:
 
-Set `tab_accept = 1` to restore the old behavior where a single Tab directly accepts the suggestion.
+**Menu select** (`tab_accept = 2`, default):
+1. Press **Tab** — ghost text clears, a completion menu opens with the Copa suggestion highlighted at the top, alongside native completions below
+2. Press **Tab** or **Space** — accepts the highlighted item
+3. Press **Escape** — cancels the menu, restores your original text
+4. Use **arrow keys** to navigate if you want a different completion
+
+This gives you a chance to see alternatives before committing. The Copa suggestion is always the first item in the menu.
+
+**Inline accept** (`tab_accept = 1`):
+- Press **Tab** — the suggestion is accepted directly into your command line. One keystroke, done.
+
+### Completion menu navigation
+
+When the completion menu is open (from Tab in `tab_accept = 2` mode or from normal tab completion):
+
+| Key | Action |
+|-----|--------|
+| **Tab** | Accept the highlighted completion |
+| **Space** | Accept the highlighted completion |
+| **Escape** | Cancel — dismiss menu, restore original text |
+| **Arrow keys** | Navigate between completions |
 
 ### Backspace latch
 
@@ -229,8 +303,11 @@ Press **Tab** to unlatch and re-enable suggestions. The next new prompt (Enter)
 enabled = true       # set to false to disable inline suggestions
 min_length = 2       # minimum characters before querying (default: 2)
 tab_accept = 2       # 1 = Tab accepts directly, 2 = Tab opens menu first (default)
+color = 242          # ghost text color (256-color palette, default: 242 mid-grey)
 ```
 
+The `color` value is a [256-color palette](https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit) number. Some useful values: `240` (darker grey), `242` (default mid-grey), `245` (lighter grey), `8` (bright black), `244` (light grey).
+
 Inline suggestions are enabled by default. Set `enabled = false` to disable them entirely (zero performance overhead when disabled).
 
 ## Quick Start
@@ -408,10 +485,20 @@ Copa ships with ready-to-use `.copa` files in the [`examples/`](examples/) direc
 | [`git.copa`](examples/git.copa) | Essential Git commands |
 | [`docker.copa`](examples/docker.copa) | Docker container management |
 | [`python-dev.copa`](examples/python-dev.copa) | Python development workflow |
+| [`npm.copa`](examples/npm.copa) | Node.js package management |
 | [`network.copa`](examples/network.copa) | Network diagnostics |
+| [`curl-http.copa`](examples/curl-http.copa) | HTTP requests and API testing |
+| [`ssh-remote.copa`](examples/ssh-remote.copa) | SSH, SCP, and remote server management |
 | [`adb.copa`](examples/adb.copa) | Android Debug Bridge |
+| [`aws.copa`](examples/aws.copa) | AWS CLI cloud infrastructure |
+| [`terraform.copa`](examples/terraform.copa) | Terraform infrastructure-as-code |
 | [`k8s.copa`](examples/k8s.copa) | Kubernetes cluster management |
+| [`systemd.copa`](examples/systemd.copa) | Linux service management |
 | [`sysadmin.copa`](examples/sysadmin.copa) | System administration |
+| [`process-monitoring.copa`](examples/process-monitoring.copa) | Process management and debugging |
+| [`disk-files.copa`](examples/disk-files.copa) | Disk usage and file management |
+| [`tmux.copa`](examples/tmux.copa) | Terminal multiplexer sessions |
+| [`homebrew.copa`](examples/homebrew.copa) | Homebrew package manager (macOS) |
 
 Load any of them:
 
@@ -530,6 +617,7 @@ group = "ctrl-g"            # assign group (inline modal)
 flags = "ctrl-f"            # edit flags
 filter_group = "ctrl-s"     # scope by group (inline modal)
 cycle_group = "ctrl-n"      # cycle through groups
+select = "ctrl-b"           # enter select mode (bulk operations)
 toggle_header = "ctrl-h"    # show/hide key hints
 
 # Tab completion behavior
@@ -542,6 +630,7 @@ branding = true             # show "Copa history" group header
 enabled = true              # set to false to disable
 min_length = 2              # minimum chars before querying
 tab_accept = 2              # 1 = accept directly, 2 = open menu first
+color = 242                 # ghost text color (256-color palette)
 
 # Composition key behavior (continue vs close)
 # "continue" keys re-open fzf so you can chain another command
@@ -577,6 +666,7 @@ continue = []
 
 | Command | Purpose |
 |---------|---------|
+| `copa setup` | Interactive setup wizard |
 | `copa add "cmd" -d "desc" -g group -f "flag: desc"` | Save a command (with optional flags) |
 | `copa edit ID [-d desc] [-g group] [-f flags] [--pin]` | Edit a command's metadata |
 | `copa remove ID` | Remove a command |
@@ -598,6 +688,7 @@ continue = []
 | `copa share list` | List shared sets |
 | `copa share sync DIR` | Sync .copa files from dir |
 | `copa import FILE [-g group]` | Import commands from markdown |
+| `copa reset` | Wipe database and start fresh (keeps config) |
 | `copa uninstall` | Remove Copa data and show cleanup steps |
 
 ## How Scoring Works

{copa_cli-0.6.0 → copa_cli-0.7.0}/copa/cli.py

@@ -40,11 +40,30 @@ def _cmd_to_json(cmd: Command) -> dict:
 # --- Main group ---
 
 
-@click.group()
+@click.group(invoke_without_command=True)
 @click.version_option(package_name="copa-cli")
-def cli():
+@click.pass_context
+def cli(ctx):
     """Copa — Command Palette. Smart command tracking, ranking, and sharing."""
-    pass
+    if ctx.invoked_subcommand is None:
+        # Show help, then a setup hint if needed
+        click.echo(ctx.get_help())
+        _maybe_show_setup_hint()
+
+
+def _maybe_show_setup_hint():
+    """Show a setup hint if Copa is not fully configured."""
+    db_path = Path.home() / ".copa" / "copa.db"
+    zshrc = Path.home() / ".zshrc"
+    has_db = db_path.is_file()
+    has_shell = zshrc.is_file() and "copa init zsh" in zshrc.read_text()
+    has_fzf = shutil.which("fzf") is not None
+
+    if not has_db or not has_shell or not has_fzf:
+        click.echo()
+        hint = click.style("  Tip: ", fg="cyan", bold=True)
+        hint += "run " + click.style("copa setup", bold=True) + " to get started"
+        click.echo(hint)
 
 
 # --- init ---
@@ -60,6 +79,173 @@ def init(shell: str):
     click.echo(zsh_file.read_text())
 
 
+# --- setup ---
+
+_SHELL_INTEGRATION_LINE = 'eval "$(copa init zsh)"'
+
+
+def _write_config_tab_accept(tab_accept: int) -> None:
+    """Write or update tab_accept in ~/.copa/config.toml."""
+    config_path = Path.home() / ".copa" / "config.toml"
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+
+    if config_path.is_file():
+        content = config_path.read_text()
+    else:
+        content = ""
+
+    import re
+
+    if re.search(r"^\[suggest\]", content, re.MULTILINE):
+        # [suggest] section exists — update or add tab_accept
+        if re.search(r"^tab_accept\s*=", content, re.MULTILINE):
+            content = re.sub(
+                r"^tab_accept\s*=\s*\d+",
+                f"tab_accept = {tab_accept}",
+                content,
+                flags=re.MULTILINE,
+            )
+        else:
+            content = re.sub(
+                r"(\[suggest\]\n)",
+                f"\\1tab_accept = {tab_accept}\n",
+                content,
+            )
+    else:
+        # No [suggest] section — append it
+        if content and not content.endswith("\n"):
+            content += "\n"
+        content += f"\n[suggest]\ntab_accept = {tab_accept}\n"
+
+    config_path.write_text(content)
+
+
+@cli.command()
+def setup():
+    """Interactive setup wizard — checks prerequisites and configures Copa."""
+    ok = click.style("OK", fg="green")
+    fixed = click.style("FIXED", fg="green")
+    skip = click.style("SKIP", fg="yellow")
+    fail = click.style("!!", fg="yellow")
+
+    click.echo(click.style("Copa Setup", bold=True))
+    click.echo()
+
+    # 1. Check fzf
+    if shutil.which("fzf"):
+        click.echo(f"  [{ok}] fzf is installed")
+    else:
+        click.echo(f"  [{fail}] fzf is not installed")
+        click.echo("       Copa's Ctrl+R palette requires fzf.")
+        click.echo("       Install: " + click.style("brew install fzf", bold=True) + " (macOS)")
+        click.echo("                " + click.style("sudo apt install fzf", bold=True) + " (Linux)")
+        click.echo()
+
+    # 2. Initialize database
+    db_path = Path.home() / ".copa" / "copa.db"
+    if db_path.is_file():
+        click.echo(f"  [{ok}] Database exists ({db_path})")
+    else:
+        click.echo(f"  [{fixed}] Database created ({db_path})")
+    # Always call get_db to ensure db + tables exist
+    from .cli_common import get_db
+
+    get_db()
+
+    # 3. Shell integration
+    zshrc = Path.home() / ".zshrc"
+    if zshrc.is_file() and _SHELL_INTEGRATION_LINE in zshrc.read_text():
+        click.echo(f"  [{ok}] Shell integration in ~/.zshrc")
+    else:
+        click.echo(f"  [{fail}] Shell integration not found in ~/.zshrc")
+        if click.confirm("       Add it now?", default=True):
+            with open(zshrc, "a") as f:
+                f.write(f"\n# Copa — Command Palette\n{_SHELL_INTEGRATION_LINE}\n")
+            click.echo(f"  [{fixed}] Added to ~/.zshrc")
+        else:
+            click.echo(f"  [{skip}] Skipped — add manually:")
+            click.echo(f"       {_SHELL_INTEGRATION_LINE}")
+
+    # 4. Tab completion style
+    click.echo()
+    click.echo("  Copa shows inline suggestions as you type (ghost text).")
+    click.echo("  How should " + click.style("Tab", bold=True) + " handle suggestions?")
+    click.echo()
+    click.echo("    " + click.style("1", bold=True) + "  " + click.style("Inline accept", fg="cyan"))
+    click.echo("       Tab accepts the suggestion directly into your command line.")
+    click.echo()
+    opt2 = click.style("Menu select", fg="cyan") + click.style(" (default)", dim=True)
+    click.echo("    " + click.style("2", bold=True) + "  " + opt2)
+    click.echo("       Tab opens a completion menu with the suggestion highlighted.")
+    click.echo("       Tab again accepts it. See alternatives before committing.")
+    click.echo()
+    tab_choice = click.prompt(
+        "  Choose tab style",
+        type=click.Choice(["1", "2"]),
+        default="2",
+        show_choices=False,
+    )
+    tab_accept = int(tab_choice)
+    _write_config_tab_accept(tab_accept)
+    label = "Inline accept" if tab_accept == 1 else "Menu select"
+    click.echo(f"  [{fixed}] Tab style: {label}")
+
+    # 5. Sync history
+    click.echo()
+    if click.confirm("  Import commands from your zsh history?", default=True):
+        from .history import sync_history
+
+        db = get_db()
+        added = sync_history(db)
+        click.echo(f"  [{fixed}] Synced {added} commands from history")
+    else:
+        click.echo(f"  [{skip}] Skipped — run " + click.style("copa sync", bold=True) + " later")
+
+    # 6. Done
+    click.echo()
+    click.echo(click.style("  Setup complete!", fg="green", bold=True))
+    click.echo()
+    click.echo("  Next steps:")
+    click.echo("    " + click.style("source ~/.zshrc", bold=True) + "      Activate Copa in this terminal")
+    click.echo("    " + click.style("copa doctor", bold=True) + "          Verify everything is working")
+    click.echo("    Press " + click.style("Ctrl+R", bold=True) + "          Open the command palette")
+    click.echo("    Type a command + " + click.style("Tab", bold=True) + "    See inline suggestions")
+    click.echo()
+
+
+# --- reset ---
+
+
+@cli.command()
+@click.option("-y", "--yes", is_flag=True, help="Skip confirmation prompt.")
+def reset(yes: bool):
+    """Wipe the command database and start fresh. Keeps your config."""
+    db_path = Path.home() / ".copa" / "copa.db"
+
+    if not db_path.is_file():
+        click.echo("No database found — nothing to reset.")
+        return
+
+    from .cli_common import get_db
+
+    db = get_db()
+    stats = db.get_stats()
+    click.echo(f"Database: {db_path}")
+    cmds, grps, sets = stats["total_commands"], stats["total_groups"], stats["shared_sets"]
+    click.echo(f"  {cmds} commands, {grps} groups, {sets} shared sets")
+    click.echo()
+
+    if not yes:
+        click.confirm(click.style("Delete all commands and start fresh?", fg="red"), abort=True)
+
+    db.conn.close()
+    db_path.unlink()
+    # Re-create empty database
+    get_db()
+    click.echo(click.style("Database reset.", fg="green") + " Config preserved.")
+    click.echo("Run " + click.style("copa sync", bold=True) + " to re-import your shell history.")
+
+
 # --- uninstall ---
 
 

{copa_cli-0.6.0 → copa_cli-0.7.0}/copa/config.py

@@ -89,6 +89,7 @@ def load_config(path: Path | None = None) -> dict:
     config["_suggest_enabled"] = True  # default: inline suggestions on
     config["_suggest_min_length"] = 2  # minimum chars before querying
     config["_suggest_tab_accept"] = 2  # 1=direct accept, 2=open menu first
+    config["_suggest_color"] = "242"  # ghost text color (256-color palette)
 
     if path is None:
         path = Path.home() / ".copa" / "config.toml"
@@ -129,10 +130,7 @@ def load_config(path: Path | None = None) -> dict:
         continue_list = composition_section.get("continue")
         if isinstance(continue_list, list):
             # Only keep valid composition action names (those that have suffixes)
-            config["_continue_actions"] = {
-                name for name in continue_list
-                if isinstance(name, str) and name in SUFFIXES
-            }
+            config["_continue_actions"] = {name for name in continue_list if isinstance(name, str) and name in SUFFIXES}
 
     # [suggest] section — inline suggestion settings
     suggest_section = data.get("suggest")
@@ -146,6 +144,9 @@ def load_config(path: Path | None = None) -> dict:
         tab_accept = suggest_section.get("tab_accept")
         if isinstance(tab_accept, int) and tab_accept in (1, 2):
             config["_suggest_tab_accept"] = tab_accept
+        color = suggest_section.get("color")
+        if isinstance(color, (int, str)):
+            config["_suggest_color"] = str(color)
 
     keys_section = data.get("keys")
     if not isinstance(keys_section, dict):
@@ -249,6 +250,7 @@ def emit_zsh_config(config: dict[str, str]) -> str:
     lines.append(f"_COPA_SUGGEST_ENABLED='{'true' if suggest_enabled else 'false'}'")
     lines.append(f"_COPA_SUGGEST_MIN_LENGTH='{config.get('_suggest_min_length', 2)}'")
     lines.append(f"_COPA_SUGGEST_TAB_ACCEPT='{config.get('_suggest_tab_accept', 2)}'")
+    lines.append(f"_COPA_SUGGEST_COLOR='{config.get('_suggest_color', '242')}'")
 
     # Split suffixes into close (fzf exits) and continue (fzf re-opens)
     lines.append("typeset -gA _COPA_CLOSE_SUFFIXES")

{copa_cli-0.6.0 → copa_cli-0.7.0}/copa/copa.zsh

@@ -31,6 +31,7 @@ eval "$(copa _fzf-config 2>/dev/null)" || {
   _COPA_SUGGEST_ENABLED='true'
   _COPA_SUGGEST_MIN_LENGTH='2'
   _COPA_SUGGEST_TAB_ACCEPT='2'
+  _COPA_SUGGEST_COLOR='242'
   _COPA_HEADER=$'Copa | ^R:cycle | ^V:& | ^O:2>&1 | ^X:| | ^T:> | ^A:&& | ^/:quiet | ^H:keys\n^G:grp | ^D:desc | ^F:flag | ^S:scope | ^N:↻grp'
   typeset -gA _COPA_CLOSE_SUFFIXES
   _COPA_CLOSE_SUFFIXES[ctrl-v]=' &'
@@ -341,6 +342,10 @@ _copa_history_complete() {
     zstyle ':completion:*' menu select
     zmodload zsh/complist 2>/dev/null
     bindkey -M menuselect '^I' .accept-line
+    # Escape cancels the menu and restores the original buffer
+    bindkey -M menuselect '^[' send-break
+    # Space accepts the focused completion and closes the menu
+    bindkey -M menuselect ' ' .accept-line
     # Raise threshold before "show all N?" prompt
     LISTMAX=200
     # Copa completion branding: show group description headers
@@ -380,15 +385,19 @@ _copa_suggest_fetch() {
   result=$(copa _suggest "$BUFFER" 2>/dev/null)
   if [[ -n "$result" && "$result" != "$BUFFER" ]]; then
     _COPA_SUGGESTION="$result"
-    POSTDISPLAY="${result:${#BUFFER}}"
-    region_highlight=("P0 ${#POSTDISPLAY} fg=8")
+    local blen=${#BUFFER}
+    local ghost="${result:$blen}"
+    POSTDISPLAY="$ghost"
+    # Use buffer-relative offsets that extend into POSTDISPLAY
+    region_highlight=("$blen $(( blen + ${#ghost} )) fg=${_COPA_SUGGEST_COLOR:-242}")
   fi
 }
 
 # --- Widget wrappers ---
 
-# self-insert: type a character, then fetch suggestion
+# self-insert: type a character, unlatch, then fetch suggestion
 _copa_suggest_self_insert() {
+  _COPA_SUGGEST_LATCHED=0
   zle .self-insert
   _copa_suggest_fetch
 }
@@ -403,8 +412,10 @@ _copa_suggest_backward_delete_char() {
 zle -N backward-delete-char _copa_suggest_backward_delete_char
 
 # Tab: accept suggestion or open completion menu.
-# Uses menu-complete (not expand-or-complete) to enter menu-select
-# mode immediately on the first Tab press.
+# Tab: accept suggestion or open completion menu.
+# Don't call _copa_suggest_fetch after expand-or-complete — menu-select
+# runs asynchronously and fetch would overwrite the display with
+# ghost text.  The self-insert wrapper re-fetches on the next keystroke.
 _copa_suggest_expand_or_complete() {
   if [[ -n "$_COPA_SUGGESTION" ]]; then
     if [[ "$_COPA_SUGGEST_TAB_ACCEPT" == '1' ]]; then
@@ -413,12 +424,14 @@ _copa_suggest_expand_or_complete() {
       CURSOR=${#BUFFER}
       _copa_suggest_clear
     else
-      # tab_accept=2: open completion menu with suggestion hoisted to top
+      # tab_accept=2: open completion menu with suggestion highlighted
+      # Use .expand-or-complete (not menu-complete) so menu-select
+      # highlights the first item in group-order (copa-suggestion),
+      # rather than the first match from the first completer.
       local pending="$_COPA_SUGGESTION"
       _copa_suggest_clear
       _COPA_SUGGEST_PENDING="$pending"
-      zle menu-complete
-      _copa_suggest_fetch  # re-suggest after menu closes
+      zle .expand-or-complete
     fi
     return
   fi
@@ -428,7 +441,6 @@ _copa_suggest_expand_or_complete() {
     return
   fi
   zle menu-complete
-  _copa_suggest_fetch  # re-suggest after menu closes
 }
 zle -N _copa_suggest_expand_or_complete
 bindkey '^I' _copa_suggest_expand_or_complete
@@ -448,10 +460,11 @@ _copa_suggest_forward_char() {
     BUFFER="${BUFFER}${word}"
     CURSOR=${#BUFFER}
     # Update ghost text from existing suggestion (no re-query, no flicker)
-    local remaining="${_COPA_SUGGESTION:${#BUFFER}}"
+    local blen=${#BUFFER}
+    local remaining="${_COPA_SUGGESTION:$blen}"
     if [[ -n "$remaining" ]]; then
       POSTDISPLAY="$remaining"
-      region_highlight=("P0 ${#POSTDISPLAY} fg=8")
+      region_highlight=("$blen $(( blen + ${#remaining} )) fg=${_COPA_SUGGEST_COLOR:-242}")
     else
       # Fully accepted; clear and re-fetch for extended suggestions
       _copa_suggest_clear
@@ -503,12 +516,10 @@ zle -N up-line-or-history _copa_suggest_up_line_or_history
 
 _copa_suggest_down_line_or_history() {
   if [[ -n "$_COPA_SUGGESTION" ]]; then
-    # Suggestion showing: open completion menu with suggestion at top
     local pending="$_COPA_SUGGESTION"
     _copa_suggest_clear
     _COPA_SUGGEST_PENDING="$pending"
-    zle menu-complete
-    _copa_suggest_fetch
+    zle .expand-or-complete
   else
     zle .down-line-or-history
   fi
@@ -523,12 +534,10 @@ zle -N up-line-or-search _copa_suggest_up_line_or_search
 
 _copa_suggest_down_line_or_search() {
   if [[ -n "$_COPA_SUGGESTION" ]]; then
-    # Suggestion showing: open completion menu with suggestion at top
     local pending="$_COPA_SUGGESTION"
     _copa_suggest_clear
     _COPA_SUGGEST_PENDING="$pending"
-    zle menu-complete
-    _copa_suggest_fetch
+    zle .expand-or-complete
   else
     zle .down-line-or-search
   fi

{copa_cli-0.6.0 → copa_cli-0.7.0}/copa_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: copa-cli
-Version: 0.6.0
+Version: 0.7.0
 Summary: Command Palette — smart command tracking, ranking, and sharing for your shell
 Author: Mark Stanford
 License-Expression: MIT
@@ -46,7 +46,9 @@ Copa tracks the commands you run, ranks them by frequency and recency, and gives
 - **LLM descriptions** — `copa fix --auto` uses Claude or ollama to generate descriptions for undescribed commands
 - **Script protocol** — `#@ Description:` / `#@ Usage:` / `#@ Purpose:` / `#@ Flag:` headers in your scripts are auto-detected by `copa scan` across all `$PATH` directories
 - **Flag documentation** — document command flags with descriptions; flags are searchable, visible in the preview pane, and preserved in `.copa` exports
+- **Inline suggestions** — ghost text appears as you type; Tab accepts or opens a completion menu with the suggestion highlighted
 - **Groups & Ctrl+G** — organize commands by project, device, or workflow; assign groups inline from the fzf palette with Ctrl+G
+- **Bulk operations** — Ctrl+B enters select mode for batch group assignment, batch deletion, or batch LLM description
 - **Sharing & `copa create`** — export/import command sets as `.copa` JSON files; `copa create` scaffolds a `.copa` file from an existing group
 - **Set filtering** — scope list, search, and fzf to a specific shared set with `--set`
 - **MCP server** — expose your commands to Claude Code (or any MCP client)
@@ -85,24 +87,47 @@ pip install -e .
 pip install copa-cli[ollama]
 ```
 
-### Shell integration (required)
+### Setup
 
-Add this line to your `~/.zshrc`:
+Run the interactive setup wizard:
 
 ```bash
-eval "$(copa init zsh)"
+copa setup
 ```
 
-Then restart your shell or run `source ~/.zshrc`. This does three things:
+This walks you through everything:
+1. Checks that **fzf** is installed (tells you how to install if missing)
+2. Creates the Copa database (`~/.copa/copa.db`)
+3. Adds shell integration to your `~/.zshrc` (prompts for confirmation)
+4. Optionally imports your zsh history
+
+Then activate Copa in your current terminal:
+
+```bash
+source ~/.zshrc
+```
+
+### What shell integration does
+
+The `eval "$(copa init zsh)"` line added to your `.zshrc` does three things:
 
 1. **Records every command you run** — a `precmd` hook silently calls `copa _record` in the background after each command, building up frequency and recency data with zero latency impact.
 2. **Replaces Ctrl+R** — the default zsh reverse-history-search is replaced with Copa's fzf-powered command palette (see below).
 3. **Supplements tab completion** — Copa registers as a completer so that any command gets completion candidates from your Copa database. The behavior is configurable (`fallback`, `hybrid`, `always`, or `never`) — see [Tab Completion](#tab-completion).
 
-Initialize the database:
+### Manual setup
+
+If you prefer to set up manually instead of using `copa setup`:
 
 ```bash
-copa _init
+# Add shell integration to ~/.zshrc
+echo 'eval "$(copa init zsh)"' >> ~/.zshrc
+
+# Activate in current terminal
+source ~/.zshrc
+
+# Import your history (optional)
+copa sync
 ```
 
 ## Ctrl+R — fzf Command Palette
@@ -151,11 +176,40 @@ While the fzf palette is open, these keys are available:
 | **Ctrl+N** | Cycle group | Cycles through groups: (all) → group1 → group2 → ... → (all) |
 | **Ctrl+D** | Describe | Generate/edit a description using LLM (with tty-aware input) |
 | **Ctrl+F** | Edit flags | Add flag documentation to the highlighted command |
+| **Ctrl+B** | Select mode | Enter multi-select for bulk operations (see below) |
 | **Ctrl+H** | Toggle header | Show/hide the key hints for more screen space |
 | **ESC** | Cancel/back | In scope/group mode: returns to command list. Otherwise: closes fzf |
 
 Keybindings are configurable via `~/.copa/config.toml`. See [Configuration](#configuration).
 
+### Select mode (bulk operations)
+
+Press **Ctrl+B** from the Ctrl+R palette to enter **select mode**. This opens a new fzf view with multi-select enabled:
+
+- **Tab** toggles selection on individual commands
+- **Ctrl+R** cycles modes (all → frequent → recent) just like the main palette
+- **Enter** confirms your selection and shows the batch action menu
+- **ESC** cancels and returns to your prompt
+
+After selecting commands, Copa shows a batch action menu:
+
+```
+Selected 5 command(s).
+  g = assign group
+  d = delete
+  a = auto-describe (LLM)
+  q = cancel
+Action:
+```
+
+| Action | What it does |
+|--------|-------------|
+| **g** | Assign all selected commands to a group (or clear their group) |
+| **d** | Delete all selected commands (with confirmation) |
+| **a** | Auto-generate descriptions for all selected commands using your configured LLM backend |
+
+This is useful for organizing large command sets — select 20 undescribed commands and batch-describe them, or move a set of related commands into a group in one step.
+
 ### Preview pane
 
 The right side shows a detail card for the highlighted command: full description, usage, purpose, flag documentation, score breakdown, frequency, last used, source, group, shared set, and tags.
@@ -241,9 +295,29 @@ $ git pu█sh origin main     ← grey ghost text
 
 ### Tab accept mode
 
-By default (`tab_accept = 2`), pressing Tab when a suggestion is showing highlights the ghost text (changes from dim grey to cyan/bold) to indicate it's ready to be accepted. Pressing Tab again accepts it into the buffer. Pressing Esc reverts to dim grey without accepting. This two-step flow gives you a visual confirmation before committing.
+Copa supports two Tab behaviors when a suggestion is showing:
 
-Set `tab_accept = 1` to restore the old behavior where a single Tab directly accepts the suggestion.
+**Menu select** (`tab_accept = 2`, default):
+1. Press **Tab** — ghost text clears, a completion menu opens with the Copa suggestion highlighted at the top, alongside native completions below
+2. Press **Tab** or **Space** — accepts the highlighted item
+3. Press **Escape** — cancels the menu, restores your original text
+4. Use **arrow keys** to navigate if you want a different completion
+
+This gives you a chance to see alternatives before committing. The Copa suggestion is always the first item in the menu.
+
+**Inline accept** (`tab_accept = 1`):
+- Press **Tab** — the suggestion is accepted directly into your command line. One keystroke, done.
+
+### Completion menu navigation
+
+When the completion menu is open (from Tab in `tab_accept = 2` mode or from normal tab completion):
+
+| Key | Action |
+|-----|--------|
+| **Tab** | Accept the highlighted completion |
+| **Space** | Accept the highlighted completion |
+| **Escape** | Cancel — dismiss menu, restore original text |
+| **Arrow keys** | Navigate between completions |
 
 ### Backspace latch
 
@@ -259,8 +333,11 @@ Press **Tab** to unlatch and re-enable suggestions. The next new prompt (Enter)
 enabled = true       # set to false to disable inline suggestions
 min_length = 2       # minimum characters before querying (default: 2)
 tab_accept = 2       # 1 = Tab accepts directly, 2 = Tab opens menu first (default)
+color = 242          # ghost text color (256-color palette, default: 242 mid-grey)
 ```
 
+The `color` value is a [256-color palette](https://en.wikipedia.org/wiki/ANSI_escape_code#8-bit) number. Some useful values: `240` (darker grey), `242` (default mid-grey), `245` (lighter grey), `8` (bright black), `244` (light grey).
+
 Inline suggestions are enabled by default. Set `enabled = false` to disable them entirely (zero performance overhead when disabled).
 
 ## Quick Start
@@ -438,10 +515,20 @@ Copa ships with ready-to-use `.copa` files in the [`examples/`](examples/) direc
 | [`git.copa`](examples/git.copa) | Essential Git commands |
 | [`docker.copa`](examples/docker.copa) | Docker container management |
 | [`python-dev.copa`](examples/python-dev.copa) | Python development workflow |
+| [`npm.copa`](examples/npm.copa) | Node.js package management |
 | [`network.copa`](examples/network.copa) | Network diagnostics |
+| [`curl-http.copa`](examples/curl-http.copa) | HTTP requests and API testing |
+| [`ssh-remote.copa`](examples/ssh-remote.copa) | SSH, SCP, and remote server management |
 | [`adb.copa`](examples/adb.copa) | Android Debug Bridge |
+| [`aws.copa`](examples/aws.copa) | AWS CLI cloud infrastructure |
+| [`terraform.copa`](examples/terraform.copa) | Terraform infrastructure-as-code |
 | [`k8s.copa`](examples/k8s.copa) | Kubernetes cluster management |
+| [`systemd.copa`](examples/systemd.copa) | Linux service management |
 | [`sysadmin.copa`](examples/sysadmin.copa) | System administration |
+| [`process-monitoring.copa`](examples/process-monitoring.copa) | Process management and debugging |
+| [`disk-files.copa`](examples/disk-files.copa) | Disk usage and file management |
+| [`tmux.copa`](examples/tmux.copa) | Terminal multiplexer sessions |
+| [`homebrew.copa`](examples/homebrew.copa) | Homebrew package manager (macOS) |
 
 Load any of them:
 
@@ -560,6 +647,7 @@ group = "ctrl-g"            # assign group (inline modal)
 flags = "ctrl-f"            # edit flags
 filter_group = "ctrl-s"     # scope by group (inline modal)
 cycle_group = "ctrl-n"      # cycle through groups
+select = "ctrl-b"           # enter select mode (bulk operations)
 toggle_header = "ctrl-h"    # show/hide key hints
 
 # Tab completion behavior
@@ -572,6 +660,7 @@ branding = true             # show "Copa history" group header
 enabled = true              # set to false to disable
 min_length = 2              # minimum chars before querying
 tab_accept = 2              # 1 = accept directly, 2 = open menu first
+color = 242                 # ghost text color (256-color palette)
 
 # Composition key behavior (continue vs close)
 # "continue" keys re-open fzf so you can chain another command
@@ -607,6 +696,7 @@ continue = []
 
 | Command | Purpose |
 |---------|---------|
+| `copa setup` | Interactive setup wizard |
 | `copa add "cmd" -d "desc" -g group -f "flag: desc"` | Save a command (with optional flags) |
 | `copa edit ID [-d desc] [-g group] [-f flags] [--pin]` | Edit a command's metadata |
 | `copa remove ID` | Remove a command |
@@ -628,6 +718,7 @@ continue = []
 | `copa share list` | List shared sets |
 | `copa share sync DIR` | Sync .copa files from dir |
 | `copa import FILE [-g group]` | Import commands from markdown |
+| `copa reset` | Wipe database and start fresh (keeps config) |
 | `copa uninstall` | Remove Copa data and show cleanup steps |
 
 ## How Scoring Works

{copa_cli-0.6.0 → copa_cli-0.7.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "copa-cli"
-version = "0.6.0"
+version = "0.7.0"
 description = "Command Palette — smart command tracking, ranking, and sharing for your shell"
 readme = "README.md"
 license = "MIT"

{copa_cli-0.6.0 → copa_cli-0.7.0}/tests/test_modal.py

@@ -242,7 +242,7 @@ class TestCompositionConfig:
 
     def test_load_config_empty_continue_list(self, tmp_path):
         config_file = tmp_path / "config.toml"
-        config_file.write_text('[composition]\ncontinue = []\n')
+        config_file.write_text("[composition]\ncontinue = []\n")
         config = load_config(config_file)
         assert config["_continue_actions"] == set()
 
@@ -292,7 +292,7 @@ class TestCompositionConfig:
 
     def test_empty_continue_all_keys_close(self, tmp_path):
         config_file = tmp_path / "config.toml"
-        config_file.write_text('[composition]\ncontinue = []\n')
+        config_file.write_text("[composition]\ncontinue = []\n")
         config = load_config(config_file)
         output = emit_zsh_config(config)
         # All 6 keys should be in _COPA_EXPECT
@@ -395,7 +395,7 @@ class TestLayoutConfig:
 
     def test_load_config_integer_height(self, tmp_path):
         config_file = tmp_path / "config.toml"
-        config_file.write_text('[layout]\nheight = 100\n')
+        config_file.write_text("[layout]\nheight = 100\n")
         config = load_config(config_file)
         assert config["_height"] == "100"
 
@@ -838,12 +838,16 @@ class TestSuggestBackspaceLatch:
 class TestTabAcceptConfig:
     """Test [suggest] tab_accept config option."""
 
-    def test_default_tab_accept_is_2(self):
-        config = load_config()
+    def test_default_tab_accept_is_2(self, tmp_path):
+        config_file = tmp_path / "config.toml"
+        config_file.write_text("")
+        config = load_config(config_file)
         assert config["_suggest_tab_accept"] == 2
 
-    def test_emit_zsh_config_has_tab_accept(self):
-        config = load_config()
+    def test_emit_zsh_config_has_tab_accept(self, tmp_path):
+        config_file = tmp_path / "config.toml"
+        config_file.write_text("")
+        config = load_config(config_file)
         output = emit_zsh_config(config)
         assert "_COPA_SUGGEST_TAB_ACCEPT='2'" in output
 
@@ -912,10 +916,13 @@ class TestTabAcceptZsh:
     def test_packaged_zsh_tab_checks_accept_mode(self):
         content = self._read_zsh("copa/copa.zsh")
         start = content.index("_copa_suggest_expand_or_complete()")
-        func_block = content[start : start + 800]
+        func_block = content[start : start + 1000]
         # Tab widget checks tab_accept internally for mode 1 vs 2
         assert "_COPA_SUGGEST_TAB_ACCEPT" in func_block
         assert "_copa_suggest_clear" in func_block
+        # Mode 2 uses expand-or-complete so menu-select highlights by group-order
+        assert "zle .expand-or-complete" in func_block
+        # Non-suggestion fallback still uses menu-complete
         assert "zle menu-complete" in func_block
         # Mode 2 sets pending and opens completion menu
         assert "_COPA_SUGGEST_PENDING" in func_block
@@ -925,9 +932,10 @@ class TestTabAcceptZsh:
     def test_root_zsh_tab_checks_accept_mode(self):
         content = self._read_zsh("copa.zsh")
         start = content.index("_copa_suggest_expand_or_complete()")
-        func_block = content[start : start + 800]
+        func_block = content[start : start + 1000]
         assert "_COPA_SUGGEST_TAB_ACCEPT" in func_block
         assert "_copa_suggest_clear" in func_block
+        assert "zle .expand-or-complete" in func_block
         assert "zle menu-complete" in func_block
         assert "_COPA_SUGGEST_PENDING" in func_block
         assert "bindkey '^I' _copa_suggest_expand_or_complete" in content
@@ -940,7 +948,7 @@ class TestTabAcceptZsh:
         assert ".down-line-or-history" in func_block
         # Down arrow with suggestion: hoists to completion menu
         assert "_COPA_SUGGEST_PENDING" in func_block
-        assert "zle menu-complete" in func_block
+        assert "zle .expand-or-complete" in func_block
 
     def test_root_zsh_down_opens_menu_or_history(self):
         content = self._read_zsh("copa.zsh")
@@ -949,7 +957,7 @@ class TestTabAcceptZsh:
         assert "_copa_suggest_clear" in func_block
         assert ".down-line-or-history" in func_block
         assert "_COPA_SUGGEST_PENDING" in func_block
-        assert "zle menu-complete" in func_block
+        assert "zle .expand-or-complete" in func_block
 
     def test_packaged_zsh_clear_resets_pending(self):
         content = self._read_zsh("copa/copa.zsh")