copa-cli 0.2.0__tar.gz → 0.2.1__tar.gz

{copa_cli-0.2.0/copa_cli.egg-info → copa_cli-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: copa-cli
-Version: 0.2.0
+Version: 0.2.1
 Summary: Command Palette — smart command tracking, ranking, and sharing for your shell
 Author: Mark Stanford
 License-Expression: MIT
@@ -87,7 +87,7 @@ pip install copa-cli[ollama]
 Add this line to your `~/.zshrc`:
 
 ```bash
-source /path/to/copa/copa.zsh
+eval "$(copa init zsh)"
 ```
 
 Then restart your shell or run `source ~/.zshrc`. This does three things:

{copa_cli-0.2.0 → copa_cli-0.2.1}/README.md

@@ -57,7 +57,7 @@ pip install copa-cli[ollama]
 Add this line to your `~/.zshrc`:
 
 ```bash
-source /path/to/copa/copa.zsh
+eval "$(copa init zsh)"
 ```
 
 Then restart your shell or run `source ~/.zshrc`. This does three things:

{copa_cli-0.2.0 → copa_cli-0.2.1}/copa/cli.py

@@ -20,6 +20,64 @@ def cli():
     pass
 
 
+# --- init ---
+
+
+@cli.command()
+@click.argument("shell", type=click.Choice(["zsh"]))
+def init(shell: str):
+    """Print shell integration code. Add to your .zshrc: eval "$(copa init zsh)" """
+    from importlib.resources import files
+
+    zsh_file = files("copa").joinpath("copa.zsh")
+    click.echo(zsh_file.read_text())
+
+
+# --- uninstall ---
+
+
+@cli.command()
+@click.option("-y", "--yes", is_flag=True, help="Skip confirmation prompt.")
+def uninstall(yes: bool):
+    """Remove Copa data and show cleanup instructions."""
+    import shutil
+
+    copa_dir = Path.home() / ".copa"
+
+    # Inventory what exists
+    items: list[tuple[str, Path]] = []
+    if copa_dir.is_dir():
+        db_path = copa_dir / "copa.db"
+        config_path = copa_dir / "config.toml"
+        if db_path.is_file():
+            items.append(("database", db_path))
+        if config_path.is_file():
+            items.append(("config", config_path))
+        # Count any other files (.copa exports, etc.)
+        other = [f for f in copa_dir.iterdir() if f not in (db_path, config_path)]
+        for f in other:
+            items.append(("file", f))
+
+    if not items:
+        click.echo("No Copa data found (~/.copa/ does not exist or is empty).")
+    else:
+        click.echo("Copa data directory: ~/.copa/")
+        for kind, path in items:
+            size = path.stat().st_size if path.is_file() else 0
+            label = f"{size:,} bytes" if size else "directory"
+            click.echo(f"  {path.name} ({kind}, {label})")
+
+        if not yes:
+            click.confirm("\nDelete ~/.copa/ and all its contents?", abort=True)
+
+        shutil.rmtree(copa_dir)
+        click.echo(click.style("Deleted ~/.copa/", fg="green"))
+
+    click.echo("\nTo finish uninstalling:")
+    click.echo('  1. Remove this line from your ~/.zshrc:  eval "$(copa init zsh)"')
+    click.echo("  2. Run:  pip uninstall copa-cli")
+
+
 # --- add ---
 
 

copa_cli-0.2.1/copa/copa.zsh

@@ -0,0 +1,156 @@
+# Copa — shell integration for zsh
+# Add to your .zshrc:  eval "$(copa init zsh)"
+#
+# What this does:
+#   1. Records every command you run (precmd hook, background, zero latency)
+#   2. Replaces Ctrl+R with an fzf command palette that searches across
+#      command text AND descriptions — not just raw history
+#   3. Ctrl+R cycles modes inside fzf: all → frequent → recent → all
+#   4. Composition keys append shell operators (|, &&, &, etc.) to selected commands
+
+# --- Load keybinding config (runs once at shell startup) ---
+eval "$(copa _fzf-config 2>/dev/null)" || {
+  # Fallback defaults if copa _fzf-config fails
+  _COPA_EXPECT='ctrl-v,ctrl-o,ctrl-x,ctrl-t,ctrl-a,ctrl-/'
+  _COPA_DESCRIBE_KEY='ctrl-d'
+  _COPA_GROUP_KEY='ctrl-g'
+  _COPA_FLAGS_KEY='ctrl-f'
+  _COPA_FILTER_GROUP_KEY='ctrl-s'
+  _COPA_CYCLE_GROUP_KEY='ctrl-n'
+  _COPA_COMPLETION_BRANDING='true'
+  _COPA_HEADER='Copa | ^R:cycle | ^V:& | ^O:2>&1 | ^X:| | ^T:> | ^A:&& | ^/:quiet | ^G:grp | ^D:desc | ^F:flag | ^S:scope | ^N:↻grp'
+  typeset -gA _COPA_SUFFIXES
+  _COPA_SUFFIXES[ctrl-v]=' &'
+  _COPA_SUFFIXES[ctrl-o]=' 2>&1'
+  _COPA_SUFFIXES[ctrl-x]=' | '
+  _COPA_SUFFIXES[ctrl-t]=' > '
+  _COPA_SUFFIXES[ctrl-a]=' && '
+  _COPA_SUFFIXES[ctrl-/]=' 2>/dev/null'
+}
+
+# --- precmd hook: record last command ---
+_copa_precmd() {
+  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" &!
+  fi
+}
+
+# Add to precmd hooks (avoid duplicates)
+autoload -Uz add-zsh-hook
+add-zsh-hook precmd _copa_precmd
+
+# --- Ctrl+R: fzf-powered command palette ---
+# Replaces default zsh reverse-search. fzf searches all visible fields:
+# command text, description, group badges, shared-set names, and frequency.
+# Selected command is placed into the prompt without executing.
+# Composition keys (configured via copa _fzf-config) append shell operators.
+# Requires fzf: brew install fzf
+_copa_fzf_widget() {
+  if ! command -v fzf &>/dev/null; then
+    zle -M "Copa: fzf not found. Install with: brew install fzf"
+    return 1
+  fi
+
+  local mode="all"
+  local output
+  local copa_bin="${commands[copa]:-copa}"
+
+  output=$("$copa_bin" fzf-list --mode "$mode" | \
+    fzf --ansi \
+        --delimiter '┃' \
+        --with-nth '2..3' \
+        --preview "$copa_bin _preview {1}" \
+        --preview-window 'right:40%:wrap' \
+        --header "$_COPA_HEADER" \
+        --prompt 'copa> ' \
+        --height '80%' \
+        --layout reverse \
+        --expect "$_COPA_EXPECT" \
+        --bind "${_COPA_DESCRIBE_KEY}:execute($copa_bin describe {1})+refresh-preview" \
+        --bind "${_COPA_GROUP_KEY}:execute($copa_bin _set-group {1})+reload($copa_bin fzf-list)+refresh-preview" \
+        --bind "${_COPA_FLAGS_KEY}:execute($copa_bin _set-flags {1})+reload($copa_bin fzf-list)+refresh-preview" \
+        --bind "${_COPA_FILTER_GROUP_KEY}:transform:
+          group=\$(${copa_bin} _list-groups | fzf --height 40% --layout reverse --prompt 'group> ' --header 'Select group (ESC=cancel)');
+          if [[ \$group == '(all)' ]]; then
+            echo \"reload(${copa_bin} fzf-list --mode all)+change-prompt(copa> )\"
+          elif [[ -n \$group ]]; then
+            echo \"reload(${copa_bin} fzf-list --mode group --group \$group)+change-prompt(copa [\$group]> )\"
+          fi" \
+        --bind "${_COPA_CYCLE_GROUP_KEY}:transform:
+          cur_group='(all)';
+          if [[ \$FZF_PROMPT =~ 'copa \\[(.+)\\]> ' ]]; then
+            cur_group=\"\${match[1]}\";
+          fi;
+          next=\$(${copa_bin} _next-group \"\$cur_group\");
+          if [[ \$next == '(all)' ]]; then
+            echo \"reload(${copa_bin} fzf-list --mode all)+change-prompt(copa> )\";
+          else
+            echo \"reload(${copa_bin} fzf-list --mode group --group \$next)+change-prompt(copa [\$next]> )\";
+          fi" \
+        --bind 'ctrl-r:transform:
+          if [[ $FZF_PROMPT == "copa> " ]]; then
+            echo "reload('"$copa_bin"' fzf-list --mode frequent)+change-prompt(frequent> )"
+          elif [[ $FZF_PROMPT == "frequent> " ]]; then
+            echo "reload('"$copa_bin"' fzf-list --mode recent)+change-prompt(recent> )"
+          else
+            echo "reload('"$copa_bin"' fzf-list --mode all)+change-prompt(copa> )"
+          fi' \
+        --bind 'enter:accept' \
+  )
+
+  if [[ -n "$output" ]]; then
+    # --expect output: line 1 = key pressed (empty for Enter), line 2+ = selected item
+    local key selected cmd suffix
+    key=$(echo "$output" | head -1)
+    selected=$(echo "$output" | tail -n +2)
+
+    if [[ -n "$selected" ]]; then
+      cmd=$(echo "$selected" | cut -d'┃' -f2 | sed 's/^ *//;s/ *$//')
+      suffix="${_COPA_SUFFIXES[$key]}"
+      LBUFFER="${cmd}${suffix}"
+    fi
+  fi
+
+  zle reset-prompt
+}
+
+zle -N _copa_fzf_widget
+bindkey '^R' _copa_fzf_widget
+
+# --- Tab completion ---
+# Ensure zsh completion system is available, then register Copa completions.
+if ! (( $+functions[compdef] )); then
+  autoload -Uz compinit && compinit -i -C
+fi
+eval "$(copa completion zsh)"
+
+# --- Supplemental tab completion from Copa database ---
+# Registers as a fallback completer so that any command (e.g. adb <TAB>)
+# gets completion candidates from Copa's command history.
+_copa_history_complete() {
+    # Only provide Copa completions when primary completers found nothing
+    (( compstate[nmatches] > 0 )) && return
+    # Skip empty tokens (bare <TAB> with no partial input)
+    [[ -z "${words[CURRENT]}" ]] && return
+    # Skip internal copa commands
+    [[ "${words[CURRENT]}" == _copa_* ]] && return
+    local -a results
+    results=("${(@f)$(copa _complete-word "${(@)words[1,CURRENT]}" 2>/dev/null)}")
+    (( ${#results} )) && compadd -V 'copa-history' -o nosort -- "${results[@]}"
+}
+
+# Append to existing completers without clobbering user config
+() {
+    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
+    fi
+    # Copa completion branding: show "Copa history" header when branding is enabled
+    if [[ "$_COPA_COMPLETION_BRANDING" != 'false' ]]; then
+        zstyle ':completion:*:*:*:copa-history' group-header '%F{magenta}-- Copa history --%f'
+    fi
+}

{copa_cli-0.2.0 → copa_cli-0.2.1/copa_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: copa-cli
-Version: 0.2.0
+Version: 0.2.1
 Summary: Command Palette — smart command tracking, ranking, and sharing for your shell
 Author: Mark Stanford
 License-Expression: MIT
@@ -87,7 +87,7 @@ pip install copa-cli[ollama]
 Add this line to your `~/.zshrc`:
 
 ```bash
-source /path/to/copa/copa.zsh
+eval "$(copa init zsh)"
 ```
 
 Then restart your shell or run `source ~/.zshrc`. This does three things:

{copa_cli-0.2.0 → copa_cli-0.2.1}/copa_cli.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ copa/cli_internal.py
 copa/cli_llm.py
 copa/cli_share.py
 copa/config.py
+copa/copa.zsh
 copa/db.py
 copa/evolve.py
 copa/fzf.py

{copa_cli-0.2.0 → copa_cli-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "copa-cli"
-version = "0.2.0"
+version = "0.2.1"
 description = "Command Palette — smart command tracking, ranking, and sharing for your shell"
 readme = "README.md"
 license = "MIT"
@@ -42,6 +42,9 @@ copa = "copa.cli:cli"
 [tool.setuptools.packages.find]
 include = ["copa*"]
 
+[tool.setuptools.package-data]
+copa = ["copa.zsh"]
+
 [tool.ruff]
 target-version = "py312"
 line-length = 120