rubber-ducky 1.5.0__py3-none-any.whl → 1.5.1__py3-none-any.whl

rubber_ducky-1.5.1.dist-info/METADATA

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: rubber-ducky
+Version: 1.5.1
+Summary: Quick CLI do-it-all tool. Use natural language to spit out bash commands
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: fastapi>=0.115.11
+Requires-Dist: ollama>=0.6.0
+Requires-Dist: openai>=1.60.2
+Requires-Dist: prompt-toolkit>=3.0.48
+Requires-Dist: rich>=13.9.4
+Requires-Dist: termcolor>=2.5.0
+Dynamic: license-file
+
+# Rubber Ducky
+
+Rubber Ducky is an inline terminal companion that turns natural language prompts into runnable shell commands. Paste multi-line context, get a suggested command, and run it without leaving your terminal.
+
+## Quick Start
+
+| Action | Command |
+| --- | --- |
+| Install globally | `uv tool install rubber-ducky` |
+| Run once | `uvx rubber-ducky -- --help` |
+| Local install | `uv pip install rubber-ducky` |
+
+Requirements:
+- [Ollama](https://ollama.com) running locally or use cloud models
+- Model available via Ollama (default: `glm-4.7:cloud`)
+
+## Usage
+
+```
+ducky                      # interactive inline session
+ducky --directory src      # preload code from a directory
+ducky --model qwen3        # use a different Ollama model
+ducky --local              # use local models with qwen3 default
+```
+
+Both `ducky` and `rubber-ducky` executables map to the same CLI, so `uvx rubber-ducky -- <args>` works as well.
+
+### Inline Session (default)
+
+Launching `ducky` with no arguments opens the inline interface:
+- **Enter** submits; **Ctrl+J** inserts a newline (helpful when crafting multi-line prompts). Hitting **Enter on an empty prompt** reruns the latest suggested command; if none exists yet, it explains the most recent shell output.
+- **Ctrl+R** re-runs the last suggested command.
+- **Ctrl+S** copies the last suggested command to clipboard.
+- Prefix any line with **`!`** (e.g., `!ls -la`) to run a shell command immediately.
+- Arrow keys browse prompt history, backed by `~/.ducky/prompt_history`.
+- Every prompt, assistant response, and executed command is logged to `~/.ducky/conversation.log`.
+- Press **Ctrl+D** on an empty line to exit.
+- Non-interactive runs such as `cat prompt.txt | ducky` print one response (and suggested command) before exiting; if a TTY is available you'll be asked whether to run the suggested command immediately.
+- If `prompt_toolkit` is unavailable in your environment, Rubber Ducky falls back to a basic input loop (no history or shortcuts); install `prompt-toolkit>=3.0.48` to unlock the richer UI.
+
+`ducky --directory <path>` streams the contents of the provided directory to the assistant the next time you submit a prompt (the directory is read once at startup).
+
+### Model Management
+
+Rubber Ducky now supports easy switching between local and cloud models:
+- **`/model`** - Interactive model selection between local and cloud models
+- **`/local`** - List and select from local models (localhost:11434)
+- **`/cloud`** - List and select from cloud models (ollama.com)
+- Last used model is automatically saved and loaded on startup
+- Type **`esc`** during model selection to cancel
+
+### Additional Commands
+
+- **`/help`** - Show all available commands and shortcuts
+- **`/crumbs`** - List all saved crumb shortcuts
+- **`/crumb <name>`** - Save the last AI-suggested command as a named crumb
+- **`/crumb add <name> <command>`** - Manually add a crumb with a specific command
+- **`/crumb del <name>`** - Delete a saved crumb
+- **`<crumb-name>`** - Invoke a saved crumb (displays info and executes the command)
+- **`/clear`** or **`/reset`** - Clear conversation history
+- **`/run`** or **`:run`** - Re-run the last suggested command
+
+## Crumbs
+
+Crumbs are saved command shortcuts that let you quickly reuse AI-generated bash commands without regenerating them each time. Perfect for frequently-used workflows or complex commands.
+
+### Saving Crumbs
+
+When the AI suggests a command that you want to reuse:
+
+1. Get a command suggestion from ducky
+2. Save it immediately: `/crumb <name>`
+3. Example:
+   ```
+   >> How do I list all Ollama processes?
+   ...
+   Suggested command: ps aux | grep -i ollama | grep -v grep
+   >> /crumb ols
+   Saved crumb 'ols'!
+   Generating explanation...
+   Explanation added: Finds and lists all running Ollama processes.
+   ```
+
+The crumb is saved with:
+- The original command
+- An AI-generated one-line explanation
+- A timestamp
+
+### Invoking Crumbs
+
+Simply type the crumb name in the REPL or use it as a CLI argument:
+
+**In REPL:**
+```
+>> ols
+
+Crumb: ols
+Explanation: Finds and lists all running Ollama processes.
+Command: ps aux | grep -i ollama | grep -v grep
+
+$ ps aux | grep -i ollama | grep -v grep
+user123  12345  0.3  1.2  456789  98765 ?  Sl  10:00   0:05 ollama serve
+```
+
+**From CLI:**
+```bash
+ducky ols              # Runs the saved crumb and displays output
+```
+
+When you invoke a crumb:
+1. It displays the crumb name, explanation, and command
+2. Automatically executes the command
+3. Shows the output
+
+### Managing Crumbs
+
+**List all crumbs:**
+```bash
+>> /crumbs
+```
+
+Output:
+```
+Saved Crumbs
+=============
+ols      | Finds and lists all running Ollama processes. | ps aux | grep -i ollama | grep -v grep
+test     | Run tests and build project                  | pytest && python build.py
+deploy   | Deploy to production                         | docker push app:latest
+```
+
+**Manually add a crumb:**
+```bash
+>> /crumb add deploy-prod docker build -t app:latest && docker push app:latest
+```
+
+**Delete a crumb:**
+```bash
+>> /crumb ols
+Deleted crumb 'ols'.
+```
+
+### Storage
+
+Crumbs are stored in `~/.ducky/crumbs.json` as JSON. Each crumb includes:
+- `prompt`: Original user prompt
+- `response`: AI's full response
+- `command`: The suggested bash command
+- `explanation`: AI-generated one-line summary
+- `created_at`: ISO timestamp
+
+**Example:**
+```json
+{
+  "ols": {
+    "prompt": "How do I list all Ollama processes?",
+    "response": "To list all running Ollama processes...",
+    "command": "ps aux | grep -i ollama | grep -v grep",
+    "explanation": "Finds and lists all running Ollama processes.",
+    "created_at": "2024-01-05T10:30:00.000000+00:00"
+  }
+}
+```
+
+Delete `~/.ducky/crumbs.json` to clear all saved crumbs.
+
+## Development (uv)
+
+```
+uv sync
+uv run ducky --help
+```
+
+`uv sync` creates a virtual environment and installs dependencies defined in `pyproject.toml` / `uv.lock`.
+
+## Telemetry & Storage
+
+Rubber Ducky stores:
+- `~/.ducky/prompt_history`: readline-compatible history file.
+- `~/.ducky/conversation.log`: JSON lines with timestamps for prompts, assistant messages, and shell executions.
+- `~/.ducky/config`: User preferences including last selected model.
+
+No other telemetry is collected; delete the directory if you want a fresh slate.

rubber_ducky-1.5.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+ducky/__init__.py,sha256=2vLhJxOuJ3lnIeg5rmF6xUvybUT5Qhjej6AS0BeBASY,60
+ducky/config.py,sha256=Lh7xTUYh4i8Gxgrl0oTYadZB_72Wy2BKIqLCcDQduOA,2116
+ducky/crumb.py,sha256=7BlyjD81-cZptYxQM97y6gOGdVDBF2qzxW0xbPqbspE,2693
+ducky/ducky.py,sha256=n0KOBHpbeBuk8g0BoF2mdJia9sdpY9FUyYjN5gBxaH8,38915
+examples/POLLING_USER_GUIDE.md,sha256=rMEAczZhpgyJ9BgwHkN-SKwSdyas8nlw_CjpV7SFOLA,10685
+examples/mock-logs/info.txt,sha256=apJqEO__UM1R2_2x9MlQOA7XmxvLvbhRvOy-FAwrINo,258
+examples/mock-logs/mock-logs.sh,sha256=zM2JSaCR1eCQLlMvXDWjFnpxZTqrMpnFRa_SgNLPmBk,1132
+rubber_ducky-1.5.1.dist-info/licenses/LICENSE,sha256=gQ1rCmw18NqTk5GxG96F6vgyN70e1c4kcKUtWDwdNaE,1069
+rubber_ducky-1.5.1.dist-info/METADATA,sha256=Gi8l6zNW3_CERWQO-b_lz5H5pZqyGuwFDTrC8fKEQ7A,6733
+rubber_ducky-1.5.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+rubber_ducky-1.5.1.dist-info/entry_points.txt,sha256=WPnVUUNvWdMDcBlCo8JCzkLghGllMX5QVZyQghyq85Q,75
+rubber_ducky-1.5.1.dist-info/top_level.txt,sha256=hid_mDkugR6XIeravFKuzcRPpuN_ylN3ejC_06Fmnb4,15
+rubber_ducky-1.5.1.dist-info/RECORD,,

{rubber_ducky-1.5.0.dist-info → rubber_ducky-1.5.1.dist-info}/top_level.txt

@@ -1,3 +1,2 @@
-crumbs
 ducky
 examples

crumbs/disk-usage/disk-usage.sh

@@ -1,12 +0,0 @@
-#!/usr/bin/env bash
-
-# Show disk usage with highlights
-
-echo "=== Disk Usage Overview ==="
-df -h 2>/dev/null | grep -E "(/|Filesystem)"
-
-echo -e "\n=== Detailed Disk Usage ==="
-du -h -d 2 . 2>/dev/null | sort -hr | head -20
-
-echo -e "\n=== Largest Files in Current Directory ==="
-find . -type f -not -path '*/\.git/*' -not -path '*/node_modules/*' -not -path '*/venv/*' -not -path '*/\__pycache__/*' -exec du -h {} + 2>/dev/null | sort -rh | head -10

crumbs/disk-usage/info.txt

@@ -1,3 +0,0 @@
-name: disk-usage
-type: shell
-description: Show disk usage with highlights on full drives

crumbs/git-log/git-log.sh

@@ -1,24 +0,0 @@
-#!/usr/bin/env bash
-
-# Show recent commit history with details
-
-if ! git rev-parse --git-dir > /dev/null 2>&1; then
-    echo "Not a git repository."
-    exit 1
-fi
-
-# Default to showing last 10 commits
-COMMIT_COUNT=10
-
-if [ -n "$1" ] && [[ "$1" =~ ^[0-9]+$ ]]; then
-    COMMIT_COUNT=$1
-fi
-
-echo "=== Recent ${COMMIT_COUNT} Commits ==="
-git log --oneline -$COMMIT_COUNT
-
-echo -e "\n=== Detailed View of Last ${COMMIT_COUNT} Commits ==="
-git log -${COMMIT_COUNT} --pretty=format:"%h - %an, %ar : %s" --stat
-
-echo -e "\n=== Author Statistics ==="
-git shortlog -sn --all -${COMMIT_COUNT} 2>/dev/null

crumbs/git-log/info.txt

@@ -1,3 +0,0 @@
-name: git-log
-type: shell
-description: Show recent commit history with detailed information

crumbs/git-status/git-status.sh

@@ -1,21 +0,0 @@
-#!/usr/bin/env bash
-
-# Show comprehensive git status and recent activity
-
-echo "=== Git Status ==="
-git status --short 2>/dev/null || echo "Not a git repository."
-
-echo -e "\n=== Current Branch ==="
-git branch --show-current 2>/dev/null || echo "Not a git repository."
-
-echo -e "\n=== Last 3 Commits ==="
-git log --oneline -3 2>/dev/null || echo "No commits found."
-
-echo -e "\n=== Staged Changes (if any) ==="
-git diff --cached --stat 2>/dev/null
-
-echo -e "\n=== Unstaged Changes (if any) ==="
-git diff --stat 2>/dev/null
-
-echo -e "\n=== Untracked Files (if any) ==="
-git ls-files --others --exclude-standard 2>/dev/null | head -20

crumbs/git-status/info.txt

@@ -1,3 +0,0 @@
-name: git-status
-type: shell
-description: Show current git branch, uncommitted changes, and provide suggestions for next steps

crumbs/process-list/info.txt

@@ -1,3 +0,0 @@
-name: process-list
-type: shell
-description: Show running processes with key information

crumbs/process-list/process-list.sh

@@ -1,20 +0,0 @@
-#!/usr/bin/env bash
-
-# Show running processes with useful information
-
-echo "=== Running Processes (Top 20 by CPU) ==="
-ps aux | sort -rk 3,3 | head -21 | awk '{printf "%-8s %-6s %-8s %s\n", $1, $2, $3, $11}' | column -t
-
-echo -e "\n=== Running Processes (Top 20 by Memory) ==="
-ps aux | sort -rk 4,4 | head -21 | awk '{printf "%-8s %-6s %-8s %s\n", $1, $2, $4, $11}' | column -t
-
-echo -e "\n=== Process Counts by User ==="
-ps aux | awk '{print $1}' | sort | uniq -c | sort -rn | head -10
-
-echo -e "\n=== Check for Specific Processes ==="
-for proc in "node" "python" "java" "docker" "npm" "uv"; do
-    count=$(pgrep -c "$proc" 2>/dev/null || echo "0")
-    if [ "$count" -gt 0 ]; then
-        echo "$proc: $count process(es)"
-    fi
-done | sort

crumbs/recent-files/info.txt

@@ -1,3 +0,0 @@
-name: recent-files
-type: shell
-description: Show recently modified files in the current directory

crumbs/recent-files/recent-files.sh

@@ -1,13 +0,0 @@
-#!/usr/bin/env bash
-
-# Show recently modified files in current directory
-# Takes optional argument for number of files to show (default 20)
-
-FILE_COUNT=20
-
-if [ -n "$1" ] && [[ "$1" =~ ^[0-9]+$ ]]; then
-    FILE_COUNT=$1
-fi
-
-echo "=== ${FILE_COUNT} Most Recently Modified Files ==="
-find . -type f -not -path '*/\.*' -not -path '*/node_modules/*' -not -path '*/\.git/*' -not -path '*/venv/*' -not -path '*/\__pycache__/*' -printf '%T@ %p\n' 2>/dev/null | sort -rn | head -${FILE_COUNT} | awk '{print strftime("%Y-%m-%d %H:%M:%S", $1), $2}'

crumbs/system-health/info.txt

@@ -1,3 +0,0 @@
-name: system-health
-type: shell
-description: Show system health metrics including CPU, memory, and load

crumbs/system-health/system-health.sh

@@ -1,58 +0,0 @@
-#!/usr/bin/env bash
-
-# Show system health metrics
-# Works on macOS and Linux
-
-detect_os() {
-    if [[ "$OSTYPE" == "darwin"* ]]; then
-        echo "macos"
-    elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
-        echo "linux"
-    else
-        echo "unknown"
-    fi
-}
-
-OS=$(detect_os)
-
-echo "=== System Health ==="
-echo "Platform: $OS"
-echo "Uptime: $(uptime)" | awk '{print $3, $4}'
-echo "Users logged in: $(who | wc -l | tr -d ' ')"
-
-echo -e "\n=== CPU Usage ==="
-
-if [ "$OS" == "macos" ]; then
-    echo "Load averages (1m, 5m, 15m): $(sysctl -n vm.loadavg)"
-    top -l 1 | grep "CPU usage"
-elif [ "$OS" == "linux" ]; then
-    echo "Load averages (1m, 5m, 15m): $(uptime | awk -F'load average:' '{print $2}')"
-    top -bn1 | grep "Cpu(s)"
-fi
-
-echo -e "\n=== Memory Usage ==="
-
-if [ "$OS" == "macos" ]; then
-    # macOS memory
-    echo "Memory Stats:"
-    vm_stat | perl -ne '/page size of (\d+)/ and $ps=$1; /Pages\s+([^:]+)[^\d]+(\d+)/ and printf("%-16s % 16.2f MB\n", "$1:", $2 * $ps / 1048576);'
-elif [ "$OS" == "linux" ]; then
-    free -h
-fi
-
-echo -e "\n=== Disk Space ==="
-df -h | grep -vE '^Filesystem|tmpfs|cdrom|devtmpfs'
-
-echo -e "\n=== Network Connections ==="
-
-if [ "$OS" == "macos" ]; then
-    netstat -an | grep ESTABLISHED | wc -l | xargs echo "Active network connections:"
-elif [ "$OS" == "linux" ]; then
-    ss -tun | grep ESTAB | wc -l | xargs echo "Active network connections:"
-fi
-
-echo -e "\n=== Top 5 Processes by CPU ==="
-ps aux | sort -rk 3,3 | head -11 | tail -10 | awk '{printf "%-10s %6s %s\n", $1, $3, $11}'
-
-echo -e "\n=== Top 5 Processes by Memory ==="
-ps aux | sort -rk 4,4 | head -11 | tail -10 | awk '{printf "%-10s %6s %s\n", $1, $4, $11}'

rubber_ducky-1.5.0.dist-info/METADATA

@@ -1,210 +0,0 @@
-Metadata-Version: 2.4
-Name: rubber-ducky
-Version: 1.5.0
-Summary: Quick CLI do-it-all tool. Use natural language to spit out bash commands
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: colorama>=0.4.6
-Requires-Dist: fastapi>=0.115.11
-Requires-Dist: ollama>=0.6.0
-Requires-Dist: openai>=1.60.2
-Requires-Dist: prompt-toolkit>=3.0.48
-Requires-Dist: rich>=13.9.4
-Requires-Dist: termcolor>=2.5.0
-Dynamic: license-file
-
-# Rubber Ducky
-
-Rubber Ducky is an inline terminal companion that turns natural language prompts into runnable shell commands. Paste multi-line context, get a suggested command, and run it without leaving your terminal.
-
-## Quick Start
-
-| Action | Command |
-| --- | --- |
-| Install globally | `uv tool install rubber-ducky` |
-| Run once | `uvx rubber-ducky -- --help` |
-| Local install | `uv pip install rubber-ducky` |
-
-Requirements:
-- [Ollama](https://ollama.com) running locally
-- Model available via Ollama (default: `qwen3-coder:480b-cloud`, install with `ollama pull qwen3-coder:480b-cloud`)
-
-## Usage
-
-```
-ducky                      # interactive inline session
-ducky --directory src      # preload code from a directory
-ducky --model qwen3        # use a different Ollama model
-ducky --local              # use local models with gemma2:9b default
-ducky --poll log-crumb     # start polling mode for a crumb
-```
-
-Both `ducky` and `rubber-ducky` executables map to the same CLI, so `uvx rubber-ducky -- <args>` works as well.
-
-### Inline Session (default)
-
-Launching `ducky` with no arguments opens the inline interface:
-- **Enter** submits; **Ctrl+J** inserts a newline (helpful when crafting multi-line prompts). Hitting **Enter on an empty prompt** reruns the latest suggested command; if none exists yet, it explains the most recent shell output.
-- **Ctrl+R** re-runs the last suggested command.
-- **Ctrl+S** copies the last suggested command to clipboard.
-- Prefix any line with **`!`** (e.g., `!ls -la`) to run a shell command immediately.
-- Arrow keys browse prompt history, backed by `~/.ducky/prompt_history`.
-- Every prompt, assistant response, and executed command is logged to `~/.ducky/conversation.log`.
-- Press **Ctrl+D** on an empty line to exit.
-- Non-interactive runs such as `cat prompt.txt | ducky` print one response (and suggested command) before exiting; if a TTY is available you'll be asked whether to run the suggested command immediately.
-- If `prompt_toolkit` is unavailable in your environment, Rubber Ducky falls back to a basic input loop (no history or shortcuts); install `prompt-toolkit>=3.0.48` to unlock the richer UI.
-
-`ducky --directory <path>` streams the contents of the provided directory to the assistant the next time you submit a prompt (the directory is read once at startup).
-
-### Model Management
-
-Rubber Ducky now supports easy switching between local and cloud models:
-- **`/model`** - Interactive model selection between local and cloud models
-- **`/local`** - List and select from local models (localhost:11434)
-- **`/cloud`** - List and select from cloud models (ollama.com)
-- Last used model is automatically saved and loaded on startup
-- Type **`esc`** during model selection to cancel
-
-### Additional Commands
-
-- **`/help`** - Show all available commands and shortcuts
-- **`/crumbs`** - List all available crumbs (default and user-created)
-- **`/clear`** or **`/reset`** - Clear conversation history
-- **`/poll <crumb>`** - Start polling session for a crumb
-- **`/poll <crumb> -i <interval>`** - Start polling with custom interval
-- **`/poll <crumb> -p <prompt>`** - Start polling with custom prompt
-- **`/stop-poll`** - Stop current polling session
-- **`/run`** or **`:run`** - Re-run the last suggested command
-
-## Crumbs
-
-Crumbs are simple scripts that can be executed within Rubber Ducky. They are stored in `~/.ducky/crumbs/` (for user crumbs) and shipped with the package (default crumbs).
-
-Rubber Ducky ships with the following default crumbs:
-
-| Crumb | Description |
-|-------|-------------|
-| `git-status` | Show current git status and provide suggestions |
-| `git-log` | Show recent commit history with detailed information |
-| `recent-files` | Show recently modified files in current directory |
-| `disk-usage` | Show disk usage with highlights |
-| `system-health` | Show CPU, memory, and system load metrics |
-| `process-list` | Show running processes with analysis |
-
-**Tip:** Run `/crumbs` in interactive mode to see all available crumbs with descriptions and polling status.
-
-To use a crumb, simply mention it in your prompt:
-```
-Can you use the git-status crumb to see what needs to be committed?
-```
-
-**Note:** User-defined crumbs (in `~/.ducky/crumbs/`) override default crumbs with the same name.
-
-### Creating Crumbs
-
-To create a new crumb:
-
-1. Create a new directory in `~/.ducky/crumbs/` with your crumb name
-2. Add an `info.txt` file with metadata:
-   ```
-   name: your-crumb-name
-   type: shell
-   description: Brief description of what this crumb does
-   ```
-3. Add your executable script file (e.g., `your-crumb-name.sh`)
-4. Create a symbolic link in `~/.local/bin` to make it available as a command:
-   ```bash
-   ln -s ~/.ducky/crumbs/your-crumb-name/your-crumb-name.sh ~/.local/bin/your-crumb-name
-   ```
-
-### Polling Mode
-
-Crumbs can be configured for background polling, where the crumb script runs at intervals and the AI analyzes the output.
-
-**Enabling Polling in a Crumb:**
-
-Add polling configuration to your crumb's `info.txt`:
-```
-name: log-crumb
-type: shell
-description: Fetch and analyze server logs
-poll: true
-poll_type: interval          # "interval" (run repeatedly) or "continuous" (run once, tail output)
-poll_interval: 5             # seconds between polls
-poll_prompt: Analyze these logs for errors, warnings, or anomalies. Be concise.
-```
-
-**Polling via CLI:**
-
-```bash
-# Start polling with crumb's default configuration
-ducky --poll log-crumb
-
-# Override interval
-ducky --poll log-crumb --interval 10
-
-# Override prompt
-ducky --poll log-crumb --prompt "Extract only error messages"
-```
-
-**Polling via Interactive Mode:**
-
-```bash
-ducky
->> /poll log-crumb                    # Use crumb defaults
->> /poll log-crumb -i 10              # Override interval
->> /poll log-crumb -p "Summarize"     # Override prompt
->> /stop-poll                         # Stop polling
-```
-
-**Example Crumb with Polling:**
-
-Directory: `~/.ducky/crumbs/server-logs/`
-
-```
-info.txt:
-  name: server-logs
-  type: shell
-  description: Fetch and analyze server logs
-  poll: true
-  poll_type: interval
-  poll_interval: 5
-  poll_prompt: Analyze these logs for errors, warnings, or anomalies. Be concise.
-
-server-logs.sh:
-  #!/bin/bash
-  curl -s http://localhost:8080/logs | tail -50
-```
-
-**Polling Types:**
-
-- **interval**: Run the crumb script at regular intervals (default)
-- **continuous**: Run the crumb once in the background and stream its output, analyzing periodically
-
-**Stopping Polling:**
-
-Press `Ctrl+C` at any time to stop polling. In interactive mode, you can also use `/stop-poll`.
-
-## Documentation
-
-- **Polling Feature Guide**: See [examples/POLLING_USER_GUIDE.md](examples/POLLING_USER_GUIDE.md) for detailed instructions on creating and using polling crumbs
-- **Mock Log Crumb**: See [examples/mock-logs/](examples/mock-logs/) for an example polling crumb
-
-## Development (uv)
-
-```
-uv sync
-uv run ducky --help
-```
-
-`uv sync` creates a virtual environment and installs dependencies defined in `pyproject.toml` / `uv.lock`.
-
-## Telemetry & Storage
-
-Rubber Ducky stores:
-- `~/.ducky/prompt_history`: readline-compatible history file.
-- `~/.ducky/conversation.log`: JSON lines with timestamps for prompts, assistant messages, and shell executions.
-- `~/.ducky/config`: User preferences including last selected model.
-
-No other telemetry is collected; delete the directory if you want a fresh slate.

rubber_ducky-1.5.0.dist-info/RECORD

@@ -1,24 +0,0 @@
-crumbs/disk-usage/disk-usage.sh,sha256=paiyWTmvzJD2A7wHDU2aIHJVnNqNmBfNV33Os0q7UnQ,451
-crumbs/disk-usage/info.txt,sha256=nKESO2G0biA0fV7peHPk7XaxcJ-wz_RJOkSUXI0VTKA,89
-crumbs/git-log/git-log.sh,sha256=L41W6s-hfJ7FsKgyaS39CRI6tRkgUg-0tHb3Z1FyHqY,595
-crumbs/git-log/info.txt,sha256=G0SDE5nv9mLU5zRpiYLdiR81ox6XRVJhNgnpoFArqeI,92
-crumbs/git-status/git-status.sh,sha256=hXdZxFA8hiJoZ4P8Zv1KPJjwIEpPJG7xibjL2ggbp7o,633
-crumbs/git-status/info.txt,sha256=MgzzfF23muScvS_JihXlpny7unyOCG7hZSAVZf-hQ7c,127
-crumbs/process-list/info.txt,sha256=5KGBQ3zn7hlL3Pv7miAoa3UBLQ-vKD-aLew6h0xeBcQ,88
-crumbs/process-list/process-list.sh,sha256=cwqMqu-xCbCn_DZNCaboZrDwg8A_UOF-bU9D8wxz5X8,744
-crumbs/recent-files/info.txt,sha256=7y9SS_lvYgagaKkVaJp-rF9TEgnUWCe6nj-34FcCvb8,98
-crumbs/recent-files/recent-files.sh,sha256=xpLUYYbouYQzGQZTTVrcybpRYPuoaLdyHny2HoHJZFw,540
-crumbs/system-health/info.txt,sha256=jym4tR5Xy7hEdowlvpufQ4_mA4H88JfQYPGXDZBI9UU,104
-crumbs/system-health/system-health.sh,sha256=NlLK3Th-sJ13Op44fjjEgi7oPscDQUCDBbR1Gd8ghlE,1670
-ducky/__init__.py,sha256=2vLhJxOuJ3lnIeg5rmF6xUvybUT5Qhjej6AS0BeBASY,60
-ducky/config.py,sha256=Lh7xTUYh4i8Gxgrl0oTYadZB_72Wy2BKIqLCcDQduOA,2116
-ducky/ducky.py,sha256=ZCoPH9c0SXRVS0HzdKavlokGWhlWeoPKG-ezi5B_isA,49466
-examples/POLLING_USER_GUIDE.md,sha256=rMEAczZhpgyJ9BgwHkN-SKwSdyas8nlw_CjpV7SFOLA,10685
-examples/mock-logs/info.txt,sha256=apJqEO__UM1R2_2x9MlQOA7XmxvLvbhRvOy-FAwrINo,258
-examples/mock-logs/mock-logs.sh,sha256=zM2JSaCR1eCQLlMvXDWjFnpxZTqrMpnFRa_SgNLPmBk,1132
-rubber_ducky-1.5.0.dist-info/licenses/LICENSE,sha256=gQ1rCmw18NqTk5GxG96F6vgyN70e1c4kcKUtWDwdNaE,1069
-rubber_ducky-1.5.0.dist-info/METADATA,sha256=Omw7U_3Q4dhj6Tzk0vTp3ZBDIcLQTnwTH5_X7p_fYk4,7859
-rubber_ducky-1.5.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-rubber_ducky-1.5.0.dist-info/entry_points.txt,sha256=WPnVUUNvWdMDcBlCo8JCzkLghGllMX5QVZyQghyq85Q,75
-rubber_ducky-1.5.0.dist-info/top_level.txt,sha256=cFot69fWrmToFkRuRXwS7_RmtIc9Gjp3RAgrmKkGZoY,22
-rubber_ducky-1.5.0.dist-info/RECORD,,