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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: copa-cli
-Version: 0.6.0
+Version: 0.7.1
 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.
@@ -231,8 +285,8 @@ $ git pu█sh origin main     ← grey ghost text
 |-----|-------------------|---------------|
 | Type chars | Insert char, re-fetch suggestion | Insert char, fetch suggestion |
 | Backspace | Delete char, **latch** (suppress suggestions) | Delete char normally |
-| **Tab** | `tab_accept=1`: accept full suggestion. `tab_accept=2` (default): first Tab highlights suggestion (cyan), second Tab accepts | If latched: unlatch + re-fetch suggestion. Else: normal tab completion |
-| **Down** | Highlight suggestion (enter confirming state) | History navigation |
+| **Tab** | `tab_accept=1`: accept full suggestion. `tab_accept=2` (default): open completion menu with suggestion highlighted at top, native completions below | If latched: unlatch + re-fetch suggestion. Else: normal tab completion |
+| **Down** | Open completion menu with suggestion highlighted at top | History navigation |
 | **Right arrow** | Accept one word, re-fetch | Move cursor right |
 | Enter | Clear suggestion, execute | Execute |
 | Esc | Dismiss suggestion | Normal Esc |
@@ -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.1}/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.
@@ -201,8 +255,8 @@ $ git pu█sh origin main     ← grey ghost text
 |-----|-------------------|---------------|
 | Type chars | Insert char, re-fetch suggestion | Insert char, fetch suggestion |
 | Backspace | Delete char, **latch** (suppress suggestions) | Delete char normally |
-| **Tab** | `tab_accept=1`: accept full suggestion. `tab_accept=2` (default): first Tab highlights suggestion (cyan), second Tab accepts | If latched: unlatch + re-fetch suggestion. Else: normal tab completion |
-| **Down** | Highlight suggestion (enter confirming state) | History navigation |
+| **Tab** | `tab_accept=1`: accept full suggestion. `tab_accept=2` (default): open completion menu with suggestion highlighted at top, native completions below | If latched: unlatch + re-fetch suggestion. Else: normal tab completion |
+| **Down** | Open completion menu with suggestion highlighted at top | History navigation |
 | **Right arrow** | Accept one word, re-fetch | Move cursor right |
 | Enter | Clear suggestion, execute | Execute |
 | Esc | Dismiss suggestion | Normal Esc |
@@ -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.1}/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.1}/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")