agent-cli 0.62.0__py3-none-any.whl → 0.63.0__py3-none-any.whl

agent_cli/dev/cli.py

@@ -344,6 +344,19 @@ def _launch_editor(path: Path, editor: Editor) -> None:
         _warn(f"Could not open editor: {e}")
 
 
+def _write_prompt_to_worktree(worktree_path: Path, prompt: str) -> Path:
+    """Write the prompt to .claude/TASK.md in the worktree.
+
+    This makes the task description available to the spawned agent
+    and provides a record of what was requested.
+    """
+    claude_dir = worktree_path / ".claude"
+    claude_dir.mkdir(parents=True, exist_ok=True)
+    task_file = claude_dir / "TASK.md"
+    task_file.write_text(prompt + "\n")
+    return task_file
+
+
 def _format_env_prefix(env: dict[str, str]) -> str:
     """Format environment variables as shell prefix.
 
@@ -627,6 +640,11 @@ def new(  # noqa: PLR0912, PLR0915
             # Only warn if user explicitly requested direnv
             _warn("direnv not installed, skipping .envrc setup")
 
+    # Write prompt to worktree (makes task available to the spawned agent)
+    if prompt:
+        task_file = _write_prompt_to_worktree(result.path, prompt)
+        _success(f"Wrote task to {task_file.relative_to(result.path)}")
+
     # Resolve editor and agent
     resolved_editor = _resolve_editor(editor, editor_name, default_editor)
     resolved_agent = _resolve_agent(agent, agent_name, default_agent)
@@ -1039,6 +1057,11 @@ def start_agent(
     if not agent.is_available():
         _error(f"{agent.name} is not installed. Install from: {agent.install_url}")
 
+    # Write prompt to worktree (makes task available to the agent)
+    if prompt:
+        task_file = _write_prompt_to_worktree(wt.path, prompt)
+        _success(f"Wrote task to {task_file.relative_to(wt.path)}")
+
     merged_args = _merge_agent_args(agent, agent_args)
     agent_env = _get_agent_env(agent)
     _info(f"Starting {agent.name} in {wt.path}...")

agent_cli/dev/skill/SKILL.md

@@ -47,8 +47,9 @@ agent-cli dev new <branch-name> --agent --prompt-file path/to/prompt.md
 This creates:
 1. A new git worktree with its own branch
 2. Runs project setup (installs dependencies)
-3. Opens a new terminal tab with an AI coding agent
-4. Passes your prompt to the agent
+3. Saves your prompt to `.claude/TASK.md` in the worktree (for reference)
+4. Opens a new terminal tab with an AI coding agent
+5. Passes your prompt to the agent
 
 **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.
 

agent_cli/memory/_retrieval.py

@@ -25,6 +25,7 @@ LOGGER = logging.getLogger(__name__)
 
 _DEFAULT_MMR_LAMBDA = 0.7
 _SUMMARY_ROLE = "summary"
+_MIN_MAX_EPSILON = 1e-8  # Avoid division by zero in min-max normalization
 
 
 def gather_relevant_existing_memories(
@@ -135,7 +136,7 @@ def retrieve_memory(
     include_summary: bool = True,
     mmr_lambda: float = _DEFAULT_MMR_LAMBDA,
     recency_weight: float = 0.2,
-    score_threshold: float = 0.35,
+    score_threshold: float | None = None,
     filters: dict[str, Any] | None = None,
 ) -> tuple[MemoryRetrieval, list[str]]:
     """Execute search + rerank + recency + MMR."""
@@ -161,8 +162,15 @@ def retrieve_memory(
             seen_ids.add(rec_id)
             raw_candidates.append(rec)
 
-    def _sigmoid(x: float) -> float:
-        return 1.0 / (1.0 + math.exp(-x))
+    def _min_max_normalize(scores: list[float]) -> list[float]:
+        """Normalize scores to 0-1 range using min-max scaling."""
+        if not scores:
+            return scores
+        min_score = min(scores)
+        max_score = max(scores)
+        if max_score - min_score < _MIN_MAX_EPSILON:
+            return [0.5] * len(scores)  # All scores equal
+        return [(s - min_score) / (max_score - min_score) for s in scores]
 
     def recency_score(meta: MemoryMetadata) -> float:
         dt = datetime.fromisoformat(meta.created_at)
@@ -176,10 +184,12 @@ def retrieve_memory(
     if raw_candidates:
         pairs = [(query, mem.content) for mem in raw_candidates]
         rr_scores = predict_relevance(reranker_model, pairs)
-        for mem, rr in zip(raw_candidates, rr_scores, strict=False):
-            relevance = _sigmoid(rr)
-            # Filter out low-relevance memories to reduce noise
-            if relevance < score_threshold:
+        # Normalize raw reranker scores to 0-1 range
+        normalized_scores = _min_max_normalize(rr_scores)
+
+        for mem, relevance in zip(raw_candidates, normalized_scores, strict=False):
+            # Filter out low-relevance memories if threshold is set
+            if score_threshold is not None and relevance < score_threshold:
                 continue
 
             recency = recency_score(mem.metadata)
@@ -235,7 +245,7 @@ async def augment_chat_request(
     include_global: bool = True,
     mmr_lambda: float = _DEFAULT_MMR_LAMBDA,
     recency_weight: float = 0.2,
-    score_threshold: float = 0.35,
+    score_threshold: float | None = None,
     filters: dict[str, Any] | None = None,
 ) -> tuple[ChatRequest, MemoryRetrieval | None, str, list[str]]:
     """Retrieve memory context and augment the chat request."""

agent_cli/memory/api.py

@@ -30,7 +30,7 @@ def create_app(
     max_entries: int = 500,
     mmr_lambda: float = 0.7,
     recency_weight: float = 0.2,
-    score_threshold: float = 0.35,
+    score_threshold: float | None = None,
     enable_git_versioning: bool = True,
 ) -> FastAPI:
     """Create the FastAPI app for memory-backed chat."""

agent_cli/memory/client.py

@@ -49,7 +49,7 @@ class MemoryClient:
         max_entries: int = 500,
         mmr_lambda: float = 0.7,
         recency_weight: float = 0.2,
-        score_threshold: float = 0.35,
+        score_threshold: float | None = None,
         start_watcher: bool = False,
         enable_git_versioning: bool = True,
     ) -> None:

agent_cli/memory/engine.py

@@ -236,7 +236,7 @@ async def process_chat_request(
     max_entries: int = _DEFAULT_MAX_ENTRIES,
     mmr_lambda: float = _DEFAULT_MMR_LAMBDA,
     recency_weight: float = 0.2,
-    score_threshold: float = 0.35,
+    score_threshold: float | None = None,
     postprocess_in_background: bool = True,
     enable_git_versioning: bool = False,
     filters: dict[str, Any] | None = None,

{agent_cli-0.62.0.dist-info → agent_cli-0.63.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-cli
-Version: 0.62.0
+Version: 0.63.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>

{agent_cli-0.62.0.dist-info → agent_cli-0.63.0.dist-info}/RECORD

@@ -37,7 +37,7 @@ agent_cli/core/utils.py,sha256=MHttXeGiM9qGUNxK0s6vAHthh033TDjaruqocdtMMFY,16802
 agent_cli/core/vad.py,sha256=67-EBjY-pTOf61VhrjVdDXgaNIBwWFFFccYth_1rQmg,6569
 agent_cli/core/watch.py,sha256=MKgGxxMe0yLlu78-XXqO4ferCpu_ljNr4MAzOMDsuuo,1951
 agent_cli/dev/__init__.py,sha256=doTYiUFEBpnOxsQA69HQP9AA4QHBN0DjuHSTGRq5Xbg,551
-agent_cli/dev/cli.py,sha256=dQwLqrAwLUhg7iAFmlMfdMS60W-WjrWWDD01yxFqrpU,51223
+agent_cli/dev/cli.py,sha256=KH5RYAwJLSArnXDrccDmFN7OV1C9kwLHwoHWIiJfCHQ,52120
 agent_cli/dev/project.py,sha256=wJMGKTK1rmw8letrV6l6wcLU1fkQQDjCSEixAnsvyaY,18971
 agent_cli/dev/registry.py,sha256=c6t3ClyRFPvU4GGXJT79-D-qV4FqY7W_7P-tLT7LKZs,1887
 agent_cli/dev/worktree.py,sha256=Yw8jlhkf8BeKFc6pPEazGXnUIvryvYwbUmYxTluXILs,26916
@@ -64,7 +64,7 @@ agent_cli/dev/editors/sublime.py,sha256=owEfRSMuArSeFKqk-LE2JOXaZy5QlQfHQ-l0I4k2
 agent_cli/dev/editors/vim.py,sha256=Fo-IQMPVbIiwBdOfmkFxR37f96QW6xc5LV3Pvr3u-b0,1378
 agent_cli/dev/editors/vscode.py,sha256=GOrl4FwVdDyuSn7t4lglgnVt_T6NtpjLVh1OWBxDMwE,318
 agent_cli/dev/editors/zed.py,sha256=lRMhdN_SKmHBA1ulx8x-p7Th_0EGSIv6ppAE84xobU4,515
-agent_cli/dev/skill/SKILL.md,sha256=Guod9r9in3FFmYeUoXbLCosP3JtnOzssjnJ75NacadU,4347
+agent_cli/dev/skill/SKILL.md,sha256=r_QoJR5VLrsI7h-oopfJ8o89oWM43EHgy8IYYa52q9c,4421
 agent_cli/dev/skill/examples.md,sha256=ZzCyfudBk4lMR-sz8ER9l5vi6hI3HTeUlvQorRFVol4,16405
 agent_cli/dev/terminals/__init__.py,sha256=yUTNtvs1Do2hvhx56XxyfI-5HA5mjiv0IbJuuaL9TeE,371
 agent_cli/dev/terminals/apple_terminal.py,sha256=s7GdxXPgbpSLKK1DUwjNpshQpjR5Nt1QbL_cKPefIRI,2595
@@ -88,13 +88,13 @@ agent_cli/memory/_indexer.py,sha256=iWIRG61g2O4_cUjJYDXe03hkpRO5kVAqOwDeCb7Efu0,
 agent_cli/memory/_ingest.py,sha256=_WeFLTxrlWKFpyB1KR0tUWLgEq-eevB8ytAgpq6BOlY,13649
 agent_cli/memory/_persistence.py,sha256=7TsphuYsJfJbp-294IvWmtW98G_Sag9GTm8AUGU9dtQ,5401
 agent_cli/memory/_prompt.py,sha256=ncvYM5ewLrYRP8KizdFHtPQl2cWYg0SW0VQxA8rz_9E,4667
-agent_cli/memory/_retrieval.py,sha256=szQxy1OyjetyvidUsyyijtOiYEXFk21rvBpses9r3Po,9211
+agent_cli/memory/_retrieval.py,sha256=K_2TUcgzfntBARPyf0K6VR3NIgHHJrqGFMP_53Nae_w,9778
 agent_cli/memory/_store.py,sha256=m9mD1GxjdTXpnyL-X-MIU4cj28unqxJ_azV3kwM8blM,5086
 agent_cli/memory/_streaming.py,sha256=-WlOPtH61ogCSJKQRpfYHp2gBgIIN6hIJqb5padjmpw,1379
 agent_cli/memory/_tasks.py,sha256=XgEkN_3NCVQDWafZ_rqazpAE68yQ87x-amnQKMkfPXg,1469
-agent_cli/memory/api.py,sha256=sRLvidQeg-ooxHIDHvYkkbGof-CLKvMXjdviyRU12Do,3588
-agent_cli/memory/client.py,sha256=QWzY562nLr0OlpOW2vaArzALMWLxy-vv6H-DJgJ08n0,9987
-agent_cli/memory/engine.py,sha256=V6QURnnKvvAN4hW8tuGkbgLaMbo4NB7_jdpZg0mC6n0,11649
+agent_cli/memory/api.py,sha256=riaGTOIw7g3KuDNcPtDy9wO44-D1wDtVadRj3RTT10k,3595
+agent_cli/memory/client.py,sha256=XomHhP-hPSoosORkBKSY1dW3gjheFEVqAac0b-tAULo,9994
+agent_cli/memory/engine.py,sha256=rABVC86b5wU1QxY3BM43RhvfDOxoRT7Ddm98BN_qCL4,11656
 agent_cli/memory/entities.py,sha256=_8wyJz--tNa66CEtSpl2TUN_zeHQvMzm42htnDaOr6g,1219
 agent_cli/memory/models.py,sha256=KK0wToEf-tXssYVL0hYaJlcADlJ3G2lcSXwo1UmA0VU,2352
 agent_cli/rag/__init__.py,sha256=suQDSGBUlt4_KNxz2CyVqrJw58e64T3ltfmmg2F8iQY,543
@@ -172,8 +172,8 @@ agent_cli/services/asr.py,sha256=V6SV-USnMhK-0aE-pneiktU4HpmLqenmMb-jZ-_74zU,169
 agent_cli/services/llm.py,sha256=Kwdo6pbMYI9oykF-RBe1iaL3KsYrNWTLdRSioewmsGQ,7199
 agent_cli/services/tts.py,sha256=exKo-55_670mx8dQOzVSZkv6aWYLv04SVmBcjOlD458,14772
 agent_cli/services/wake_word.py,sha256=j6Z8rsGq_vAdRevy9fkXIgLZd9UWfrIsefmTreNmM0c,4575
-agent_cli-0.62.0.dist-info/METADATA,sha256=9NRk688EZxkuThkRJOahxw-ZH6Y2yQsVHuYMpK5Qm2A,151909
-agent_cli-0.62.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-agent_cli-0.62.0.dist-info/entry_points.txt,sha256=FUv-fB2atLsPUk_RT4zqnZl1coz4_XHFwRALOKOF38s,97
-agent_cli-0.62.0.dist-info/licenses/LICENSE,sha256=majJU6S9kC8R8bW39NVBHyv32Dq50FL6TDxECG2WVts,1068
-agent_cli-0.62.0.dist-info/RECORD,,
+agent_cli-0.63.0.dist-info/METADATA,sha256=h6K2iJsMSndMhIyJyLa2pPtRmTmZeZvrpbTqsQuqYsA,151909
+agent_cli-0.63.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+agent_cli-0.63.0.dist-info/entry_points.txt,sha256=FUv-fB2atLsPUk_RT4zqnZl1coz4_XHFwRALOKOF38s,97
+agent_cli-0.63.0.dist-info/licenses/LICENSE,sha256=majJU6S9kC8R8bW39NVBHyv32Dq50FL6TDxECG2WVts,1068
+agent_cli-0.63.0.dist-info/RECORD,,