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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: copa-cli
-Version: 0.7.1
+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
@@ -288,6 +304,7 @@ $ git pu█sh origin main     ← grey ghost text
 | **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.1 → 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
@@ -258,6 +274,7 @@ $ git pu█sh origin main     ← grey ghost text
 | **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.1 → 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):
@@ -340,7 +341,7 @@ _copa_history_complete() {
     local -a cur
     zstyle -g cur ':completion:*' completer 2>/dev/null
     if (( ! ${cur[(Ie)_copa_history_complete]} )); then
-        zstyle ':completion:*' completer _copa_suggestion_complete ${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 ''
@@ -349,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
@@ -495,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

{copa_cli-0.7.1 → 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.1 → 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.1 → 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.1
+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
@@ -288,6 +304,7 @@ $ git pu█sh origin main     ← grey ghost text
 | **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.1 → copa_cli-0.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "copa-cli"
-version = "0.7.1"
+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.1 → copa_cli-0.8.0}/tests/test_modal.py

@@ -1046,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