editprompt 1.2.0 → 1.4.0

package/README.md

@@ -19,7 +19,6 @@ A CLI tool that lets you write prompts for CLI tools using your favorite text ed
 - **💬 Quote and Reply**: Collect multiple text selections and reply to specific parts of AI responses
 - **📝 Multi-line Commands**: Complex SQL queries, JSON payloads, and structured prompts
 
-
 ## ✨ Features
 
 - 🖊️ **Editor Integration**: Use your preferred text editor to write prompts
@@ -29,7 +28,6 @@ A CLI tool that lets you write prompts for CLI tools using your favorite text ed
 - 📋 **Quote Buffering**: Collect text selections and send them as quoted replies
 - 📋 **Clipboard Fallback**: Automatically copies to clipboard if sending fails
 
-
 ## 📦 Installation
 
 ```bash
@@ -97,7 +95,6 @@ For replying to specific parts of AI responses:
 
 Perfect for addressing multiple points in long AI responses.
 
-
 ## ⚙️ Setup & Configuration
 
 ### Basic Setup
@@ -127,7 +124,6 @@ bind -n M-q run-shell '\
     "editprompt open --editor nvim --always-copy --target-pane #{pane_id}"'
 ```
 
-
 ### WezTerm Integration
 
 ```lua
@@ -173,7 +169,6 @@ bind -n M-q run-shell '\
 
 **Note:** The `-lc` flag ensures your shell loads the full login environment, making `editprompt` available in your PATH.
 
-
 ### Editor Integration (Send Without Closing)
 
 While editprompt is running, you can send content to the target pane or clipboard without closing the editor. This allows you to iterate quickly on your prompts.
@@ -197,6 +192,7 @@ editprompt input --auto-send --send-key "C-m" -- "your content here"
 This sends the content to the target pane (or clipboard) while keeping your editor open, so you can continue editing and send multiple times.
 
 **Options:**
+
 - `--auto-send`: Automatically sends the content and returns focus to your editor pane (requires multiplexer)
 - `--send-key <key>`: Customize the key to send after content (requires `--auto-send`)
   - tmux format: `Enter` (default), `C-a`, etc.
@@ -206,6 +202,39 @@ This sends the content to the target pane (or clipboard) while keeping your edit
 
 For Neovim users, we recommend using [editprompt.nvim](https://github.com/eetann/editprompt.nvim) for easy setup. For manual configuration, see [docs/neovim.md](docs/neovim.md).
 
+### Key Sending (press)
+
+Send individual key inputs to the target pane without leaving your editor. Useful for responding to AI agent selection prompts (e.g., choosing option 1, 2, 3, 4) without switching panes.
+
+```bash
+# Send a character key
+editprompt press -- 1
+
+# Send special keys (tmux format)
+editprompt press -- Tab
+editprompt press -- Up
+editprompt press -- C-m    # Enter
+editprompt press -- C-c    # Ctrl+C
+
+# Send with delay
+editprompt press --delay 500 -- Tab
+```
+
+**Key differences from `input`:**
+
+- No Enter key is automatically appended
+- Focus stays on the editor pane (no pane switching)
+- Designed for single key inputs, not text content
+
+**Key notation** depends on your multiplexer:
+
+| Key           | tmux          | WezTerm             |
+| ------------- | ------------- | ------------------- |
+| Enter         | `C-m`         | `\r`                |
+| Tab           | `Tab`         | `\t`                |
+| Escape        | `Escape`      | `\x1b`              |
+| Arrow Up/Down | `Up` / `Down` | `\x1b[A` / `\x1b[B` |
+
 ### Quote Workflow Setup
 
 #### Collecting Quotes in tmux Copy Mode
@@ -217,6 +246,7 @@ bind-key -T copy-mode-vi C-e { send-keys -X pipe "editprompt collect --target-pa
 ```
 
 **Usage:**
+
 1. Enter tmux copy mode (`prefix + [`)
 2. Select text using vi-mode keybindings
 3. Press `Ctrl-e` to add the selection as a quote
@@ -257,6 +287,7 @@ return {
 ```
 
 **Usage:**
+
 1. Select text in WezTerm (by dragging with mouse or using copy mode)
 2. Press `Ctrl-e` to add the selection as a quote
 3. Repeat to collect multiple quotes
@@ -273,6 +304,7 @@ editprompt dump
 This copies all collected quotes to the clipboard and clears the buffer, ready for your reply.
 
 **Complete workflow:**
+
 1. AI responds with multiple points
 2. Select each point in copy mode and press `Ctrl-e`
 3. Open your editor pane and run `editprompt dump`
@@ -280,6 +312,7 @@ This copies all collected quotes to the clipboard and clears the buffer, ready f
 5. Send to AI
 
 **How quote buffering works:**
+
 - **tmux**: Quotes are stored in pane variables, automatically cleaned up when the pane closes
 - **WezTerm**: Quotes are stored in a configuration file associated with the pane
 - Text is intelligently processed: removes common indentation, handles line breaks smartly
@@ -358,3 +391,42 @@ editprompt open --env NVIM_CONFIG=minimal
 #### Target Pane Environment Variable
 
 When using the send-without-closing feature or dump, editprompt sets `EDITPROMPT_TARGET_PANE` to the target pane ID. This is automatically used by `editprompt input` and `editprompt dump` commands.
+
+### Logging Options
+
+editprompt uses structured logging via [LogTape](https://logtape.org/). The following flags are available on all subcommands:
+
+| Flag                | Description                                |
+| ------------------- | ------------------------------------------ |
+| `--quiet` / `-q`    | Suppress all log output                    |
+| `--verbose` / `-v`  | Enable debug-level log output              |
+| `--log-file <path>` | Write logs to the specified file (appends) |
+
+You can also configure logging via environment variables:
+
+| Environment Variable   | Description                                          |
+| ---------------------- | ---------------------------------------------------- |
+| `EDITPROMPT_LOG_FILE`  | Path to log file (same as `--log-file`)              |
+| `EDITPROMPT_LOG_LEVEL` | Log level (e.g. `debug`, `info`, `warning`, `error`) |
+
+**Log level resolution priority:**
+
+1. `--quiet` → suppresses all logs
+2. `--verbose` → sets level to `debug`
+3. `EDITPROMPT_LOG_LEVEL` → uses the specified level
+4. Default: `info`
+
+### Send-Key Delay
+
+When using `--auto-send` with `editprompt input`, a delay is inserted before sending the key to allow the target process to finish processing the content.
+
+| Environment Variable        | Description                                  | Default |
+| --------------------------- | -------------------------------------------- | ------- |
+| `EDITPROMPT_SEND_KEY_DELAY` | Delay in milliseconds before sending the key | `1000`  |
+
+**Auto-detection:** editprompt automatically adjusts the delay based on content:
+
+- **Content with image paths** → uses `EDITPROMPT_SEND_KEY_DELAY` (default: `1000` ms)
+- **Content without image paths** → uses `200` ms
+
+Supported image extensions: `.png`, `.webp`, `.avif`, `.jpg`/`.jpeg`, `.gif` (case-insensitive)