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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: copa-cli
-Version: 0.7.0
+Version: 0.8.0
 Summary: Command Palette — smart command tracking, ranking, and sharing for your shell
 Author: Mark Stanford
 License-Expression: MIT
@@ -36,6 +36,8 @@ Dynamic: license-file
 
 Copa tracks the commands you run, ranks them by frequency and recency, and gives you instant fuzzy search via fzf. Think of it as a smart, searchable, shareable upgrade to shell history.
 
+![Copa Setup](demos/01-setup.gif)
+
 ## Features
 
 - **Smart ranking** — commands scored by `2*log(1+freq) + 8*0.5^(age/3d)`, so frequent *and* recent commands float to the top
@@ -134,6 +136,8 @@ copa sync
 
 Once shell integration is sourced, pressing **Ctrl+R** opens an fzf-powered command palette instead of the default zsh reverse search. This is Copa's primary interface.
 
+![Ctrl+R Palette](demos/04-ctrl-r-palette.gif)
+
 ### What you see
 
 Copa pipes every tracked command into fzf with aligned columns:
@@ -173,6 +177,8 @@ While the fzf palette is open, these keys are available:
 | **Ctrl+/** | Append `2>/dev/null` | Suppress stderr |
 | **Ctrl+S** | Scope by group | Opens inline group list — Enter filters to that group, ESC returns to all |
 | **Ctrl+G** | Assign group | Opens inline group list — Enter assigns the group to the highlighted command |
+
+![Groups and Scoping](demos/05-groups-and-scoping.gif)
 | **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 |
@@ -184,6 +190,8 @@ Keybindings are configurable via `~/.copa/config.toml`. See [Configuration](#con
 
 ### Select mode (bulk operations)
 
+![Bulk Operations](demos/06-bulk-operations.gif)
+
 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
@@ -220,10 +228,14 @@ Selecting a command places it directly into your shell prompt (without executing
 
 ## Tab Completion
 
+![Tab Menu Select](demos/03-tab-menu-select.gif)
+
 Copa supplements zsh's built-in tab completion for **any** command — not just Copa's own CLI. Once `copa.zsh` is sourced, Copa registers as a completer in zsh's completion system.
 
 ### Completion modes
 
+![Completion Modes](demos/10-completion-modes.gif)
+
 Copa supports four completion modes, configured via `~/.copa/config.toml`:
 
 | Mode | Behavior |
@@ -269,6 +281,10 @@ Copa's own CLI completions (`copa li<TAB>` → `list`) continue to work as befor
 
 ## Inline Suggestions (Ghost Text)
 
+| Tab Mode 1 (direct accept) | Tab Mode 2 (menu select, default) |
+|---|---|
+| ![Tab Mode 1](demos/02a-suggestions-tab-mode1.gif) | ![Tab Mode 2](demos/02b-suggestions-tab-mode2.gif) |
+
 Copa shows grey ghost text after your cursor as you type — the best matching command from your database, ranked by frequency and recency. This works like fish shell's autosuggestions or zsh-autosuggestions, with zero plugin dependencies.
 
 ### How it works
@@ -285,9 +301,10 @@ $ 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 |
+| **Cmd+Right / End** | Accept full suggestion | Move to end of line |
 | Enter | Clear suggestion, execute | Execute |
 | Esc | Dismiss suggestion | Normal Esc |
 | Up | Clear suggestion, navigate history | History navigation |
@@ -441,6 +458,8 @@ copa describe 42
 
 Generates a description for a specific command by ID. Same accept/edit flow as `fix --auto`.
 
+![Flags and Describe](demos/09-flags-and-describe.gif)
+
 ## Script Metadata Protocol
 
 Copa recognizes `#@` headers in script files (checked in the first 50 lines):
@@ -488,6 +507,8 @@ copa scan --dir ~/bin   # scan a specific directory
 
 ## Sharing
 
+![Sharing](demos/07-sharing.gif)
+
 Export a group as a `.copa` file:
 
 ```bash
@@ -622,8 +643,16 @@ Available MCP tools:
 - `copa_get_stats` — usage statistics
 - `copa_add_command` — add a command
 - `copa_update_description` — update a description
+- `copa_delete_command` — delete a command by ID
+- `copa_set_group` — set or change a command's group
+- `copa_update_flags` — update flag documentation for a command
+- `copa_pin_command` — pin or unpin a command
 - `copa_create_group` — create a group with commands
 - `copa_bulk_add` — bulk add commands
+- `copa_share_load` — load a .copa file as a shared set
+- `copa_share_list` — list all loaded shared sets
+- `copa_share_remove` — remove a shared set
+- `copa_export_group` — export a group as a .copa file
 
 ## Configuration
 
@@ -671,6 +700,8 @@ continue = ["pipe", "chain", "redirect"]  # default: |, &&, > re-open fzf
 
 ### Composition key behavior
 
+![Composition](demos/08-composition.gif)
+
 When you press a composition key (like Ctrl-A for `&&`), Copa can either **close fzf** (placing the command + operator in your prompt) or **continue** (appending the operator and re-opening fzf so you can select the next command to chain).
 
 By default, "connector" operators re-open fzf:
@@ -692,6 +723,10 @@ To revert to the old behavior (all keys close immediately), set:
 continue = []
 ```
 
+## End-to-End Workflow
+
+![Workflow](demos/11-workflow.gif)
+
 ## CLI Reference
 
 | Command | Purpose |

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

@@ -6,6 +6,8 @@
 
 Copa tracks the commands you run, ranks them by frequency and recency, and gives you instant fuzzy search via fzf. Think of it as a smart, searchable, shareable upgrade to shell history.
 
+![Copa Setup](demos/01-setup.gif)
+
 ## Features
 
 - **Smart ranking** — commands scored by `2*log(1+freq) + 8*0.5^(age/3d)`, so frequent *and* recent commands float to the top
@@ -104,6 +106,8 @@ copa sync
 
 Once shell integration is sourced, pressing **Ctrl+R** opens an fzf-powered command palette instead of the default zsh reverse search. This is Copa's primary interface.
 
+![Ctrl+R Palette](demos/04-ctrl-r-palette.gif)
+
 ### What you see
 
 Copa pipes every tracked command into fzf with aligned columns:
@@ -143,6 +147,8 @@ While the fzf palette is open, these keys are available:
 | **Ctrl+/** | Append `2>/dev/null` | Suppress stderr |
 | **Ctrl+S** | Scope by group | Opens inline group list — Enter filters to that group, ESC returns to all |
 | **Ctrl+G** | Assign group | Opens inline group list — Enter assigns the group to the highlighted command |
+
+![Groups and Scoping](demos/05-groups-and-scoping.gif)
 | **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 |
@@ -154,6 +160,8 @@ Keybindings are configurable via `~/.copa/config.toml`. See [Configuration](#con
 
 ### Select mode (bulk operations)
 
+![Bulk Operations](demos/06-bulk-operations.gif)
+
 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
@@ -190,10 +198,14 @@ Selecting a command places it directly into your shell prompt (without executing
 
 ## Tab Completion
 
+![Tab Menu Select](demos/03-tab-menu-select.gif)
+
 Copa supplements zsh's built-in tab completion for **any** command — not just Copa's own CLI. Once `copa.zsh` is sourced, Copa registers as a completer in zsh's completion system.
 
 ### Completion modes
 
+![Completion Modes](demos/10-completion-modes.gif)
+
 Copa supports four completion modes, configured via `~/.copa/config.toml`:
 
 | Mode | Behavior |
@@ -239,6 +251,10 @@ Copa's own CLI completions (`copa li<TAB>` → `list`) continue to work as befor
 
 ## Inline Suggestions (Ghost Text)
 
+| Tab Mode 1 (direct accept) | Tab Mode 2 (menu select, default) |
+|---|---|
+| ![Tab Mode 1](demos/02a-suggestions-tab-mode1.gif) | ![Tab Mode 2](demos/02b-suggestions-tab-mode2.gif) |
+
 Copa shows grey ghost text after your cursor as you type — the best matching command from your database, ranked by frequency and recency. This works like fish shell's autosuggestions or zsh-autosuggestions, with zero plugin dependencies.
 
 ### How it works
@@ -255,9 +271,10 @@ $ 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 |
+| **Cmd+Right / End** | Accept full suggestion | Move to end of line |
 | Enter | Clear suggestion, execute | Execute |
 | Esc | Dismiss suggestion | Normal Esc |
 | Up | Clear suggestion, navigate history | History navigation |
@@ -411,6 +428,8 @@ copa describe 42
 
 Generates a description for a specific command by ID. Same accept/edit flow as `fix --auto`.
 
+![Flags and Describe](demos/09-flags-and-describe.gif)
+
 ## Script Metadata Protocol
 
 Copa recognizes `#@` headers in script files (checked in the first 50 lines):
@@ -458,6 +477,8 @@ copa scan --dir ~/bin   # scan a specific directory
 
 ## Sharing
 
+![Sharing](demos/07-sharing.gif)
+
 Export a group as a `.copa` file:
 
 ```bash
@@ -592,8 +613,16 @@ Available MCP tools:
 - `copa_get_stats` — usage statistics
 - `copa_add_command` — add a command
 - `copa_update_description` — update a description
+- `copa_delete_command` — delete a command by ID
+- `copa_set_group` — set or change a command's group
+- `copa_update_flags` — update flag documentation for a command
+- `copa_pin_command` — pin or unpin a command
 - `copa_create_group` — create a group with commands
 - `copa_bulk_add` — bulk add commands
+- `copa_share_load` — load a .copa file as a shared set
+- `copa_share_list` — list all loaded shared sets
+- `copa_share_remove` — remove a shared set
+- `copa_export_group` — export a group as a .copa file
 
 ## Configuration
 
@@ -641,6 +670,8 @@ continue = ["pipe", "chain", "redirect"]  # default: |, &&, > re-open fzf
 
 ### Composition key behavior
 
+![Composition](demos/08-composition.gif)
+
 When you press a composition key (like Ctrl-A for `&&`), Copa can either **close fzf** (placing the command + operator in your prompt) or **continue** (appending the operator and re-opening fzf so you can select the next command to chain).
 
 By default, "connector" operators re-open fzf:
@@ -662,6 +693,10 @@ To revert to the old behavior (all keys close immediately), set:
 continue = []
 ```
 
+## End-to-End Workflow
+
+![Workflow](demos/11-workflow.gif)
+
 ## CLI Reference
 
 | Command | Purpose |

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

@@ -45,11 +45,12 @@ eval "$(copa _fzf-config 2>/dev/null)" || {
 
 # --- precmd hook: record last command ---
 _copa_precmd() {
+  (( $+commands[copa] )) || return
   local last_cmd
   last_cmd="$(fc -ln -1 2>/dev/null)"
   last_cmd="${last_cmd## }"  # strip leading space
   if [[ -n "$last_cmd" && "$last_cmd" != _copa_* ]]; then
-    copa _record "$last_cmd" &!
+    copa _record "$last_cmd" &! 2>/dev/null
   fi
 }
 
@@ -280,7 +281,7 @@ bindkey '^R' _copa_fzf_widget
 if ! (( $+functions[compdef] )); then
   autoload -Uz compinit && compinit -i -C
 fi
-eval "$(copa completion zsh)"
+eval "$(copa completion zsh 2>/dev/null)"
 
 # --- Supplemental tab completion from Copa database ---
 # Mode is controlled by _COPA_COMPLETION_MODE (set via copa _fzf-config):
@@ -290,19 +291,25 @@ eval "$(copa completion zsh)"
 #   never    — disable Copa tab completion entirely
 if [[ "$_COPA_COMPLETION_MODE" != 'never' ]]; then
 
-_copa_history_complete() {
-    # Hoist pending inline suggestion as a completion candidate
-    if [[ -n "$_COPA_SUGGEST_PENDING" ]]; then
-        local pending="$_COPA_SUGGEST_PENDING"
-        _COPA_SUGGEST_PENDING=""
-        local cur_word="${words[CURRENT]}"
-        local prefix_len=$(( ${#LBUFFER} - ${#cur_word} ))
-        local insert_text="${pending:$prefix_len}"
-        if [[ -n "$insert_text" ]]; then
-            compadd -U -Q -V 'copa-suggestion' -X 'SUGGESTED' -o nosort -- "$insert_text"
-        fi
-        compstate[list]='list force'
+# Suggestion completer: runs FIRST so menu-complete highlights the Copa
+# suggestion before native completions.  No-op when nothing is pending.
+# Always returns 1 so the chain continues to _complete and _copa_history_complete;
+# compadd matches persist across completers regardless of return value.
+_copa_suggestion_complete() {
+    [[ -z "$_COPA_SUGGEST_PENDING" ]] && return 1
+    local pending="$_COPA_SUGGEST_PENDING"
+    _COPA_SUGGEST_PENDING=""
+    local cur_word="${words[CURRENT]}"
+    local prefix_len=$(( ${#LBUFFER} - ${#cur_word} ))
+    local insert_text="${pending:$prefix_len}"
+    if [[ -n "$insert_text" ]]; then
+        compadd -U -Q -V 'copa-suggestion' -X 'SUGGESTED' -o nosort -- "$insert_text"
     fi
+    compstate[list]='list force'
+    return 1  # don't stop chain — let _complete and _copa_history_complete also run
+}
+
+_copa_history_complete() {
     # In fallback mode, only show when native completers found nothing
     if [[ "$_COPA_COMPLETION_MODE" == 'fallback' ]]; then
         (( compstate[nmatches] > 0 )) && return
@@ -327,12 +334,14 @@ _copa_history_complete() {
     fi
 }
 
-# Append to existing completers without clobbering user config
+# Append to existing completers without clobbering user config.
+# _copa_suggestion_complete runs first so menu-complete highlights
+# the Copa suggestion; _copa_history_complete runs last for history matches.
 () {
     local -a cur
     zstyle -g cur ':completion:*' completer 2>/dev/null
     if (( ! ${cur[(Ie)_copa_history_complete]} )); then
-        zstyle ':completion:*' completer ${cur:-_complete} _copa_history_complete
+        zstyle ':completion:*' completer _copa_suggestion_complete ${cur:-_complete} _copa_history_complete _files
     fi
     # Enable group separation so Copa results appear as a distinct section
     zstyle ':completion:*' group-name ''
@@ -341,11 +350,13 @@ _copa_history_complete() {
     # Interactive menu with highlighting; Tab accepts the focused item
     zstyle ':completion:*' menu select
     zmodload zsh/complist 2>/dev/null
-    bindkey -M menuselect '^I' .accept-line
+    bindkey -M menuselect '^I' accept-search
+    bindkey -M menuselect '^M' accept-search
+    bindkey -M menuselect '^J' accept-search
     # 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
+    bindkey -M menuselect ' ' accept-search
     # Raise threshold before "show all N?" prompt
     LISTMAX=200
     # Copa completion branding: show group description headers
@@ -412,8 +423,7 @@ _copa_suggest_backward_delete_char() {
 zle -N backward-delete-char _copa_suggest_backward_delete_char
 
 # Tab: accept suggestion or open completion menu.
-# Tab: accept suggestion or open completion menu.
-# Don't call _copa_suggest_fetch after expand-or-complete — menu-select
+# Don't call _copa_suggest_fetch after menu-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() {
@@ -424,14 +434,15 @@ _copa_suggest_expand_or_complete() {
       CURSOR=${#BUFFER}
       _copa_suggest_clear
     else
-      # 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.
+      # tab_accept=2: open completion menu with suggestion highlighted.
+      # menu-complete enters menu-select mode reliably (unlike
+      # .expand-or-complete which bypasses menu-select).  With
+      # group-order copa-suggestion copa-history, menu-select cycles
+      # in display order, so the Copa suggestion is highlighted first.
       local pending="$_COPA_SUGGESTION"
       _copa_suggest_clear
       _COPA_SUGGEST_PENDING="$pending"
-      zle .expand-or-complete
+      zle menu-complete
     fi
     return
   fi
@@ -487,6 +498,20 @@ _copa_suggest_forward_word() {
 }
 zle -N forward-word _copa_suggest_forward_word
 
+# end-of-line (Cmd+Right / End): accept full suggestion if ghost text showing
+_copa_suggest_end_of_line() {
+  if [[ -n "$POSTDISPLAY" && -n "$_COPA_SUGGESTION" && $CURSOR -eq ${#BUFFER} ]]; then
+    BUFFER="$_COPA_SUGGESTION"
+    CURSOR=${#BUFFER}
+    _copa_suggest_clear
+    _COPA_SUGGEST_LATCHED=0
+    _copa_suggest_fetch
+  else
+    zle .end-of-line
+  fi
+}
+zle -N end-of-line _copa_suggest_end_of_line
+
 # accept-line (Enter): clear suggestion + latch, then execute
 _copa_suggest_accept_line() {
   _copa_suggest_clear
@@ -519,7 +544,7 @@ _copa_suggest_down_line_or_history() {
     local pending="$_COPA_SUGGESTION"
     _copa_suggest_clear
     _COPA_SUGGEST_PENDING="$pending"
-    zle .expand-or-complete
+    zle menu-complete
   else
     zle .down-line-or-history
   fi
@@ -537,7 +562,7 @@ _copa_suggest_down_line_or_search() {
     local pending="$_COPA_SUGGESTION"
     _copa_suggest_clear
     _COPA_SUGGEST_PENDING="$pending"
-    zle .expand-or-complete
+    zle menu-complete
   else
     zle .down-line-or-search
   fi

{copa_cli-0.7.0 → copa_cli-0.8.0}/copa/db.py

@@ -3,13 +3,14 @@
 from __future__ import annotations
 
 import json
+import os
 import sqlite3
 import time
 from pathlib import Path
 
 from .models import Command, SharedSet
 
-DEFAULT_DB_PATH = Path.home() / ".copa" / "copa.db"
+DEFAULT_DB_PATH = Path(os.environ.get("COPA_DB", Path.home() / ".copa" / "copa.db"))
 
 SCHEMA_SQL = """\
 CREATE TABLE IF NOT EXISTS commands (

{copa_cli-0.7.0 → copa_cli-0.8.0}/copa/mcp_server.py

@@ -2,6 +2,9 @@
 
 from __future__ import annotations
 
+import json
+from pathlib import Path
+
 from .db import Database
 from .scoring import rank_commands
 
@@ -105,6 +108,49 @@ def create_mcp_server():
         db.update_description(command_id, description)
         return f"Updated [{command_id}] {cmd.command}: {description}"
 
+    @mcp.tool()
+    def copa_delete_command(command_id: int) -> str:
+        """Delete a command from Copa by its ID."""
+        cmd = db.get_command(command_id)
+        if not cmd:
+            return f"Command {command_id} not found."
+        db.remove_command(command_id)
+        return f"Deleted [{command_id}] {cmd.command}"
+
+    @mcp.tool()
+    def copa_set_group(command_id: int, group: str | None = None) -> str:
+        """Set or change the group of a command. Pass group=None to remove from group."""
+        cmd = db.get_command(command_id)
+        if not cmd:
+            return f"Command {command_id} not found."
+        db.update_group(command_id, group)
+        if group:
+            return f"Moved [{command_id}] {cmd.command} to group '{group}'"
+        return f"Removed [{command_id}] {cmd.command} from its group"
+
+    @mcp.tool()
+    def copa_update_flags(command_id: int, flags: dict[str, str]) -> str:
+        """Update the flags/options documentation for a command.
+
+        flags is a dict mapping flag name to description, e.g. {"-v": "Verbose output"}.
+        """
+        cmd = db.get_command(command_id)
+        if not cmd:
+            return f"Command {command_id} not found."
+        db.update_flags(command_id, flags)
+        flag_list = ", ".join(f"{k}: {v}" for k, v in flags.items())
+        return f"Updated flags for [{command_id}] {cmd.command}: {flag_list}"
+
+    @mcp.tool()
+    def copa_pin_command(command_id: int, pinned: bool = True) -> str:
+        """Pin or unpin a command. Pinned commands always appear at the top."""
+        cmd = db.get_command(command_id)
+        if not cmd:
+            return f"Command {command_id} not found."
+        db.pin_command(command_id, pinned)
+        action = "Pinned" if pinned else "Unpinned"
+        return f"{action} [{command_id}] {cmd.command}"
+
     @mcp.tool()
     def copa_create_group(name: str, commands: list[dict] | None = None) -> str:
         """Create a Copa group and optionally add commands to it.
@@ -146,6 +192,65 @@ def create_mcp_server():
             count += 1
         return f"Added {count} commands."
 
+    @mcp.tool()
+    def copa_share_load(file_path: str) -> str:
+        """Load a .copa file into Copa as a shared set.
+
+        The file_path should be a path to a .copa JSON file.
+        """
+        from .sharing import import_shared_set, load_copa_file, resolve_copa_path
+
+        resolved = resolve_copa_path(file_path)
+        if not resolved or not resolved.is_file():
+            return f"File not found: {file_path}"
+        copa_file = load_copa_file(resolved)
+        count = import_shared_set(db, copa_file, source_path=str(resolved))
+        return f"Loaded shared set '{copa_file.name}' with {count} commands from {resolved}"
+
+    @mcp.tool()
+    def copa_share_list() -> str:
+        """List all loaded shared sets."""
+        sets = db.get_shared_sets()
+        if not sets:
+            return "No shared sets loaded."
+        lines = []
+        for ss in sets:
+            parts = [f"- {ss.name}"]
+            if ss.description:
+                parts[0] += f": {ss.description}"
+            if ss.author:
+                parts.append(f"  author: {ss.author}")
+            if ss.source_path:
+                parts.append(f"  source: {ss.source_path}")
+            lines.append("\n".join(parts))
+        return "\n".join(lines)
+
+    @mcp.tool()
+    def copa_share_remove(name: str) -> str:
+        """Remove a shared set and its commands from Copa."""
+        sets = db.get_shared_sets()
+        if not any(ss.name == name for ss in sets):
+            return f"Shared set '{name}' not found."
+        db.remove_shared_set(name)
+        return f"Removed shared set '{name}'"
+
+    @mcp.tool()
+    def copa_export_group(group: str, output_path: str | None = None) -> str:
+        """Export a Copa group as a .copa JSON file.
+
+        If output_path is not provided, returns the JSON content directly.
+        """
+        from .sharing import export_group
+
+        copa_file = export_group(db, group)
+        if not copa_file.commands:
+            return f"Group '{group}' has no commands to export."
+        content = json.dumps(copa_file.to_dict(), indent=2)
+        if output_path:
+            Path(output_path).write_text(content)
+            return f"Exported group '{group}' ({len(copa_file.commands)} commands) to {output_path}"
+        return content
+
     return mcp
 
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: copa-cli
-Version: 0.7.0
+Version: 0.8.0
 Summary: Command Palette — smart command tracking, ranking, and sharing for your shell
 Author: Mark Stanford
 License-Expression: MIT
@@ -36,6 +36,8 @@ Dynamic: license-file
 
 Copa tracks the commands you run, ranks them by frequency and recency, and gives you instant fuzzy search via fzf. Think of it as a smart, searchable, shareable upgrade to shell history.
 
+![Copa Setup](demos/01-setup.gif)
+
 ## Features
 
 - **Smart ranking** — commands scored by `2*log(1+freq) + 8*0.5^(age/3d)`, so frequent *and* recent commands float to the top
@@ -134,6 +136,8 @@ copa sync
 
 Once shell integration is sourced, pressing **Ctrl+R** opens an fzf-powered command palette instead of the default zsh reverse search. This is Copa's primary interface.
 
+![Ctrl+R Palette](demos/04-ctrl-r-palette.gif)
+
 ### What you see
 
 Copa pipes every tracked command into fzf with aligned columns:
@@ -173,6 +177,8 @@ While the fzf palette is open, these keys are available:
 | **Ctrl+/** | Append `2>/dev/null` | Suppress stderr |
 | **Ctrl+S** | Scope by group | Opens inline group list — Enter filters to that group, ESC returns to all |
 | **Ctrl+G** | Assign group | Opens inline group list — Enter assigns the group to the highlighted command |
+
+![Groups and Scoping](demos/05-groups-and-scoping.gif)
 | **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 |
@@ -184,6 +190,8 @@ Keybindings are configurable via `~/.copa/config.toml`. See [Configuration](#con
 
 ### Select mode (bulk operations)
 
+![Bulk Operations](demos/06-bulk-operations.gif)
+
 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
@@ -220,10 +228,14 @@ Selecting a command places it directly into your shell prompt (without executing
 
 ## Tab Completion
 
+![Tab Menu Select](demos/03-tab-menu-select.gif)
+
 Copa supplements zsh's built-in tab completion for **any** command — not just Copa's own CLI. Once `copa.zsh` is sourced, Copa registers as a completer in zsh's completion system.
 
 ### Completion modes
 
+![Completion Modes](demos/10-completion-modes.gif)
+
 Copa supports four completion modes, configured via `~/.copa/config.toml`:
 
 | Mode | Behavior |
@@ -269,6 +281,10 @@ Copa's own CLI completions (`copa li<TAB>` → `list`) continue to work as befor
 
 ## Inline Suggestions (Ghost Text)
 
+| Tab Mode 1 (direct accept) | Tab Mode 2 (menu select, default) |
+|---|---|
+| ![Tab Mode 1](demos/02a-suggestions-tab-mode1.gif) | ![Tab Mode 2](demos/02b-suggestions-tab-mode2.gif) |
+
 Copa shows grey ghost text after your cursor as you type — the best matching command from your database, ranked by frequency and recency. This works like fish shell's autosuggestions or zsh-autosuggestions, with zero plugin dependencies.
 
 ### How it works
@@ -285,9 +301,10 @@ $ 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 |
+| **Cmd+Right / End** | Accept full suggestion | Move to end of line |
 | Enter | Clear suggestion, execute | Execute |
 | Esc | Dismiss suggestion | Normal Esc |
 | Up | Clear suggestion, navigate history | History navigation |
@@ -441,6 +458,8 @@ copa describe 42
 
 Generates a description for a specific command by ID. Same accept/edit flow as `fix --auto`.
 
+![Flags and Describe](demos/09-flags-and-describe.gif)
+
 ## Script Metadata Protocol
 
 Copa recognizes `#@` headers in script files (checked in the first 50 lines):
@@ -488,6 +507,8 @@ copa scan --dir ~/bin   # scan a specific directory
 
 ## Sharing
 
+![Sharing](demos/07-sharing.gif)
+
 Export a group as a `.copa` file:
 
 ```bash
@@ -622,8 +643,16 @@ Available MCP tools:
 - `copa_get_stats` — usage statistics
 - `copa_add_command` — add a command
 - `copa_update_description` — update a description
+- `copa_delete_command` — delete a command by ID
+- `copa_set_group` — set or change a command's group
+- `copa_update_flags` — update flag documentation for a command
+- `copa_pin_command` — pin or unpin a command
 - `copa_create_group` — create a group with commands
 - `copa_bulk_add` — bulk add commands
+- `copa_share_load` — load a .copa file as a shared set
+- `copa_share_list` — list all loaded shared sets
+- `copa_share_remove` — remove a shared set
+- `copa_export_group` — export a group as a .copa file
 
 ## Configuration
 
@@ -671,6 +700,8 @@ continue = ["pipe", "chain", "redirect"]  # default: |, &&, > re-open fzf
 
 ### Composition key behavior
 
+![Composition](demos/08-composition.gif)
+
 When you press a composition key (like Ctrl-A for `&&`), Copa can either **close fzf** (placing the command + operator in your prompt) or **continue** (appending the operator and re-opening fzf so you can select the next command to chain).
 
 By default, "connector" operators re-open fzf:
@@ -692,6 +723,10 @@ To revert to the old behavior (all keys close immediately), set:
 continue = []
 ```
 
+## End-to-End Workflow
+
+![Workflow](demos/11-workflow.gif)
+
 ## CLI Reference
 
 | Command | Purpose |

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

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

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

@@ -819,7 +819,7 @@ class TestSuggestBackspaceLatch:
     def test_packaged_zsh_tab_unlatches(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]
         assert "_COPA_SUGGEST_LATCHED=0" in func_block
 
     def test_packaged_zsh_backward_kill_word_latches(self):
@@ -920,9 +920,7 @@ class TestTabAcceptZsh:
         # 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
+        # Mode 2 uses menu-complete to reliably enter menu-select mode
         assert "zle menu-complete" in func_block
         # Mode 2 sets pending and opens completion menu
         assert "_COPA_SUGGEST_PENDING" in func_block
@@ -935,7 +933,6 @@ class TestTabAcceptZsh:
         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
@@ -948,7 +945,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 .expand-or-complete" in func_block
+        assert "zle menu-complete" in func_block
 
     def test_root_zsh_down_opens_menu_or_history(self):
         content = self._read_zsh("copa.zsh")
@@ -957,7 +954,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 .expand-or-complete" in func_block
+        assert "zle menu-complete" in func_block
 
     def test_packaged_zsh_clear_resets_pending(self):
         content = self._read_zsh("copa/copa.zsh")
@@ -1014,33 +1011,31 @@ class TestTabAcceptZsh:
         after_latch = func_block[latch_idx:]
         assert "_copa_suggest_fetch" in after_latch
 
-    def test_packaged_zsh_history_complete_hoists_suggestion(self):
+    def test_packaged_zsh_suggestion_completer_exists(self):
         content = self._read_zsh("copa/copa.zsh")
-        start = content.index("_copa_history_complete()")
-        func_block = content[start : start + 800]
+        start = content.index("_copa_suggestion_complete()")
+        func_block = content[start : start + 500]
         assert "_COPA_SUGGEST_PENDING" in func_block
         assert "compadd -U -Q -V 'copa-suggestion'" in func_block
+        assert "compstate[list]='list force'" in func_block
 
-    def test_root_zsh_history_complete_hoists_suggestion(self):
+    def test_root_zsh_suggestion_completer_exists(self):
         content = self._read_zsh("copa.zsh")
-        start = content.index("_copa_history_complete()")
-        func_block = content[start : start + 800]
+        start = content.index("_copa_suggestion_complete()")
+        func_block = content[start : start + 500]
         assert "_COPA_SUGGEST_PENDING" in func_block
         assert "compadd -U -Q -V 'copa-suggestion'" in func_block
+        assert "compstate[list]='list force'" in func_block
 
-    def test_packaged_zsh_forces_completion_list(self):
-        """compstate[list] forces the completion list to display."""
+    def test_packaged_zsh_suggestion_completer_runs_first(self):
+        """_copa_suggestion_complete must be before _complete in completer chain."""
         content = self._read_zsh("copa/copa.zsh")
-        start = content.index("_copa_history_complete()")
-        func_block = content[start : start + 800]
-        assert "compstate[list]='list force'" in func_block
+        assert "_copa_suggestion_complete ${cur:-_complete} _copa_history_complete" in content
 
-    def test_root_zsh_forces_completion_list(self):
-        """compstate[list] forces the completion list to display."""
+    def test_root_zsh_suggestion_completer_runs_first(self):
+        """_copa_suggestion_complete must be before _complete in completer chain."""
         content = self._read_zsh("copa.zsh")
-        start = content.index("_copa_history_complete()")
-        func_block = content[start : start + 800]
-        assert "compstate[list]='list force'" in func_block
+        assert "_copa_suggestion_complete ${cur:-_complete} _copa_history_complete" in content
 
     def test_packaged_zsh_has_suggestion_branding(self):
         content = self._read_zsh("copa/copa.zsh")
@@ -1051,3 +1046,39 @@ class TestTabAcceptZsh:
         content = self._read_zsh("copa.zsh")
         assert "copa-suggestion" in content
         assert "-X 'SUGGESTED'" in content
+
+    def test_packaged_zsh_menuselect_uses_accept_search(self):
+        content = self._read_zsh("copa/copa.zsh")
+        assert "bindkey -M menuselect '^I' accept-search" in content
+        assert "bindkey -M menuselect '^M' accept-search" in content
+        assert ".accept-line" not in content or "zle .accept-line" in content
+
+    def test_root_zsh_menuselect_uses_accept_search(self):
+        content = self._read_zsh("copa.zsh")
+        assert "bindkey -M menuselect '^I' accept-search" in content
+        assert "bindkey -M menuselect '^M' accept-search" in content
+        assert ".accept-line" not in content or "zle .accept-line" in content
+
+    def test_packaged_zsh_end_of_line_accepts_full(self):
+        content = self._read_zsh("copa/copa.zsh")
+        start = content.index("_copa_suggest_end_of_line()")
+        func_block = content[start : start + 400]
+        assert "_COPA_SUGGESTION" in func_block
+        assert 'BUFFER="$_COPA_SUGGESTION"' in func_block
+        assert "zle .end-of-line" in func_block
+
+    def test_root_zsh_end_of_line_accepts_full(self):
+        content = self._read_zsh("copa.zsh")
+        start = content.index("_copa_suggest_end_of_line()")
+        func_block = content[start : start + 400]
+        assert "_COPA_SUGGESTION" in func_block
+        assert 'BUFFER="$_COPA_SUGGESTION"' in func_block
+        assert "zle .end-of-line" in func_block
+
+    def test_packaged_zsh_end_of_line_registered(self):
+        content = self._read_zsh("copa/copa.zsh")
+        assert "zle -N end-of-line _copa_suggest_end_of_line" in content
+
+    def test_root_zsh_end_of_line_registered(self):
+        content = self._read_zsh("copa.zsh")
+        assert "zle -N end-of-line _copa_suggest_end_of_line" in content