handoff-cli 0.3.5__tar.gz → 0.3.7__tar.gz

handoff_cli-0.3.7/Makefile

@@ -0,0 +1,33 @@
+.PHONY: render skills
+
+render:  ## Preview PyPI long description rendering
+	pip install -q "readme_renderer[md]" 2>/dev/null
+	python -m readme_renderer README.md > /tmp/handoff-pypi-preview.html
+	@echo "✅  /tmp/handoff-pypi-preview.html  ($(shell wc -c < /tmp/handoff-pypi-preview.html | tr -d ' ') bytes)"
+	open /tmp/handoff-pypi-preview.html
+
+# ── skill 文档同步 ──────────────────────────────────────────────────
+# handoff-ds/SKILL.md 是主文档（master），只改它。
+# 它的 frontmatter（顶部的 `---...---` 块）不同步；其下的正文会被复制到
+# 其它 backend 的 SKILL.md，并把 backend 名/缩写替换成对应值。占位符在
+# 「构建时」由 sed 替换，落盘的都是具体值——LLM 永远读不到占位符。
+SKILLS := cli/skills
+MASTER := $(SKILLS)/handoff-ds/SKILL.md
+
+skills:  ## 把 handoff-ds/SKILL.md 正文同步到其它 backend 的 SKILL.md
+	@$(call sync_skill,handoff-codex,codex,cx)
+	@$(call sync_skill,handoff-opus,opus,op)
+	@echo "done."
+
+# $(1)=目标目录  $(2)=backend 名  $(3)=run_id 缩写
+define sync_skill
+target="$(SKILLS)/$(1)/SKILL.md"; \
+tmp=$$(mktemp); \
+awk '{print} /^---[[:space:]]*$$/{n++; if(n==2) exit}' "$$target" > "$$tmp"; \
+awk 'body{print} /^---[[:space:]]*$$/{n++; if(n==2) body=1}' "$(MASTER)" \
+  | sed -e 's/deepseek/$(2)/g' \
+        -e 's/handoff-ds/handoff-$(2)/g' \
+        -e 's/0613-ds-/0613-$(3)-/g' >> "$$tmp"; \
+mv "$$tmp" "$$target"; \
+echo "synced $$target (backend=$(2))";
+endef

handoff_cli-0.3.5/README.md → handoff_cli-0.3.7/PKG-INFO

@@ -1,3 +1,12 @@
+Metadata-Version: 2.4
+Name: handoff-cli
+Version: 0.3.7
+Summary: Multi coding-agent task dispatcher — a CLI proxy for claude that sends coding tasks to configurable AI backends
+Requires-Python: >=3.9
+Requires-Dist: pyyaml<7,>=6
+Requires-Dist: textual<3,>=2
+Description-Content-Type: text/markdown
+
 <div align="center">
 <img src="https://raw.githubusercontent.com/dazuiba/handoff/main/docs/assets/handoff-hero.jpg" width="100%" alt="hero">
 
@@ -139,6 +148,15 @@ Dispatching and resuming are the AI's job (`handoff run` / `handoff resume` unde
 
 </details>
 
+<details>
+<summary><b>Can I change the TUI theme?</b></summary>
+
+<br>
+
+Yes. Inside `handoff list` and `handoff tail`, press `D` to toggle between `textual-dark` and `textual-light`. Your choice is saved automatically to `~/.handoff/tui_state.json` and restored next time you run the TUI.
+
+</details>
+
 <details>
 <summary><b>Can I dispatch several tasks at once?</b></summary>
 

handoff_cli-0.3.5/PKG-INFO → handoff_cli-0.3.7/README.md

@@ -1,12 +1,3 @@
-Metadata-Version: 2.4
-Name: handoff-cli
-Version: 0.3.5
-Summary: Multi coding-agent task dispatcher — a CLI proxy for claude that sends coding tasks to configurable AI backends
-Requires-Python: >=3.9
-Requires-Dist: pyyaml<7,>=6
-Requires-Dist: textual<3,>=2
-Description-Content-Type: text/markdown
-
 <div align="center">
 <img src="https://raw.githubusercontent.com/dazuiba/handoff/main/docs/assets/handoff-hero.jpg" width="100%" alt="hero">
 
@@ -148,6 +139,15 @@ Dispatching and resuming are the AI's job (`handoff run` / `handoff resume` unde
 
 </details>
 
+<details>
+<summary><b>Can I change the TUI theme?</b></summary>
+
+<br>
+
+Yes. Inside `handoff list` and `handoff tail`, press `D` to toggle between `textual-dark` and `textual-light`. Your choice is saved automatically to `~/.handoff/tui_state.json` and restored next time you run the TUI.
+
+</details>
+
 <details>
 <summary><b>Can I dispatch several tasks at once?</b></summary>
 

{handoff_cli-0.3.5 → handoff_cli-0.3.7}/cli/commands/list.py

@@ -47,7 +47,8 @@ def cmd_list(argv: list[str], config: Config):
                 "FROM runs ORDER BY created_at DESC LIMIT 50"
             ).fetchall()
 
-        app = RunListApp(rows, full_cwd, refresh_fn=_refresh_rows)
+        from ..config import read_tui_theme
+        app = RunListApp(rows, full_cwd, refresh_fn=_refresh_rows, theme_name=read_tui_theme())
         app.run(mouse=False)
         conn.close()
 

{handoff_cli-0.3.5 → handoff_cli-0.3.7}/cli/commands/new.py

@@ -4,9 +4,10 @@ Pre-allocates a run_id and returns the canonical .prompt.md path so the caller
 can write the prompt directly to its final archive location before dispatching.
 
 Usage:
-  handoff new --backend <name> [--slug <slug>]
+  handoff new --backend <name> [--slug <slug>] [--write]
 
-Stdout: one line — absolute path to the .prompt.md file (file is NOT created).
+Stdout: one line — absolute path to the .prompt.md file.
+By default the file is not created. With --write, stdin is written to the file.
 """
 
 from __future__ import annotations
@@ -26,9 +27,10 @@ from ..config import Config
 
 
 def cmd_new(argv: list[str], config: Config):
-    """handoff new --backend <name> [--slug <slug>]"""
+    """handoff new --backend <name> [--slug <slug>] [--write]"""
     backend_arg = ""
     slug_arg = ""
+    write_prompt = False
 
     i = 0
     while i < len(argv):
@@ -49,6 +51,8 @@ def cmd_new(argv: list[str], config: Config):
             slug_arg = argv[i]
         elif a.startswith("--slug="):
             slug_arg = a.split("=", 1)[1]
+        elif a == "--write":
+            write_prompt = True
         elif a in ("-h", "--help"):
             from ..main import usage
             usage()
@@ -85,4 +89,12 @@ def cmd_new(argv: list[str], config: Config):
     run_id = f"{mmdd}-{b2}-{seq_code}-{clean_slug}"
     prompt_path = os.path.join(TASKS_DIR, f"{run_id}.prompt.md")
 
+    if write_prompt:
+        if sys.stdin.isatty():
+            print("handoff new: --write requires prompt text on stdin", file=sys.stderr)
+            sys.exit(2)
+        os.makedirs(os.path.dirname(prompt_path), exist_ok=True)
+        with open(prompt_path, "w") as f:
+            f.write(sys.stdin.read())
+
     print(prompt_path)

{handoff_cli-0.3.5 → handoff_cli-0.3.7}/cli/commands/resume.py

@@ -27,7 +27,7 @@ from ..config import Config
 
 
 def cmd_resume(argv: list[str], config: Config):
-    """handoff resume [<run-id|seq>] [--backend <name>] [--pro] [--cwd <dir>]
+    """handoff resume [<run-id|seq>] [--backend <name>] [--slug <slug>] [--pro] [--cwd <dir>]
     [--verbose] [(<input-file|-> | --text <prompt...>)]."""
     # Pre-scan --verbose so it works regardless of position (e.g. after --text).
     verbose = "--verbose" in argv
@@ -36,6 +36,7 @@ def cmd_resume(argv: list[str], config: Config):
     pro = False
     cwd = ""
     backend_arg = ""
+    slug_arg = ""
     selector = ""
     input_src = ""
     text_mode = False
@@ -61,6 +62,14 @@ def cmd_resume(argv: list[str], config: Config):
             backend_arg = filtered[i]
         elif a.startswith("--backend="):
             backend_arg = a.split("=", 1)[1]
+        elif a == "--slug":
+            i += 1
+            if i >= len(filtered):
+                print("handoff resume: --slug requires a value", file=sys.stderr)
+                sys.exit(2)
+            slug_arg = filtered[i]
+        elif a.startswith("--slug="):
+            slug_arg = a.split("=", 1)[1]
         elif a == "--text":
             text_mode = True
             if input_src:
@@ -159,7 +168,16 @@ def cmd_resume(argv: list[str], config: Config):
         # Non-interactive: dispatch a new turn through the run pipeline.
         conn.close()
         from .run import _execute
-        _execute(cwd, prompt_text, backend_name, pro, config, resume_session_id=session_id, verbose=verbose)
+        _execute(
+            cwd,
+            prompt_text,
+            backend_name,
+            pro,
+            config,
+            resume_session_id=session_id,
+            slug=slug_arg or "resume",
+            verbose=verbose,
+        )
 
 
 def _resume_interactive(config: Config, backend_name: str, session_id: str, cwd: str, pro: bool, verbose: bool = False):

{handoff_cli-0.3.5 → handoff_cli-0.3.7}/cli/commands/run.py

@@ -40,7 +40,7 @@ def _is_adopted_path(input_src: str) -> bool:
 
 
 def cmd_run(argv: list[str], config: Config):
-    """handoff run [--backend <name>] [--cwd <dir>] [--pro] [--verbose] (<input-file|-> | --text <prompt...>)."""
+    """handoff run [--backend <name>] [--cwd <dir>] [--slug <slug>] [--pro] [--verbose] (<input-file|-> | --text <prompt...>)."""
     # Pre-scan --verbose so it works regardless of position (e.g. after --text).
     verbose = "--verbose" in argv
     filtered = [a for a in argv if a != "--verbose"]
@@ -48,6 +48,7 @@ def cmd_run(argv: list[str], config: Config):
     pro = False
     cwd = ""
     backend_arg = ""
+    slug_arg = ""
     input_src = ""
     text_mode = False
     text_parts = []
@@ -71,6 +72,14 @@ def cmd_run(argv: list[str], config: Config):
             backend_arg = filtered[i]
         elif a.startswith("--backend="):
             backend_arg = a.split("=", 1)[1]
+        elif a == "--slug":
+            i += 1
+            if i >= len(filtered):
+                print("handoff run: --slug requires a value", file=sys.stderr)
+                sys.exit(2)
+            slug_arg = filtered[i]
+        elif a.startswith("--slug="):
+            slug_arg = a.split("=", 1)[1]
         elif a == "--text":
             text_mode = True
             if input_src:
@@ -130,10 +139,10 @@ def cmd_run(argv: list[str], config: Config):
         if not prompt_text:
             print("handoff run: --text requires a non-empty value", file=sys.stderr)
             sys.exit(2)
-        slug = "from-text"
+        slug = slug_arg or "from-text"
     elif input_src == "-" or (not input_src and not sys.stdin.isatty()):
         prompt_text = sys.stdin.read()
-        slug = "from-stdin"
+        slug = slug_arg or "from-stdin"
     elif input_src:
         if not os.path.isfile(input_src):
             print(f"handoff run: input file not found: {input_src}", file=sys.stderr)
@@ -164,7 +173,7 @@ def cmd_run(argv: list[str], config: Config):
         else:
             with open(input_src) as f:
                 prompt_text = f.read()
-            slug = "from-file"
+            slug = slug_arg or "from-file"
     else:
         print("handoff run: input file required, or use --text <prompt...> / pipe via '-'", file=sys.stderr)
         sys.exit(2)

{handoff_cli-0.3.5 → handoff_cli-0.3.7}/cli/commands/tail.py

@@ -44,5 +44,6 @@ def cmd_tail(argv: list[str], config=None):
         "out_path": out_path,
     }
 
+    from ..config import read_tui_theme
     from ..jsonl_viewer import run_tail
-    run_tail(jsonl_path, prompt_path, result_path, run_info)
+    run_tail(jsonl_path, prompt_path, result_path, run_info, theme_name=read_tui_theme())

{handoff_cli-0.3.5 → handoff_cli-0.3.7}/cli/config.py

@@ -18,6 +18,7 @@ Backend resolution:
 
 from __future__ import annotations
 
+import json
 import os
 import re
 import sys
@@ -35,6 +36,50 @@ except ImportError:
 
 _BACKEND_TYPES_PATH = os.path.join(os.path.dirname(__file__), "backend_types.yaml")
 _USER_CONFIG_TEMPLATE_PATH = os.path.join(os.path.dirname(__file__), "user_config_template.yaml")
+DEFAULT_DARK_THEME = "textual-dark"
+DEFAULT_LIGHT_THEME = "textual-light"
+
+# ── TUI state persistence (theme, independent from config.yaml) ──────────
+
+_TUI_STATE_FILENAME = "tui_state.json"
+
+
+def _tui_state_path() -> str:
+    return os.path.join(user_config_dir(), _TUI_STATE_FILENAME)
+
+
+def read_tui_theme() -> str:
+    """Read the persisted TUI theme name from ``~/.handoff/tui_state.json``.
+
+    Falls back to ``textual-dark`` when the file is missing, corrupt, or
+    the stored theme name is empty / invalid.  Never raises.
+    """
+    path = _tui_state_path()
+    try:
+        if os.path.isfile(path):
+            with open(path, "r") as f:
+                data = json.load(f)
+            theme = data.get("theme", "")
+            if isinstance(theme, str) and theme.strip():
+                return theme.strip()
+    except (OSError, json.JSONDecodeError, ValueError):
+        pass
+    return DEFAULT_DARK_THEME
+
+
+def write_tui_theme(theme: str) -> None:
+    """Persist the TUI theme name to ``~/.handoff/tui_state.json``.
+
+    Best-effort: failures are silently ignored so the app never crashes
+    on a write.
+    """
+    path = _tui_state_path()
+    try:
+        os.makedirs(os.path.dirname(path), exist_ok=True)
+        with open(path, "w") as f:
+            json.dump({"theme": theme}, f)
+    except OSError:
+        pass
 
 # Top-level config keys that belong to the mechanism layer or are otherwise
 # removed.  Warn once and ignore.  system_prompt is deliberately absent from

{handoff_cli-0.3.5 → handoff_cli-0.3.7}/cli/jsonl_parser.py

@@ -7,6 +7,8 @@ import json
 from dataclasses import dataclass
 from typing import TextIO
 
+from rich.text import Text
+
 
 @dataclass
 class ParsedEvent:
@@ -160,6 +162,46 @@ def format_event_for_viewer(event: ParsedEvent) -> str | None:
     return f"`{ts}` {kind_mark} {_truncate(event.text)}"
 
 
+def format_event_as_rich(event: ParsedEvent) -> Text | None:
+    """Format one parsed event as a rich Text with styled spans.
+
+    Returns None for result_text/error_text events (handled separately by
+    the viewer as Markdown content).  The returned Text uses colour/emphasis
+    per kind: tool=cyan, text=default, result=green, error=red, task=yellow,
+    info=dim.
+    """
+    if event.kind in ("result_text", "error_text"):
+        return None
+
+    ts = event.ts or " " * 8
+    mark_map = {
+        "tool": "▷",
+        "text": "✎",
+        "result": "✓",
+        "error": "✗",
+        "task": "▶",
+        "info": "·",
+    }
+    colour_map = {
+        "tool": "cyan",
+        "text": "",
+        "result": "green",
+        "error": "red",
+        "task": "yellow",
+        "info": "dim",
+    }
+    mark = mark_map.get(event.kind, " ")
+    colour = colour_map.get(event.kind, "")
+
+    text = Text()
+    text.append(f"{ts:8}", style="dim")
+    text.append(" │ ", style="dim")
+    text.append(mark, style=colour)
+    text.append(" ")
+    text.append(_truncate(event.text))
+    return text
+
+
 def format_event_for_stream(event: ParsedEvent) -> str | None:
     """Return the single-line text stream shown during `handoff run`."""
     if event.kind != "text":