@mindfoldhq/trellis 0.6.2 → 0.6.4

package/dist/configurators/zcode.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ZCode configurator.
+ *
+ * ZCode (智谱) is a pull-based class-2 platform (agentCapable, no hooks).
+ * Three output paths:
+ * - `.agents/skills/` — shared skills, byte-identical with Codex/Gemini writes
+ * - `.zcode/commands/trellis/` — slash commands (invoked as /trellis:<name>)
+ * - `.zcode/cli/agents/` — sub-agent definitions with pull-based prelude
+ */
+/**
+ * Collect all ZCode template files for `trellis update` diff tracking.
+ * Must stay in sync with `configureZcode`.
+ */
+export declare function collectZcodeTemplates(): Map<string, string>;
+/**
+ * Configure ZCode at init time: write shared skills, commands, and sub-agents.
+ */
+export declare function configureZcode(cwd: string): Promise<void>;
+//# sourceMappingURL=zcode.d.ts.map

package/dist/configurators/zcode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zcode.d.ts","sourceRoot":"","sources":["../../src/configurators/zcode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAyB3D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB/D"}

package/dist/configurators/zcode.js

@@ -0,0 +1,54 @@
+/**
+ * ZCode configurator.
+ *
+ * ZCode (智谱) is a pull-based class-2 platform (agentCapable, no hooks).
+ * Three output paths:
+ * - `.agents/skills/` — shared skills, byte-identical with Codex/Gemini writes
+ * - `.zcode/commands/trellis/` — slash commands (invoked as /trellis:<name>)
+ * - `.zcode/cli/agents/` — sub-agent definitions with pull-based prelude
+ */
+import path from "node:path";
+import { AI_TOOLS } from "../types/ai-tools.js";
+import { ensureDir, writeFile } from "../utils/file-writer.js";
+import { getAllAgents } from "../templates/zcode/index.js";
+import { collectSkillTemplates, resolveAllAsSkillsNeutral, resolveBundledSkills, resolveCommands, writeSkills, writeAgents, applyPullBasedPreludeMarkdown, } from "./shared.js";
+/**
+ * Collect all ZCode template files for `trellis update` diff tracking.
+ * Must stay in sync with `configureZcode`.
+ */
+export function collectZcodeTemplates() {
+    const config = AI_TOOLS.zcode;
+    const ctx = config.templateContext;
+    const files = new Map();
+    // 1. Shared skills → .agents/skills/ (byte-identical with Codex/Gemini)
+    for (const [filePath, content] of collectSkillTemplates(".agents/skills", resolveAllAsSkillsNeutral(ctx), resolveBundledSkills(ctx))) {
+        files.set(filePath, content);
+    }
+    // 2. Commands → .zcode/commands/trellis/
+    for (const cmd of resolveCommands(ctx)) {
+        files.set(`.zcode/commands/trellis/${cmd.name}.md`, cmd.content);
+    }
+    // 3. Sub-agents → .zcode/cli/agents/ (with pull-based prelude)
+    for (const agent of applyPullBasedPreludeMarkdown(getAllAgents())) {
+        files.set(`.zcode/cli/agents/${agent.name}.md`, agent.content);
+    }
+    return files;
+}
+/**
+ * Configure ZCode at init time: write shared skills, commands, and sub-agents.
+ */
+export async function configureZcode(cwd) {
+    const config = AI_TOOLS.zcode;
+    const ctx = config.templateContext;
+    // 1. Shared skills → .agents/skills/
+    await writeSkills(path.join(cwd, ".agents", "skills"), resolveAllAsSkillsNeutral(ctx), resolveBundledSkills(ctx));
+    // 2. Commands → .zcode/commands/trellis/
+    const commandsDir = path.join(cwd, ".zcode", "commands", "trellis");
+    ensureDir(commandsDir);
+    for (const cmd of resolveCommands(ctx)) {
+        await writeFile(path.join(commandsDir, `${cmd.name}.md`), cmd.content);
+    }
+    // 3. Sub-agents → .zcode/cli/agents/ (with pull-based prelude)
+    await writeAgents(path.join(cwd, ".zcode", "cli", "agents"), applyPullBasedPreludeMarkdown(getAllAgents()));
+}
+//# sourceMappingURL=zcode.js.map

package/dist/configurators/zcode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zcode.js","sourceRoot":"","sources":["../../src/configurators/zcode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,WAAW,EACX,6BAA6B,GAC9B,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,wEAAwE;IACxE,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,qBAAqB,CACrD,gBAAgB,EAChB,yBAAyB,CAAC,GAAG,CAAC,EAC9B,oBAAoB,CAAC,GAAG,CAAC,CAC1B,EAAE,CAAC;QACF,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,yCAAyC;IACzC,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,GAAG,CAAC,2BAA2B,GAAG,CAAC,IAAI,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,+DAA+D;IAC/D,KAAK,MAAM,KAAK,IAAI,6BAA6B,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC;QAClE,KAAK,CAAC,GAAG,CAAC,qBAAqB,KAAK,CAAC,IAAI,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC;IAEnC,qCAAqC;IACrC,MAAM,WAAW,CACf,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,EACnC,yBAAyB,CAAC,GAAG,CAAC,EAC9B,oBAAoB,CAAC,GAAG,CAAC,CAC1B,CAAC;IAEF,yCAAyC;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACpE,SAAS,CAAC,WAAW,CAAC,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,+DAA+D;IAC/D,MAAM,WAAW,CACf,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,EACzC,6BAA6B,CAAC,YAAY,EAAE,CAAC,CAC9C,CAAC;AACJ,CAAC"}

package/dist/migrations/manifests/0.6.3.json

@@ -0,0 +1,24 @@
+{
+  "version": "0.6.3",
+  "description": "Patch release: ZCode (智谱) platform, opt-in --with-statusline for Claude Code, Pi session mem adapter, first-principles + bayesian thinking frameworks in the brainstorm/break-loop skills, the Windsurf -> Devin platform rename (.windsurf/ -> .devin/, --windsurf kept as a deprecated alias), and fixes for #300 (Windows mem --cwd) and #303 (.trellis auto-commit staging scope).",
+  "breaking": false,
+  "recommendMigrate": true,
+  "changelog": "**Enhancements:**\n- feat(platform): **ZCode (`--zcode`).** Added ZCode (智谱 / Z.ai) as a pull-based, agent-capable platform (no hooks). `trellis init --zcode` writes `.agents/skills/`, `.zcode/commands/trellis/`, and `.zcode/cli/agents/` (`trellis-implement` / `trellis-check`). Registry `AI_TOOLS.zcode`, configurator `configureZcode` in `src/configurators/zcode.ts`.\n- feat(init): **`trellis init --with-statusline`.** Opt-in Claude Code status bar (off by default; interactive prompt when the flag is omitted, skipped under `-y`). Writes `.claude/hooks/statusline.py` and a `statusLine` entry in `.claude/settings.json`. Not part of `collectTemplates`/shared-hooks, so `trellis update` never force-installs or removes it.\n- feat(mem): **Pi session adapter.** `trellis mem --platform pi` (and `all`) now reads persisted Pi Agent sessions via `packages/core/src/mem/adapters/pi.ts`. Discovers `~/.pi/agent/sessions/`, honors `PI_CODING_AGENT_DIR` / `PI_CODING_AGENT_SESSION_DIR`, and slices phases in `sliceMemPhase` like Claude/Codex.\n- feat(platform): **Windsurf is now Devin.** Cognition renamed Windsurf to Devin Desktop (2026-06-02 OTA) and moved the config dir from `.windsurf/` to `.devin/`. `trellis init --devin` writes `.devin/workflows/` + `.devin/skills/` and passes `--platform devin` (#325). `--windsurf` remains a deprecated alias for one version.\n- feat(skills): **Thinking frameworks.** `brainstorm` gains a First Principles Analysis framework (decompose to fundamentals during requirement discovery) and `break-loop` gains a Bayesian Reasoning framework (weight hypotheses by evidence during debugging), both in `common/skills/` so all platforms get them on update. Hardcoded \"5 skills\" comments replaced with count-free wording (#335).\n\n**Bug Fixes:**\n- fix(mem): **`--cwd` Claude filter on Windows (#300).** `trellis mem --cwd` returned 0 Claude sessions on Windows because `claudeProjectDirFromCwd` only sanitized `/` and `_`. The regex now covers all separators (`/[/\\\\:_.]/g`) and `claudeListSessions` falls back to scanning every project dir when the derived dir is missing.\n- fix(commit): **`.trellis` auto-commit staging scope (#303).** Scoped `.trellis/` auto-commit so it no longer sweeps unrelated parallel-window task dirs into session commits. `safe_trellis_paths_to_add()` takes a `task_name`; `_auto_commit_workspace()` resolves the current task via `get_current_task()`; `release.js` `git add -A` now excludes `':!.trellis'`.\n\n**Migration:** Only the Windsurf → Devin rename needs `trellis update --migrate` — and only if you initialized with `--windsurf`. It ships idempotent `rename-dir` migrations (`.windsurf/workflows/` → `.devin/workflows/`, `.windsurf/skills/` → `.devin/skills/`); projects without a `.windsurf/` directory are silently skipped.",
+  "migrations": [
+    {
+      "type": "rename-dir",
+      "from": ".windsurf/workflows",
+      "to": ".devin/workflows",
+      "description": "Devin (formerly Windsurf): move installed workflows from the old .windsurf/ config dir to .devin/ (Windsurf was renamed to Devin Desktop).",
+      "reason": "Cognition renamed Windsurf to Devin Desktop and moved its config dir from .windsurf/ to .devin/. Trellis renamed the platform to match."
+    },
+    {
+      "type": "rename-dir",
+      "from": ".windsurf/skills",
+      "to": ".devin/skills",
+      "description": "Devin (formerly Windsurf): move installed skills from the old .windsurf/ config dir to .devin/ (Windsurf was renamed to Devin Desktop).",
+      "reason": "Cognition renamed Windsurf to Devin Desktop and moved its config dir from .windsurf/ to .devin/. Trellis renamed the platform to match."
+    }
+  ],
+  "notes": "Windsurf → Devin rename (#325). If you initialized Trellis with `--windsurf`, run `trellis update --migrate` to move your installed `.windsurf/workflows/` and `.windsurf/skills/` directories to `.devin/`. Projects without a `.windsurf/` directory are unaffected (the migration silently skips). `--windsurf` still works as a deprecated alias for `--devin` this release.\n\nInstall: `npm install -g @mindfoldhq/trellis`"
+}

package/dist/migrations/manifests/0.6.4.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.6.4",
+  "description": "Patch release: fixes Kiro main-session workflow injection (deterministic activation via userPromptSubmit + agentSpawn) and emits `trellis-start` on agentCapable && !hasHooks platforms (Codex, ZCode, OpenCode, Reasonix) by narrowing the filterCommands condition. Also extends `workflow.md` platform-matrix blocks to cover ZCode and Reasonix.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix(configurators): emit `trellis-start` on `agentCapable && !hasHooks` platforms (Codex, ZCode, OpenCode, Reasonix). `filterCommands(ctx)` in `packages/cli/src/configurators/shared.ts` now strips `start` only when both `agentCapable` and `hasHooks` are true. Prior condition removed `start` from every agent-capable platform, leaving the four no-hook platforms without a way to load workflow context. Codex's one-off `resolveCodexTrellisStartSkill` helper and its two call sites are deleted; the standard `resolveAllAsSkillsNeutral` / `resolveCommands` paths now emit the skill / command naturally. Triggered by external user report: `trellis init --zcode` produced neither `/trellis:start` nor a `trellis-start` skill.\n- fix(workflow.md): add ZCode and Reasonix to the platform-matrix blocks they were missing from. 13 edit points in `packages/cli/src/templates/trellis/workflow.md`: B1/B3/B5/B7/B12 sub-agent dispatch blocks (Active Task Routing, Phase 1.2 Research, Phase 1.3 Configure context, Phase 1.5 Completion criteria, Phase 2.2 Quality check), B9 class-2 pull-based block (`[codex-sub-agent]` → `[codex-sub-agent, ZCode, Reasonix]`), and the line 186 prose enumeration. B8 (`hook/plugin auto-handles`) deliberately left unchanged — that claim is false for pull-based platforms.\n- fix(kiro): wire per-turn workflow injection for the main session. Pre-0.6.4 Kiro projects had no deterministic Trellis activation — only the three sub-agent JSONs registered `agentSpawn` hooks, the main session had none. Adds main agent `.kiro/agents/trellis.json` (`userPromptSubmit` → `inject-workflow-state.py`, `agentSpawn` → `session-start.py`, `workflow.md` as always-loaded resource) and IDE `.kiro/hooks/trellis-workflow-state.kiro.hook` (promptSubmit → runCommand). `inject-workflow-state.py` + `session-start.py` add an isolated `platform == \"kiro\"` branch that prints plain stdout (Kiro injects it as context; no `hookSpecificOutput` envelope); other platforms byte-unchanged. `SHARED_HOOKS_BY_PLATFORM.kiro` gains both scripts.",
+  "migrations": [],
+  "notes": "Two bug fixes. No `--migrate` required.\n\nKiro users: existing projects must run `trellis update` to receive the new main-session agent and hook (`.kiro/agents/trellis.json`, `.kiro/hooks/trellis-workflow-state.kiro.hook`, updated shared hooks).\n\nZCode / OpenCode / Reasonix users: `trellis update` produces the previously missing `trellis-start` skill / `/trellis:start` slash command. Codex output is byte-identical (same template, same resolver, same wrapper — `update` will not flag user-modified).\n\nInstall: `npm install -g @mindfoldhq/trellis`"
+}

package/dist/templates/claude/hooks/statusline.py

@@ -0,0 +1,324 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Trellis StatusLine — project-level status display for Claude Code.
+
+Reads Claude Code session JSON from stdin + Trellis task data from filesystem.
+Outputs 1-2 lines:
+  With active task:  [P1] Task title (status)  +  info line
+  Without task:      info line only
+Info line: model · ctx% · branch · duration · developer · tasks · rate limits
+When COLUMNS (injected by Claude Code v2.1.153+) is too narrow for the info
+line, the rate-limit segments move to their own line via an explicit "\n".
+"""
+from __future__ import annotations
+
+import json
+import os
+import re
+import subprocess
+import sys
+import time
+from datetime import datetime
+from pathlib import Path
+
+# Fix: Windows Python defaults to GBK encoding, which corrupts UTF-8
+# characters like the middle dot (·). Wrap stdout/stderr with UTF-8.
+if sys.platform == "win32":
+    for stream in (sys.stdout, sys.stderr):
+        reconfigure = getattr(stream, "reconfigure", None)
+        if callable(reconfigure):
+            reconfigure(encoding="utf-8", errors="replace")
+
+
+def _read_text(path: Path) -> str:
+    try:
+        return path.read_text(encoding="utf-8").strip()
+    except (FileNotFoundError, PermissionError, OSError):
+        return ""
+
+
+def _read_json(path: Path) -> dict:
+    text = _read_text(path)
+    if not text:
+        return {}
+    try:
+        return json.loads(text)
+    except (json.JSONDecodeError, ValueError):
+        return {}
+
+
+def _normalize_task_ref(task_ref: str) -> str:
+    normalized = task_ref.strip()
+    if not normalized:
+        return ""
+
+    path_obj = Path(normalized)
+    if path_obj.is_absolute():
+        return str(path_obj)
+
+    normalized = normalized.replace("\\", "/")
+    while normalized.startswith("./"):
+        normalized = normalized[2:]
+
+    if normalized.startswith("tasks/"):
+        return f".trellis/{normalized}"
+
+    return normalized
+
+
+def _resolve_task_dir(trellis_dir: Path, task_ref: str) -> Path:
+    normalized = _normalize_task_ref(task_ref)
+    path_obj = Path(normalized)
+    if path_obj.is_absolute():
+        return path_obj
+    if normalized.startswith(".trellis/"):
+        return trellis_dir.parent / path_obj
+    return trellis_dir / "tasks" / path_obj
+
+
+def _find_trellis_dir() -> Path | None:
+    """Walk up from cwd to find .trellis/ directory."""
+    current = Path.cwd()
+    for parent in [current, *current.parents]:
+        candidate = parent / ".trellis"
+        if candidate.is_dir():
+            return candidate
+    return None
+
+
+def _get_current_task(trellis_dir: Path) -> dict | None:
+    """Load current task info through Trellis' active task resolver."""
+    return _get_current_task_for_input(trellis_dir, {})
+
+
+def _get_current_task_for_input(trellis_dir: Path, cc_data: dict) -> dict | None:
+    """Load current task info for the Claude Code session JSON."""
+    scripts_dir = trellis_dir / "scripts"
+    if str(scripts_dir) not in sys.path:
+        sys.path.insert(0, str(scripts_dir))
+    try:
+        from common.active_task import resolve_active_task  # type: ignore[import-not-found]
+    except Exception:
+        return None
+
+    active = resolve_active_task(trellis_dir.parent, cc_data, platform="claude")
+    if not active.task_path:
+        return None
+
+    task_path = _resolve_task_dir(trellis_dir, active.task_path)
+    if active.stale:
+        return {
+            "title": task_path.name,
+            "status": "stale",
+            "priority": "P?",
+            "source": active.source,
+        }
+
+    task_data = _read_json(task_path / "task.json")
+    if not task_data:
+        return None
+
+    return {
+        "title": task_data.get("title") or task_data.get("name") or "unknown",
+        "status": task_data.get("status", "unknown"),
+        "priority": task_data.get("priority", "P2"),
+        "source": active.source,
+    }
+
+
+def _count_active_tasks(trellis_dir: Path) -> int:
+    """Count non-archived task directories with valid task.json."""
+    tasks_dir = trellis_dir / "tasks"
+    if not tasks_dir.is_dir():
+        return 0
+    count = 0
+    for d in tasks_dir.iterdir():
+        if d.is_dir() and d.name != "archive" and (d / "task.json").is_file():
+            count += 1
+    return count
+
+
+def _get_developer(trellis_dir: Path) -> str:
+    content = _read_text(trellis_dir / ".developer")
+    if not content:
+        return "unknown"
+    for line in content.splitlines():
+        if line.startswith("name="):
+            return line[5:].strip()
+    return content.splitlines()[0].strip() or "unknown"
+
+
+def _get_git_branch() -> str:
+    try:
+        result = subprocess.run(
+            ["git", "branch", "--show-current"],
+            capture_output=True, text=True, timeout=3,
+        )
+        return result.stdout.strip() if result.returncode == 0 else ""
+    except (FileNotFoundError, subprocess.TimeoutExpired):
+        return ""
+
+
+def _format_ctx_size(size: int) -> str:
+    if size >= 1_000_000:
+        return f"{size // 1_000_000}M"
+    if size >= 1_000:
+        return f"{size // 1_000}K"
+    return str(size)
+
+
+def _format_duration(ms: int) -> str:
+    secs = ms // 1000
+    hours, remainder = divmod(secs, 3600)
+    mins = remainder // 60
+    if hours > 0:
+        return f"{hours}h{mins}m"
+    return f"{mins}m"
+
+
+def _format_remaining(secs: int) -> str:
+    if secs <= 0:
+        return ""
+    days, remainder = divmod(secs, 86400)
+    hours, remainder = divmod(remainder, 3600)
+    mins = remainder // 60
+    if days > 0:
+        return f"{days}d{hours}h"
+    if hours > 0:
+        return f"{hours}h{mins}m"
+    return f"{mins}m"
+
+
+def _parse_resets_at(value: object) -> int:
+    """`resets_at` is epoch seconds (int/float, possibly stringified) or an
+    ISO-8601 timestamp depending on Claude Code version. Return epoch
+    seconds, or 0 when absent/unparseable (countdown is then omitted)."""
+    if isinstance(value, (int, float)):
+        return int(value)
+    if isinstance(value, str) and value:
+        try:
+            return int(float(value))
+        except ValueError:
+            pass
+        try:
+            parsed = datetime.fromisoformat(value.replace("Z", "+00:00"))
+            return int(parsed.timestamp())
+        except ValueError:
+            pass
+    return 0
+
+
+def _rate_limit_part(label: str, window: dict, now: int) -> str:
+    try:
+        pct = int(float(window.get("used_percentage")))  # pyright: ignore[reportArgumentType]
+    except (TypeError, ValueError):
+        return ""
+    part = f"{label} {pct}%"
+    remaining = _format_remaining(_parse_resets_at(window.get("resets_at")) - now)
+    if remaining:
+        part += f" \033[90m(reset {remaining})\033[0m"
+    return part
+
+
+_ANSI_RE = re.compile(r"\x1b\[[0-9;]*m")
+
+
+def _visible_len(s: str) -> int:
+    """Length of s with ANSI escape sequences stripped."""
+    return len(_ANSI_RE.sub("", s))
+
+
+def _terminal_width() -> int | None:
+    """Terminal width from the COLUMNS env var, or None.
+
+    The statusline stdin JSON has no width field and stdout is a pipe, so
+    the COLUMNS env var (injected by Claude Code v2.1.153+) is the only
+    width signal. Absent or malformed values return None."""
+    try:
+        width = int(os.environ.get("COLUMNS", ""))
+    except ValueError:
+        return None
+    return width if width > 0 else None
+
+
+def main() -> None:
+    # Read Claude Code session JSON from stdin
+    try:
+        cc_data = json.loads(sys.stdin.read())
+    except (json.JSONDecodeError, ValueError):
+        cc_data = {}
+
+    trellis_dir = _find_trellis_dir()
+    SEP = " \033[90m·\033[0m "
+
+    # --- Trellis data ---
+    task = _get_current_task_for_input(trellis_dir, cc_data) if trellis_dir else None
+    dev = _get_developer(trellis_dir) if trellis_dir else ""
+    task_count = _count_active_tasks(trellis_dir) if trellis_dir else 0
+
+    # --- CC session data ---
+    model = cc_data.get("model", {}).get("display_name", "?")
+    ctx_pct = int(cc_data.get("context_window", {}).get("used_percentage") or 0)
+    ctx_size = _format_ctx_size(cc_data.get("context_window", {}).get("context_window_size") or 0)
+    duration = _format_duration(cc_data.get("cost", {}).get("total_duration_ms") or 0)
+    branch = _get_git_branch()
+
+    # Avoid "Opus 4.6 (1M context) (1M)"
+    if re.search(r"\d+[KMG]\b", model, re.IGNORECASE):
+        model_label = model
+    else:
+        model_label = f"{model} ({ctx_size})"
+
+    # Context % with color
+    if ctx_pct >= 90:
+        ctx_color = "\033[31m"
+    elif ctx_pct >= 70:
+        ctx_color = "\033[33m"
+    else:
+        ctx_color = "\033[32m"
+
+    # Build info line: model · ctx · branch · duration · dev · tasks [· rate limits]
+    parts = [
+        model_label,
+        f"ctx {ctx_color}{ctx_pct}%\033[0m",
+    ]
+    if branch:
+        parts.append(f"\033[35m{branch}\033[0m")
+    parts.append(duration)
+    if dev:
+        parts.append(f"\033[32m{dev}\033[0m")
+    if task_count:
+        parts.append(f"{task_count} task(s)")
+
+    now = int(time.time())
+    rate_limits = cc_data.get("rate_limits", {})
+    rate_parts: list[str] = []
+    for label, key in (("5h", "five_hour"), ("7d", "seven_day")):
+        part = _rate_limit_part(label, rate_limits.get(key) or {}, now)
+        if part:
+            rate_parts.append(part)
+
+    info_line = SEP.join(parts + rate_parts)
+
+    # Output: task line (only if active) + info line
+    if task:
+        source = str(task.get("source") or "")
+        source_tag = "session" if source.startswith("session:") else source
+        source_suffix = f" \033[90m[{source_tag}]\033[0m" if source_tag else ""
+        print(f"\033[36m[{task['priority']}]\033[0m {task['title']} \033[33m({task['status']})\033[0m{source_suffix}")
+
+    # Claude Code's status-bar height counts only "\n" characters, so a
+    # visually wrapped long line misaligns rows. When the host provides a
+    # terminal width and the info line would overflow, split the rate-limit
+    # segments onto their own line with an explicit "\n" instead.
+    width = _terminal_width()
+    if width is not None and rate_parts and _visible_len(info_line) > width:
+        print(SEP.join(parts))
+        print(SEP.join(rate_parts))
+    else:
+        print(info_line)
+
+
+if __name__ == "__main__":
+    main()

package/dist/templates/claude/index.d.ts

@@ -4,9 +4,10 @@
  * Directory structure:
  *   claude/
  *   ├── agents/         # Sub-agent definitions
+ *   ├── hooks/          # Claude-only opt-in hooks (statusline.py)
  *   └── settings.json   # Settings configuration
  *
- * Hooks come from shared-hooks/ (unified with other platforms).
+ * Default hooks come from shared-hooks/ (unified with other platforms).
  */
 export declare const settingsTemplate: string;
 export interface AgentTemplate {
@@ -19,4 +20,12 @@ export interface SettingsTemplate {
 }
 export declare function getAllAgents(): AgentTemplate[];
 export declare function getSettingsTemplate(): SettingsTemplate;
+/**
+ * Opt-in statusLine hook, installed only via `trellis init --with-statusline`.
+ *
+ * Lives under claude/hooks/ (not shared-hooks/) because `statusLine` is a
+ * Claude-only event, and is intentionally NOT part of `collectTemplates` —
+ * `trellis update` must never force-install it on opted-out projects.
+ */
+export declare function getStatuslineHook(): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/templates/claude/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqBH,eAAO,MAAM,gBAAgB,QAAgC,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAa9C;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqBH,eAAO,MAAM,gBAAgB,QAAgC,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAa9C;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/templates/claude/index.js

@@ -4,9 +4,10 @@
  * Directory structure:
  *   claude/
  *   ├── agents/         # Sub-agent definitions
+ *   ├── hooks/          # Claude-only opt-in hooks (statusline.py)
  *   └── settings.json   # Settings configuration
  *
- * Hooks come from shared-hooks/ (unified with other platforms).
+ * Default hooks come from shared-hooks/ (unified with other platforms).
  */
 import { readdirSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -43,4 +44,14 @@ export function getSettingsTemplate() {
         content: settingsTemplate,
     };
 }
+/**
+ * Opt-in statusLine hook, installed only via `trellis init --with-statusline`.
+ *
+ * Lives under claude/hooks/ (not shared-hooks/) because `statusLine` is a
+ * Claude-only event, and is intentionally NOT part of `collectTemplates` —
+ * `trellis update` must never force-install it on opted-out projects.
+ */
+export function getStatuslineHook() {
+    return readTemplate("hooks/statusline.py");
+}
 //# sourceMappingURL=index.js.map

package/dist/templates/claude/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAY9D,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,gBAAgB;KAC1B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAY9D,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,gBAAgB;KAC1B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,YAAY,CAAC,qBAAqB,CAAC,CAAC;AAC7C,CAAC"}

package/dist/templates/common/bundled-skills/trellis-meta/SKILL.md

@@ -7,15 +7,15 @@ description: "Understand and customize the local Trellis architecture inside a u
 
 This skill is for local Trellis users who have already run `trellis init` in a project. After reading it, an AI should understand the Trellis architecture, operating model, and customization entry points inside that user project, then modify the generated `.trellis/` and platform directory files according to the user's request.
 
-Trellis v0.6 adds three architectural surfaces on top of the pre-v0.6 workflow / persistence / platform model. First, a multi-agent collaboration runtime: `trellis channel` coordinates multiple AI worker processes through project-scoped JSONL event logs at `~/.trellis/channels/<project>/<channel>/events.jsonl`, with worker OOM guard, forum/thread channels, durable idempotency keys, and bundled `.trellis/agents/{check,implement}.md` runtime definitions. Second, cross-session memory: `trellis mem list | search | context | extract | projects` reads raw Claude Code and Codex JSONL already on disk, slices by `--phase brainstorm|implement|all`, and never uploads anything. Third, a dual-package npm release: `@mindfoldhq/trellis` (CLI) and `@mindfoldhq/trellis-core` (SDK with `/channel`, `/task`, `/mem`, `/testing` subpaths) ship in lockstep on one version. Treat these as first-class customization surfaces alongside the per-platform integration files.
+Trellis v0.6 adds three architectural surfaces on top of the pre-v0.6 workflow / persistence / platform model. First, a multi-agent collaboration runtime: `trellis channel` coordinates multiple AI worker processes through project-scoped JSONL event logs at `~/.trellis/channels/<project>/<channel>/events.jsonl`, with worker OOM guard, forum/thread channels, durable idempotency keys, and bundled `.trellis/agents/{check,implement}.md` runtime definitions. Second, cross-session memory: `trellis mem list | search | context | extract | projects` reads raw Claude Code, Codex, and Pi Agent JSONL already on disk, slices by `--phase brainstorm|implement|all`, and never uploads anything. Third, a dual-package npm release: `@mindfoldhq/trellis` (CLI) and `@mindfoldhq/trellis-core` (SDK with `/channel`, `/task`, `/mem`, `/testing` subpaths) ship in lockstep on one version. Treat these as first-class customization surfaces alongside the per-platform integration files.
 
 The default operating scope is local files in the user project:
 
 - `.trellis/`: workflow, config, tasks, spec, workspace, scripts, bundled runtime agents, and runtime state.
-- Platform directories: `.claude/`, `.codex/`, `.cursor/`, `.opencode/`, `.kiro/`, `.gemini/`, `.qoder/`, `.codebuddy/`, `.github/`, `.factory/`, `.pi/`, `.reasonix/`, `.kilocode/`, `.agent/`, `.windsurf/`, and similar directories. Pi additionally exposes a native `trellis_subagent` tool with `single` / `parallel` / `chain` dispatch modes, throttled progress cards, and `isTrellisAgent()` validation on top of the file layout. Reasonix stores both workflow skills and subagent skills as `.reasonix/skills/<name>/SKILL.md`; subagent skills carry `runAs: subagent` frontmatter.
+- Platform directories: `.claude/`, `.codex/`, `.cursor/`, `.opencode/`, `.kiro/`, `.gemini/`, `.qoder/`, `.codebuddy/`, `.github/`, `.factory/`, `.pi/`, `.reasonix/`, `.kilocode/`, `.agent/`, `.devin/`, and similar directories. Pi additionally exposes a native `trellis_subagent` tool with `single` / `parallel` / `chain` dispatch modes, throttled progress cards, and `isTrellisAgent()` validation on top of the file layout. Reasonix stores both workflow skills and subagent skills as `.reasonix/skills/<name>/SKILL.md`; subagent skills carry `runAs: subagent` frontmatter.
 - Shared skill layer: `.agents/skills/`.
 - User-owned channel store outside the project tree: `~/.trellis/channels/<project>/<channel>/events.jsonl`.
-- Raw platform conversation logs queryable via `trellis mem`: `~/.claude/projects/` and `~/.codex/sessions/` (OpenCode adapter degraded for the v0.6 line).
+- Raw platform conversation logs queryable via `trellis mem`: `~/.claude/projects/`, `~/.codex/sessions/`, and `~/.pi/agent/sessions/` (OpenCode adapter degraded for the v0.6 line).
 
 Do not assume the user has the Trellis source repository. Do not default to modifying the global npm install directory or `node_modules` — both `@mindfoldhq/trellis` and `@mindfoldhq/trellis-core` ship as published packages sharing one version and one git tag per release.
 
@@ -67,7 +67,7 @@ Do not assume the user has the Trellis source repository. Do not default to modi
 - `.trellis/config.yaml` is the project-level Trellis configuration entry point. It hosts task lifecycle hooks (`hooks.after_create` / `after_start` / `after_finish` / `after_archive`), journal shape (`session_commit_message` / `max_journal_lines` / `session_auto_commit`), channel worker guard (`channel.worker_guard.idle_timeout` / `max_live_workers`), Codex dispatch mode (`codex.dispatch_mode: inline | sub-agent`), and the spec registry block (`registry.spec.source` + `registry.spec.template`).
 - `.trellis/spec/` stores the user's project-specific coding conventions and design constraints. When `registry.spec` is set, files are refreshed by `trellis update`; local edits surface as "modified by user" conflicts in `.trellis/.template-hashes.json`.
 - `.trellis/tasks/` stores task PRDs, design notes, implement plans, research files, and JSONL context. Tasks form parent/child trees: `task.py create --parent <slug>`, `task.py add-subtask <parent> <child>`, `task.py remove-subtask <parent> <child>`, and `task.py list-context <task>`. `task.py create` rejects a slug already present in `.trellis/tasks/archive/**`.
-- `.trellis/workspace/` stores **deliberately written** developer journals. Raw cross-session dialogue is **not** stored here — it lives on disk under `~/.claude/projects/` and `~/.codex/sessions/` and is recovered via `trellis mem search|extract|context`. The bundled `trellis-session-insight` skill teaches when to reach for `mem`.
+- `.trellis/workspace/` stores **deliberately written** developer journals. Raw cross-session dialogue is **not** stored here — it lives on disk under `~/.claude/projects/`, `~/.codex/sessions/`, and `~/.pi/agent/sessions/` and is recovered via `trellis mem search|extract|context`. The bundled `trellis-session-insight` skill teaches when to reach for `mem`.
 - `.trellis/agents/{check,implement}.md` are bundled, platform-agnostic channel runtime agent definitions loaded by `trellis channel spawn --agent <name>`. Editable; `trellis update` backfills missing ones. Editing the per-platform `trellis-implement.md` / `trellis-check.md` does **not** change channel-runtime worker behavior.
 - `~/.trellis/channels/<project>/<channel>/events.jsonl` is the channel runtime event log per project per channel. User-owned, file-locked sequence numbering, durable `idempotencyKey` support; never under `.trellis/`.
 - Bundled multi-file skills (`trellis-meta`, `trellis-spec-bootstrap`, `trellis-session-insight`, `trellis-channel`) are auto-dispatched to every platform skill root by `getBundledSkillTemplates()` in `packages/cli/src/templates/common/index.ts`. Dropping a new directory under `packages/cli/src/templates/common/bundled-skills/` (upstream) ships it to every platform on the next `trellis update`.

package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-agents.md

@@ -24,6 +24,8 @@ When the user wants to change `trellis-research`, `trellis-implement`, or `trell
 | CodeBuddy | `.codebuddy/agents/trellis-*.md` |
 | Factory Droid | `.factory/droids/trellis-*.md` |
 | Pi Agent | `.pi/agents/trellis-*.md` |
+| Reasonix | `.reasonix/skills/trellis-*/SKILL.md` (subagent frontmatter) |
+| ZCode | `.zcode/cli/agents/trellis-*.md` |
 
 Use the actual paths in the user project as authoritative.
 

package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/change-skills-or-commands.md

@@ -89,7 +89,8 @@ If a command only repeats workflow rules, prefer making it reference/read `.trel
 | Factory Droid | `.factory/skills/`, `.factory/commands/` |
 | Pi Agent | `.pi/skills/` |
 | Reasonix | `.reasonix/skills/` (no separate commands dir; slash commands built into the platform) |
-| Kilo / Antigravity / Windsurf | workflows + skills |
+| ZCode | `.agents/skills/`, `.zcode/commands/` |
+| Kilo / Antigravity / Devin | workflows + skills |
 
 Every directory above is a deploy target for the four bundled skills. Each platform receives a full copy on `trellis init` and refresh on `trellis update`; nothing has to be wired by hand.
 

package/dist/templates/common/bundled-skills/trellis-meta/references/customize-local/overview.md

@@ -17,7 +17,7 @@ This directory is for local AI working in a user project where Trellis was insta
 
 ## General Operation Order
 
-1. **Confirm platform and directories**: inspect which directories exist, such as `.claude/`, `.codex/`, `.cursor/`.
+1. **Confirm platform and directories**: inspect which directories exist, such as `.claude/`, `.codex/`, `.cursor/`, `.zcode/`.
 2. **Confirm the current active task**: run `python3 ./.trellis/scripts/task.py current --source`.
 3. **Read the local source of truth**: prefer `.trellis/workflow.md`, `.trellis/config.yaml`, and relevant platform files.
 4. **Modify narrowly**: edit only files related to the user's request.
@@ -32,7 +32,7 @@ This directory is for local AI working in a user project where Trellis was insta
 | Task material | `.trellis/tasks/<task>/` |
 | Project specs | `.trellis/spec/` |
 | Runtime scripts | `.trellis/scripts/` |
-| Platform integration | `.claude/`, `.codex/`, `.cursor/`, `.opencode/`, and similar directories |
+| Platform integration | `.claude/`, `.codex/`, `.cursor/`, `.opencode/`, `.zcode/`, and similar directories |
 | Shared skill | `.agents/skills/` |
 
 ## Things Not To Do By Default

package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/bundled-skills.md

@@ -23,7 +23,7 @@ The set is discovered at runtime by listing directories under `templates/common/
 | Skill | Purpose |
 | --- | --- |
 | `trellis-meta` | This skill. Explains the local Trellis architecture and customization entry points to an AI working inside a user project. |
-| `trellis-session-insight` | Wraps the `trellis mem` CLI so an AI knows when and how to reach into past Claude Code / Codex conversation logs. |
+| `trellis-session-insight` | Wraps the `trellis mem` CLI so an AI knows when and how to reach into past Claude Code / Codex / Pi Agent conversation logs. |
 | `trellis-spec-bootstrap` | Platform-neutral workflow for creating or refreshing `.trellis/spec/` from the real codebase (with optional GitNexus / ABCoder integration). |
 | `trellis-channel` | Capability skill teaching an AI when to reach for `trellis channel` for multi-agent collaboration, forum/thread persistent boards, and dispatcher-wait patterns. |
 
@@ -45,7 +45,7 @@ Each platform configurator calls `writeSkills(<root>, <workflowSkills>, resolveB
 | Copilot | `.github/skills/<skill>/` | `configureCopilot` |
 | Droid | `.factory/skills/<skill>/` | `configureDroid` |
 | Antigravity | `.agent/skills/<skill>/` | `configureAntigravity` |
-| Windsurf | `.windsurf/skills/<skill>/` | `configureWindsurf` |
+| Devin | `.devin/skills/<skill>/` | `configureDevin` |
 | Kilo | `.kilocode/skills/<skill>/` | `configureKilo` |
 | OpenCode | (handled by `collectOpenCodeTemplates`) | Uses the same `resolveBundledSkills(ctx)` output |
 | Pi, Reasonix | (their own collectors) | Same `resolveBundledSkills(ctx)` output |
@@ -69,7 +69,7 @@ The mechanism that auto-dispatches bundled skills to platform skill roots lives
    - `writeSkills(skillsRoot, workflowSkills, bundledSkills)` writes both workflow skills and bundled skill files under `skillsRoot`.
    - `collectSkillTemplates(skillsRoot, workflowSkills, bundledSkills)` returns the same shape as a `Map<filePath, content>` for the update / hash pipeline.
 
-Every platform configurator that supports skills imports both helpers (see `claude.ts`, `cursor.ts`, `codex.ts`, `gemini.ts`, `kiro.ts`, `qoder.ts`, `codebuddy.ts`, `copilot.ts`, `droid.ts`, `antigravity.ts`, `windsurf.ts`, `kilo.ts`). The `index.ts` `PLATFORM_FUNCTIONS` registry also calls `resolveBundledSkills(ctx)` inside each `collectTemplates` closure so `trellis update` tracking stays consistent.
+Every platform configurator that supports skills imports both helpers (see `claude.ts`, `cursor.ts`, `codex.ts`, `gemini.ts`, `kiro.ts`, `qoder.ts`, `codebuddy.ts`, `copilot.ts`, `droid.ts`, `antigravity.ts`, `devin.ts`, `kilo.ts`). The `index.ts` `PLATFORM_FUNCTIONS` registry also calls `resolveBundledSkills(ctx)` inside each `collectTemplates` closure so `trellis update` tracking stays consistent.
 
 ## Adding a New Bundled Skill
 

package/dist/templates/common/bundled-skills/trellis-meta/references/local-architecture/generated-files.md

@@ -41,9 +41,9 @@ Different platforms generate different directories. Common categories:
 | --- | --- | --- |
 | hooks | `.claude/hooks/`, `.codex/hooks/`, `.cursor/hooks/` | Inject session context, workflow-state, and sub-agent context. |
 | settings | `.claude/settings.json`, `.codex/hooks.json`, `.qoder/settings.json` | Tell the platform when to run hooks or plugins. |
-| agents | `.claude/agents/`, `.codex/agents/`, `.kiro/agents/` | Define agents such as `trellis-research`, `trellis-implement`, and `trellis-check`. |
+| agents | `.claude/agents/`, `.codex/agents/`, `.kiro/agents/`, `.zcode/cli/agents/` | Define agents such as `trellis-research`, `trellis-implement`, and `trellis-check`. |
 | skills | `.claude/skills/`, `.agents/skills/`, `.qoder/skills/` | Skills that auto-trigger or can be read by AI. |
-| commands/prompts/workflows | `.cursor/commands/`, `.github/prompts/`, `.windsurf/workflows/` | Explicit user-invoked command or workflow entry points. |
+| commands/prompts/workflows | `.cursor/commands/`, `.github/prompts/`, `.devin/workflows/`, `.zcode/commands/` | Explicit user-invoked command or workflow entry points. |
 
 When modifying a platform directory, also confirm whether `.trellis/workflow.md` still describes the same flow.