agent-cli 0.82.3__tar.gz → 0.84.0__tar.gz

{agent_cli-0.82.3/agent_cli/dev/skill → agent_cli-0.84.0/.claude/skills/agent-cli-dev}/SKILL.md

@@ -1,12 +1,16 @@
 ---
 name: agent-cli-dev
-description: Spawns AI coding agents in isolated git worktrees. Use when the user asks to spawn or launch an agent, delegate a task to a separate agent, work in a separate worktree, or parallelize development across features.
+description: Spawns AI coding agents in isolated git worktrees. Use when the user asks to spawn or launch an agent, delegate a task to a separate agent, or parallelize development across features. Only create a worktree without starting an agent if the user explicitly wants setup only.
 ---
 
 # Parallel Development with agent-cli dev
 
 This skill teaches you how to spawn parallel AI coding agents in isolated git worktrees using the `agent-cli dev` command.
 
+`agent-cli dev` supports two complementary patterns:
+- Separate worktrees for isolated implementation/review tasks
+- Multiple agents on the same worktree using `dev agent -m tmux`
+
 ## Installation
 
 If `agent-cli` is not available, install it first:
@@ -58,6 +62,16 @@ This creates:
 
 **Important**: Use `--prompt-file` for prompts longer than a single line. The `--prompt` option passes text through the shell, which can cause issues with special characters (exclamation marks, dollar signs, backticks, quotes) in ZSH and other shells. Using `--prompt-file` avoids all shell quoting issues.
 
+## Automation rule
+
+When an assistant is executing this workflow on the user's behalf, the spawn is not complete unless the agent receives a prompt at launch time.
+
+- Prefer `--prompt-file`; create the prompt file first, then launch the agent
+- Use `dev new ... --agent --prompt-file ...` for a new delegated task
+- Use `dev agent ... --prompt-file ...` for another agent in an existing worktree
+- Do not stop after `dev new ...` alone if the user's intent was to delegate work immediately
+- Do not run `dev new ... --agent` or `dev agent ... -m tmux` without `--prompt` or `--prompt-file` unless the user explicitly wants an interactive session that they will drive manually
+
 ## Writing effective prompts for spawned agents
 
 Spawned agents work in isolation, so prompts must be **self-contained**. Include:
@@ -76,7 +90,7 @@ For any prompt longer than a single sentence:
 
 Example workflow:
 ```bash
-# 1. Write prompt to file (Claude does this with the Write tool)
+# 1. Write prompt to file
 # 2. Spawn agent with the file
 agent-cli dev new my-feature --agent --prompt-file .claude/spawn-prompt.md
 # 3. Optionally clean up
@@ -114,6 +128,54 @@ agent-cli dev run <branch-name> cat .claude/REPORT.md
 agent-cli dev editor <branch-name>
 ```
 
+## Same-branch multi-agent workflow
+
+Use this when several agents should inspect or validate the same code at once without separate worktrees.
+
+```bash
+# Create the worktree once. This step only prepares the shared workspace.
+agent-cli dev new review-auth --from HEAD
+
+# Then launch the actual agents with prompts.
+agent-cli dev agent review-auth -m tmux --prompt-file .claude/review-security.md
+agent-cli dev agent review-auth -m tmux --prompt-file .claude/review-performance.md
+agent-cli dev agent review-auth -m tmux --prompt-file .claude/review-tests.md
+```
+
+Key rules for same-worktree launches:
+- Use `dev agent`, not `dev new`, after the worktree already exists
+- Use `-m tmux` for headless or scripted launching; it works even when not already inside tmux
+- Each launch joins the same deterministic repo-scoped tmux session, so related agents stay grouped together
+- Ask each agent to write to a unique report path such as `.claude/REPORT-security-<run-id>.md` or `.claude/REPORT-tests-<run-id>.md`
+- If you rerun the same prompt repeatedly, include a timestamp or other run id in the report filename so later runs do not overwrite earlier ones
+- Do not rely on `.claude/TASK.md` as per-agent state in shared worktrees; later launches overwrite it
+
+### Prompt guidance for shared worktrees
+
+When multiple agents share a worktree, explicitly assign both a focus area and a unique report file. If you rerun the same review prompt often, prefer a timestamped filename such as `.claude/REPORT-security-20260319-153045-123.md`.
+
+Prompt pattern:
+
+```text
+Review the auth module for security issues only.
+
+When complete, write findings to .claude/REPORT-security-20260319-153045-123.md including:
+- Summary
+- Issues found with file/line references
+- Suggested fixes
+```
+
+## Headless/scripted orchestration
+
+For non-interactive contexts (scripts, cron jobs, other assistants), combine `--prompt-file` with `-m tmux`:
+
+```bash
+agent-cli dev new validation-a --from HEAD --agent --with-agent codex -m tmux \
+  --prompt-file .claude/validation-a.md
+```
+
+This works without an attached terminal. `agent-cli` creates or reuses a detached tmux session and returns a pane handle plus attach command.
+
 ## Example: Multi-feature implementation
 
 If asked to implement auth, payments, and notifications:

{agent_cli-0.82.3 → agent_cli-0.84.0}/.claude/skills/agent-cli-dev/examples.md

@@ -8,6 +8,8 @@ Real-world scenarios for spawning parallel AI coding agents, optimized for Claud
 > # Write prompt to file, then spawn
 > agent-cli dev new my-feature --agent --prompt-file .claude/spawn-prompt.md
 > ```
+>
+> When an assistant is executing these commands, do not launch `dev new` or `dev agent` without `--prompt` or `--prompt-file` unless the user explicitly wants a manual interactive session.
 
 ## Prompt structure guidelines
 
@@ -19,6 +21,7 @@ Each prompt for a spawned agent should follow this structure:
 4. **Context with motivation** - Explain why patterns matter
 5. **Focused scope** - Keep solutions minimal, implement only what's requested
 6. **Structured report** - Write conclusions to `.claude/REPORT.md`
+7. **No interactive gap** - The launch command itself should include `--prompt` or `--prompt-file` so the agent starts working immediately
 
 ## Scenario 1: Code review of current branch
 
@@ -524,6 +527,96 @@ When complete, write to .claude/REPORT.md:
 </report>"
 ```
 
+## Scenario 6: Multi-reviewer on the same branch
+
+**User request**: "Get 3 agents to review this code" or "Run multiple reviewers on this branch"
+
+**Strategy**: Create one review worktree from the current branch, then launch several agents into that same worktree with different focus areas.
+
+```bash
+run_id="$(python -c 'import time; print(int(time.time() * 1000))')"
+
+# Create the shared review worktree once. This does not start an agent yet.
+agent-cli dev new review-auth --from HEAD
+
+# Launch three reviewers into the same worktree/session
+agent-cli dev agent review-auth -m tmux --prompt "Review the auth module for security issues only.
+
+<scope>
+Do not fix code. Review only.
+</scope>
+
+<report>
+Write findings to .claude/REPORT-security-$run_id.md:
+- Summary
+- Issues with file:line references
+- Suggested fixes
+</report>"
+
+agent-cli dev agent review-auth -m tmux --prompt "Review the auth module for performance issues only.
+
+<scope>
+Review only. Focus on query patterns, repeated work, and unnecessary allocations.
+</scope>
+
+<report>
+Write findings to .claude/REPORT-performance-$run_id.md:
+- Summary
+- Issues with file:line references
+- Suggested fixes
+</report>"
+
+agent-cli dev agent review-auth -m tmux --prompt "Review the auth module for test coverage gaps only.
+
+<scope>
+Review only. Identify missing or weak tests.
+</scope>
+
+<report>
+Write findings to .claude/REPORT-tests-$run_id.md:
+- Summary
+- Missing test cases
+- Suggested follow-up tests
+</report>"
+```
+
+**Important**:
+- Same-worktree launches should use unique report files, not `.claude/REPORT.md`
+- If you rerun the same prompt often, include a timestamp or run id in the filename so reports do not get replaced
+- `-m tmux` works even when the caller is not already inside tmux
+- All three agents land in the same deterministic tmux session for that repo
+- `.claude/TASK.md` is shared state and may be overwritten by later launches, so keep prompt files outside that convention
+
+## Scenario 7: Parallel test validation
+
+**User request**: "Run the test checklist across 8 sections in parallel"
+
+**Strategy**: Create one worktree per section, then launch each validation agent headlessly in tmux so the workflow works from scripts or non-terminal orchestrators.
+
+```bash
+for section in 1 2 3 4 5 6 7 8; do
+  agent-cli dev new "test-section-$section" --from HEAD --agent --with-agent codex -m tmux \
+    --prompt-file ".claude/test-section-$section.md"
+done
+```
+
+Monitor and collect results:
+
+```bash
+# Track the worktrees
+agent-cli dev status
+
+# Read each report after completion
+for section in 1 2 3 4 5 6 7 8; do
+  agent-cli dev run "test-section-$section" cat .claude/REPORT.md
+done
+```
+
+**When writing the per-section prompts**:
+- Assign one checklist section per agent
+- Require real test execution where possible
+- Require a structured `.claude/REPORT.md` with pass/fail status, evidence, and follow-up actions
+
 ## Reviewing results
 
 After agents complete their work:
@@ -569,3 +662,8 @@ Any items that need human review or clarification
 ```
 
 This consistent format makes it easy to review work from multiple agents.
+
+For shared-worktree runs, keep the same structure but use unique filenames such as:
+- `.claude/REPORT-security.md`
+- `.claude/REPORT-performance.md`
+- `.claude/REPORT-tests.md`

{agent_cli-0.82.3/.claude → agent_cli-0.84.0/.claude-plugin}/skills/agent-cli-dev/SKILL.md

@@ -1,12 +1,16 @@
 ---
 name: agent-cli-dev
-description: Spawns AI coding agents in isolated git worktrees. Use when the user asks to spawn or launch an agent, delegate a task to a separate agent, work in a separate worktree, or parallelize development across features.
+description: Spawns AI coding agents in isolated git worktrees. Use when the user asks to spawn or launch an agent, delegate a task to a separate agent, or parallelize development across features. Only create a worktree without starting an agent if the user explicitly wants setup only.
 ---
 
 # Parallel Development with agent-cli dev
 
 This skill teaches you how to spawn parallel AI coding agents in isolated git worktrees using the `agent-cli dev` command.
 
+`agent-cli dev` supports two complementary patterns:
+- Separate worktrees for isolated implementation/review tasks
+- Multiple agents on the same worktree using `dev agent -m tmux`
+
 ## Installation
 
 If `agent-cli` is not available, install it first:
@@ -58,6 +62,16 @@ This creates:
 
 **Important**: Use `--prompt-file` for prompts longer than a single line. The `--prompt` option passes text through the shell, which can cause issues with special characters (exclamation marks, dollar signs, backticks, quotes) in ZSH and other shells. Using `--prompt-file` avoids all shell quoting issues.
 
+## Automation rule
+
+When an assistant is executing this workflow on the user's behalf, the spawn is not complete unless the agent receives a prompt at launch time.
+
+- Prefer `--prompt-file`; create the prompt file first, then launch the agent
+- Use `dev new ... --agent --prompt-file ...` for a new delegated task
+- Use `dev agent ... --prompt-file ...` for another agent in an existing worktree
+- Do not stop after `dev new ...` alone if the user's intent was to delegate work immediately
+- Do not run `dev new ... --agent` or `dev agent ... -m tmux` without `--prompt` or `--prompt-file` unless the user explicitly wants an interactive session that they will drive manually
+
 ## Writing effective prompts for spawned agents
 
 Spawned agents work in isolation, so prompts must be **self-contained**. Include:
@@ -76,7 +90,7 @@ For any prompt longer than a single sentence:
 
 Example workflow:
 ```bash
-# 1. Write prompt to file (Claude does this with the Write tool)
+# 1. Write prompt to file
 # 2. Spawn agent with the file
 agent-cli dev new my-feature --agent --prompt-file .claude/spawn-prompt.md
 # 3. Optionally clean up
@@ -114,6 +128,54 @@ agent-cli dev run <branch-name> cat .claude/REPORT.md
 agent-cli dev editor <branch-name>
 ```
 
+## Same-branch multi-agent workflow
+
+Use this when several agents should inspect or validate the same code at once without separate worktrees.
+
+```bash
+# Create the worktree once. This step only prepares the shared workspace.
+agent-cli dev new review-auth --from HEAD
+
+# Then launch the actual agents with prompts.
+agent-cli dev agent review-auth -m tmux --prompt-file .claude/review-security.md
+agent-cli dev agent review-auth -m tmux --prompt-file .claude/review-performance.md
+agent-cli dev agent review-auth -m tmux --prompt-file .claude/review-tests.md
+```
+
+Key rules for same-worktree launches:
+- Use `dev agent`, not `dev new`, after the worktree already exists
+- Use `-m tmux` for headless or scripted launching; it works even when not already inside tmux
+- Each launch joins the same deterministic repo-scoped tmux session, so related agents stay grouped together
+- Ask each agent to write to a unique report path such as `.claude/REPORT-security-<run-id>.md` or `.claude/REPORT-tests-<run-id>.md`
+- If you rerun the same prompt repeatedly, include a timestamp or other run id in the report filename so later runs do not overwrite earlier ones
+- Do not rely on `.claude/TASK.md` as per-agent state in shared worktrees; later launches overwrite it
+
+### Prompt guidance for shared worktrees
+
+When multiple agents share a worktree, explicitly assign both a focus area and a unique report file. If you rerun the same review prompt often, prefer a timestamped filename such as `.claude/REPORT-security-20260319-153045-123.md`.
+
+Prompt pattern:
+
+```text
+Review the auth module for security issues only.
+
+When complete, write findings to .claude/REPORT-security-20260319-153045-123.md including:
+- Summary
+- Issues found with file/line references
+- Suggested fixes
+```
+
+## Headless/scripted orchestration
+
+For non-interactive contexts (scripts, cron jobs, other assistants), combine `--prompt-file` with `-m tmux`:
+
+```bash
+agent-cli dev new validation-a --from HEAD --agent --with-agent codex -m tmux \
+  --prompt-file .claude/validation-a.md
+```
+
+This works without an attached terminal. `agent-cli` creates or reuses a detached tmux session and returns a pane handle plus attach command.
+
 ## Example: Multi-feature implementation
 
 If asked to implement auth, payments, and notifications:

{agent_cli-0.82.3 → agent_cli-0.84.0}/.claude-plugin/skills/agent-cli-dev/examples.md

@@ -8,6 +8,8 @@ Real-world scenarios for spawning parallel AI coding agents, optimized for Claud
 > # Write prompt to file, then spawn
 > agent-cli dev new my-feature --agent --prompt-file .claude/spawn-prompt.md
 > ```
+>
+> When an assistant is executing these commands, do not launch `dev new` or `dev agent` without `--prompt` or `--prompt-file` unless the user explicitly wants a manual interactive session.
 
 ## Prompt structure guidelines
 
@@ -19,6 +21,7 @@ Each prompt for a spawned agent should follow this structure:
 4. **Context with motivation** - Explain why patterns matter
 5. **Focused scope** - Keep solutions minimal, implement only what's requested
 6. **Structured report** - Write conclusions to `.claude/REPORT.md`
+7. **No interactive gap** - The launch command itself should include `--prompt` or `--prompt-file` so the agent starts working immediately
 
 ## Scenario 1: Code review of current branch
 
@@ -524,6 +527,96 @@ When complete, write to .claude/REPORT.md:
 </report>"
 ```
 
+## Scenario 6: Multi-reviewer on the same branch
+
+**User request**: "Get 3 agents to review this code" or "Run multiple reviewers on this branch"
+
+**Strategy**: Create one review worktree from the current branch, then launch several agents into that same worktree with different focus areas.
+
+```bash
+run_id="$(python -c 'import time; print(int(time.time() * 1000))')"
+
+# Create the shared review worktree once. This does not start an agent yet.
+agent-cli dev new review-auth --from HEAD
+
+# Launch three reviewers into the same worktree/session
+agent-cli dev agent review-auth -m tmux --prompt "Review the auth module for security issues only.
+
+<scope>
+Do not fix code. Review only.
+</scope>
+
+<report>
+Write findings to .claude/REPORT-security-$run_id.md:
+- Summary
+- Issues with file:line references
+- Suggested fixes
+</report>"
+
+agent-cli dev agent review-auth -m tmux --prompt "Review the auth module for performance issues only.
+
+<scope>
+Review only. Focus on query patterns, repeated work, and unnecessary allocations.
+</scope>
+
+<report>
+Write findings to .claude/REPORT-performance-$run_id.md:
+- Summary
+- Issues with file:line references
+- Suggested fixes
+</report>"
+
+agent-cli dev agent review-auth -m tmux --prompt "Review the auth module for test coverage gaps only.
+
+<scope>
+Review only. Identify missing or weak tests.
+</scope>
+
+<report>
+Write findings to .claude/REPORT-tests-$run_id.md:
+- Summary
+- Missing test cases
+- Suggested follow-up tests
+</report>"
+```
+
+**Important**:
+- Same-worktree launches should use unique report files, not `.claude/REPORT.md`
+- If you rerun the same prompt often, include a timestamp or run id in the filename so reports do not get replaced
+- `-m tmux` works even when the caller is not already inside tmux
+- All three agents land in the same deterministic tmux session for that repo
+- `.claude/TASK.md` is shared state and may be overwritten by later launches, so keep prompt files outside that convention
+
+## Scenario 7: Parallel test validation
+
+**User request**: "Run the test checklist across 8 sections in parallel"
+
+**Strategy**: Create one worktree per section, then launch each validation agent headlessly in tmux so the workflow works from scripts or non-terminal orchestrators.
+
+```bash
+for section in 1 2 3 4 5 6 7 8; do
+  agent-cli dev new "test-section-$section" --from HEAD --agent --with-agent codex -m tmux \
+    --prompt-file ".claude/test-section-$section.md"
+done
+```
+
+Monitor and collect results:
+
+```bash
+# Track the worktrees
+agent-cli dev status
+
+# Read each report after completion
+for section in 1 2 3 4 5 6 7 8; do
+  agent-cli dev run "test-section-$section" cat .claude/REPORT.md
+done
+```
+
+**When writing the per-section prompts**:
+- Assign one checklist section per agent
+- Require real test execution where possible
+- Require a structured `.claude/REPORT.md` with pass/fail status, evidence, and follow-up actions
+
 ## Reviewing results
 
 After agents complete their work:
@@ -569,3 +662,8 @@ Any items that need human review or clarification
 ```
 
 This consistent format makes it easy to review work from multiple agents.
+
+For shared-worktree runs, keep the same structure but use unique filenames such as:
+- `.claude/REPORT-security.md`
+- `.claude/REPORT-performance.md`
+- `.claude/REPORT-tests.md`

{agent_cli-0.82.3 → agent_cli-0.84.0}/.pre-commit-config.yaml

@@ -11,7 +11,7 @@ repos:
       - id: end-of-file-fixer
       - id: mixed-line-ending
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.15.5"
+    rev: "v0.15.6"
     hooks:
       - id: ruff
         args: ["--fix"]

{agent_cli-0.82.3 → agent_cli-0.84.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-cli
-Version: 0.82.3
+Version: 0.84.0
 Summary: A suite of AI-powered command-line tools for text correction, audio transcription, and voice assistance.
 Project-URL: Homepage, https://github.com/basnijholt/agent-cli
 Author-email: Bas Nijholt <bas@nijho.lt>
@@ -225,6 +225,8 @@ agent-cli install-hotkeys
 agent-cli autocorrect "this has an eror"
 ```
 
+`install-hotkeys` also installs the required `audio` and `llm` extras if they are missing.
+
 The setup scripts automatically install:
 - ✅ Package managers (Homebrew/uv) if needed
 - ✅ All AI services (Ollama, Whisper, TTS, etc.)
@@ -376,7 +378,7 @@ This script automatically:
 > After setup, you may need to grant Accessibility permissions to skhd in System Settings → Privacy & Security → Accessibility
 
 > [!TIP]
-> To keep the “Listening…” indicator visible for the whole recording, open System Settings → Notifications → *terminal-notifier* and set the Alert style to **Persistent** (or choose **Alerts** on older macOS versions).
+> To keep the recording-status notification visible for the whole flow, open System Settings → Notifications → *terminal-notifier* and set the Alert style to **Persistent** (or choose **Alerts** on older macOS versions).
 > Also enable "Allow notification when mirroring or sharing the display".
 > The hotkey scripts keep only the recording notification pinned; status and result toasts auto-dismiss.
 
@@ -1978,13 +1980,14 @@ uv tool install "agent-cli[vad]" -p 3.13
 **Workflow:**
 
 1.  Start the server, pointing it to your documents folder and your local LLM (e.g., Ollama or llama.cpp) or OpenAI.
-2.  The server watches the folder and automatically indexes any text/markdown/PDF files into a local ChromaDB vector store.
+2.  The server watches the folder and automatically indexes any text/markdown/PDF files into a local ChromaDB vector store, skipping paths matched by `.gitignore` files in the docs folder and, when inside a git repo, its parent directories up to the repo root.
 3.  Point any OpenAI-compatible client (including `agent-cli chat`) to this server's URL.
 4.  When you ask a question, the server retrieves relevant document chunks, adds them to the prompt, and forwards it to the LLM.
 
 **How to Use It:**
 
 - **Install RAG deps first**: `pip install "agent-cli[rag]"` (or, from the repo, `uv sync --extra rag`)
+- **Note on ignored files**: `.gitignore` rules in your docs folder are respected during indexing; if the docs folder is inside a git repo, parent `.gitignore` files up to the repo root are also applied. Use `!pattern` entries to re-include paths when needed
 - **Start Server (Local LLM)**: `agent-cli rag-proxy --docs-folder ~/Documents/Notes --openai-base-url http://localhost:11434/v1 --port 8000`
 - **Start Server (OpenAI)**: `agent-cli rag-proxy --docs-folder ~/Documents/Notes --openai-api-key sk-...`
 - **Use with Agent-CLI**: `agent-cli chat --openai-base-url http://localhost:8000/v1 --llm-provider openai`
@@ -2022,10 +2025,12 @@ uv tool install "agent-cli[vad]" -p 3.13
  How it works:
 
   1 Documents in --docs-folder are chunked, embedded, and stored in ChromaDB
-  2 A file watcher auto-reindexes when files change
-  3 Chat requests trigger a semantic search for relevant chunks
-  4 Retrieved context is injected into the prompt before forwarding to the LLM
-  5 Responses include a rag_sources field listing which documents were used
+  2 Paths matched by .gitignore files in the docs folder and, when inside a git repo, its
+    parents up to the repo root are skipped
+  3 A file watcher auto-reindexes when files change
+  4 Chat requests trigger a semantic search for relevant chunks
+  5 Retrieved context is injected into the prompt before forwarding to the LLM
+  6 Responses include a rag_sources field listing which documents were used
 
  Supported file formats:
 
@@ -2051,7 +2056,11 @@ uv tool install "agent-cli[vad]" -p 3.13
 ╭─ RAG Configuration ────────────────────────────────────────────────────────────────────╮
 │ --docs-folder                      PATH     Folder to watch for documents. Files are   │
 │                                             auto-indexed on startup and when changed.  │
-│                                             Must not overlap with --chroma-path.       │
+│                                             Paths matching .gitignore files in this    │
+│                                             folder and, when inside a git repo, its    │
+│                                             parent directories up to the repo root are │
+│                                             skipped. Must not overlap with             │
+│                                             --chroma-path.                             │
 │                                             [default: ./rag_docs]                      │
 │ --chroma-path                      PATH     ChromaDB storage directory for vector      │
 │                                             embeddings. Must be separate from          │

{agent_cli-0.82.3 → agent_cli-0.84.0}/README.md

@@ -122,6 +122,8 @@ agent-cli install-hotkeys
 agent-cli autocorrect "this has an eror"
 ```
 
+`install-hotkeys` also installs the required `audio` and `llm` extras if they are missing.
+
 The setup scripts automatically install:
 - ✅ Package managers (Homebrew/uv) if needed
 - ✅ All AI services (Ollama, Whisper, TTS, etc.)
@@ -273,7 +275,7 @@ This script automatically:
 > After setup, you may need to grant Accessibility permissions to skhd in System Settings → Privacy & Security → Accessibility
 
 > [!TIP]
-> To keep the “Listening…” indicator visible for the whole recording, open System Settings → Notifications → *terminal-notifier* and set the Alert style to **Persistent** (or choose **Alerts** on older macOS versions).
+> To keep the recording-status notification visible for the whole flow, open System Settings → Notifications → *terminal-notifier* and set the Alert style to **Persistent** (or choose **Alerts** on older macOS versions).
 > Also enable "Allow notification when mirroring or sharing the display".
 > The hotkey scripts keep only the recording notification pinned; status and result toasts auto-dismiss.
 
@@ -1875,13 +1877,14 @@ uv tool install "agent-cli[vad]" -p 3.13
 **Workflow:**
 
 1.  Start the server, pointing it to your documents folder and your local LLM (e.g., Ollama or llama.cpp) or OpenAI.
-2.  The server watches the folder and automatically indexes any text/markdown/PDF files into a local ChromaDB vector store.
+2.  The server watches the folder and automatically indexes any text/markdown/PDF files into a local ChromaDB vector store, skipping paths matched by `.gitignore` files in the docs folder and, when inside a git repo, its parent directories up to the repo root.
 3.  Point any OpenAI-compatible client (including `agent-cli chat`) to this server's URL.
 4.  When you ask a question, the server retrieves relevant document chunks, adds them to the prompt, and forwards it to the LLM.
 
 **How to Use It:**
 
 - **Install RAG deps first**: `pip install "agent-cli[rag]"` (or, from the repo, `uv sync --extra rag`)
+- **Note on ignored files**: `.gitignore` rules in your docs folder are respected during indexing; if the docs folder is inside a git repo, parent `.gitignore` files up to the repo root are also applied. Use `!pattern` entries to re-include paths when needed
 - **Start Server (Local LLM)**: `agent-cli rag-proxy --docs-folder ~/Documents/Notes --openai-base-url http://localhost:11434/v1 --port 8000`
 - **Start Server (OpenAI)**: `agent-cli rag-proxy --docs-folder ~/Documents/Notes --openai-api-key sk-...`
 - **Use with Agent-CLI**: `agent-cli chat --openai-base-url http://localhost:8000/v1 --llm-provider openai`
@@ -1919,10 +1922,12 @@ uv tool install "agent-cli[vad]" -p 3.13
  How it works:
 
   1 Documents in --docs-folder are chunked, embedded, and stored in ChromaDB
-  2 A file watcher auto-reindexes when files change
-  3 Chat requests trigger a semantic search for relevant chunks
-  4 Retrieved context is injected into the prompt before forwarding to the LLM
-  5 Responses include a rag_sources field listing which documents were used
+  2 Paths matched by .gitignore files in the docs folder and, when inside a git repo, its
+    parents up to the repo root are skipped
+  3 A file watcher auto-reindexes when files change
+  4 Chat requests trigger a semantic search for relevant chunks
+  5 Retrieved context is injected into the prompt before forwarding to the LLM
+  6 Responses include a rag_sources field listing which documents were used
 
  Supported file formats:
 
@@ -1948,7 +1953,11 @@ uv tool install "agent-cli[vad]" -p 3.13
 ╭─ RAG Configuration ────────────────────────────────────────────────────────────────────╮
 │ --docs-folder                      PATH     Folder to watch for documents. Files are   │
 │                                             auto-indexed on startup and when changed.  │
-│                                             Must not overlap with --chroma-path.       │
+│                                             Paths matching .gitignore files in this    │
+│                                             folder and, when inside a git repo, its    │
+│                                             parent directories up to the repo root are │
+│                                             skipped. Must not overlap with             │
+│                                             --chroma-path.                             │
 │                                             [default: ./rag_docs]                      │
 │ --chroma-path                      PATH     ChromaDB storage directory for vector      │
 │                                             embeddings. Must be separate from          │

{agent_cli-0.82.3 → agent_cli-0.84.0}/agent_cli/agents/rag_proxy.py

@@ -23,7 +23,7 @@ from agent_cli.core.utils import (
 def rag_proxy(
     docs_folder: Path = typer.Option(  # noqa: B008
         "./rag_docs",
-        help="Folder to watch for documents. Files are auto-indexed on startup and when changed. Must not overlap with `--chroma-path`.",
+        help="Folder to watch for documents. Files are auto-indexed on startup and when changed. Paths matching `.gitignore` files in this folder and, when inside a git repo, its parent directories up to the repo root are skipped. Must not overlap with `--chroma-path`.",
         rich_help_panel="RAG Configuration",
     ),
     chroma_path: Path = typer.Option(  # noqa: B008
@@ -71,10 +71,11 @@ def rag_proxy(
     **How it works:**
 
     1. Documents in `--docs-folder` are chunked, embedded, and stored in ChromaDB
-    2. A file watcher auto-reindexes when files change
-    3. Chat requests trigger a semantic search for relevant chunks
-    4. Retrieved context is injected into the prompt before forwarding to the LLM
-    5. Responses include a `rag_sources` field listing which documents were used
+    2. Paths matched by `.gitignore` files in the docs folder and, when inside a git repo, its parents up to the repo root are skipped
+    3. A file watcher auto-reindexes when files change
+    4. Chat requests trigger a semantic search for relevant chunks
+    5. Retrieved context is injected into the prompt before forwarding to the LLM
+    6. Responses include a `rag_sources` field listing which documents were used
 
     **Supported file formats:**
 

{agent_cli-0.82.3 → agent_cli-0.84.0}/agent_cli/config.py

@@ -262,6 +262,9 @@ class History(BaseModel):
 class Dev(BaseModel):
     """Configuration for parallel development environments (git worktrees)."""
 
+    editor: bool = False
+    agent: bool = False
+    direnv: bool | None = None
     default_agent: str | None = None
     default_editor: str | None = None
     branch_name_mode: Literal["random", "auto", "ai"] = "random"
@@ -270,6 +273,7 @@ class Dev(BaseModel):
     agent_args: dict[str, list[str]] | None = (
         None  # Per-agent args, e.g. {"claude": ["--dangerously-skip-permissions"]}
     )
+    agent_env: dict[str, dict[str, str]] | None = None
     setup: bool = True  # Run project setup (npm install, etc.)
     copy_env: bool = True  # Copy .env files from main repo
     fetch: bool = True  # Git fetch before creating worktree