From 38cf69bcf3d6ff6033c20fe9675e4c908e23477d Mon Sep 17 00:00:00 2001 From: Michael Sitarzewski Date: Sun, 12 Jul 2026 02:28:20 -0500 Subject: [PATCH] zcode: fix user-scope install path to ~/.zcode/agents (per ZCode docs) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The user-scope dest was ~/.config/zcode/agents/, but the official ZCode docs state subagents are read from ~/.zcode/agents/.md — so user-scope installs landed where ZCode never looks. (detect.agentsDir and project scope were already correct at .zcode/agents, so this was an internal inconsistency.) Point tools.json dest.user, install_zcode's default, the header comment, and the list display at ~/.zcode/agents; drop the stale ~/.config/zcode detection clause; update the integration README. Keep format `zcode-md` distinct — ZCode's native format supports color/model/permissions, so it will diverge from gemini-md as the converter matures rather than being a permanent alias. Verified: a default user-scope install now writes to ~/.zcode/agents/.md (not ~/.config/zcode); check-tools.sh passes at 16 tools; install.sh syntax and tools.json JSON both valid. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_01WKnDRWM4izsB8WAXKszhsq --- integrations/zcode/README.md | 6 +++--- scripts/install.sh | 8 ++++---- tools.json | 2 +- 3 files changed, 8 insertions(+), 8 deletions(-) diff --git a/integrations/zcode/README.md b/integrations/zcode/README.md index 1a55fffe..a12071b4 100644 --- a/integrations/zcode/README.md +++ b/integrations/zcode/README.md @@ -24,6 +24,6 @@ Run the installer from your target directory: cd /your/project && /path/to/agency-agents/scripts/install.sh --tool zcode ``` -Agents install to `~/.config/zcode/agents/.md` (user scope). Use -`--division` / `--agent` to install a subset, or set `ZCODE_AGENTS_DIR` to -override the destination. +Agents install to `~/.zcode/agents/.md` (user scope) — the directory +ZCode reads subagents from. Use `--division` / `--agent` to install a subset, +or set `ZCODE_AGENTS_DIR` to override the destination. diff --git a/scripts/install.sh b/scripts/install.sh index 3bf286e3..1ff20c47 100755 --- a/scripts/install.sh +++ b/scripts/install.sh @@ -22,7 +22,7 @@ # windsurf -- Copy .windsurfrules to current directory # openclaw -- Copy workspaces to ~/.openclaw/agency-agents/ # qwen -- Copy SubAgents to ~/.qwen/agents/ (user-wide) or .qwen/agents/ (project) -# zcode -- Copy agents to ~/.config/zcode/agents/ (global) or .zcode/agents/ (project) +# zcode -- Copy agents to ~/.zcode/agents/ (global) or .zcode/agents/ (project) # codex -- Copy custom agent TOML files to ~/.codex/agents/ # osaurus -- Copy skills to ~/.osaurus/skills/ # hermes -- Copy lazy-router plugin to ~/.hermes/plugins/ and enable it @@ -382,7 +382,7 @@ detect_aider() { command -v aider >/dev/null 2>&1; } detect_openclaw() { command -v openclaw >/dev/null 2>&1 || [[ -d "${HOME}/.openclaw" ]]; } detect_windsurf() { command -v windsurf >/dev/null 2>&1 || [[ -d "${HOME}/.codeium" ]]; } detect_qwen() { command -v qwen >/dev/null 2>&1 || [[ -d "${HOME}/.qwen" ]]; } -detect_zcode() { command -v zcode >/dev/null 2>&1 || [[ -d "${HOME}/.zcode" ]] || [[ -d "${HOME}/.config/zcode" ]]; } +detect_zcode() { command -v zcode >/dev/null 2>&1 || [[ -d "${HOME}/.zcode" ]]; } detect_kimi() { command -v kimi >/dev/null 2>&1; } detect_codex() { command -v codex >/dev/null 2>&1 || [[ -d "${HOME}/.codex" ]]; } detect_osaurus() { command -v osaurus >/dev/null 2>&1 || [[ -d "${HOME}/.osaurus" ]]; } @@ -424,7 +424,7 @@ tool_label() { aider) printf "%-14s %s" "Aider" "(CONVENTIONS.md)" ;; windsurf) printf "%-14s %s" "Windsurf" "(.windsurfrules)" ;; qwen) printf "%-14s %s" "Qwen Code" "(~/.qwen/agents)" ;; - zcode) printf "%-14s %s" "ZCode" "(~/.config/zcode/agents)" ;; + zcode) printf "%-14s %s" "ZCode" "(~/.zcode/agents)" ;; kimi) printf "%-14s %s" "Kimi Code" "(~/.config/kimi/agents)" ;; codex) printf "%-14s %s" "Codex" "(~/.codex/agents)" ;; osaurus) printf "%-14s %s" "Osaurus" "(~/.osaurus/skills)" ;; @@ -911,7 +911,7 @@ install_qwen() { install_zcode() { local src="$INTEGRATIONS/zcode/agents" - local dest; dest="$(resolve_dest zcode "${HOME}/.config/zcode/agents")" + local dest; dest="$(resolve_dest zcode "${HOME}/.zcode/agents")" local count=0 [[ -d "$src" ]] || { err "integrations/zcode missing. Run convert.sh first."; return 1; } diff --git a/tools.json b/tools.json index 40fe2c4c..cd4ea042 100644 --- a/tools.json +++ b/tools.json @@ -16,6 +16,6 @@ "windsurf": {"id":"windsurf","label":"Windsurf","short":"Windsurf","kebab":"windsurf","accent":"#09B6A2","icon":"windsurf","order":13,"scope":{"user":false,"project":true},"detect":{"dirs":[".codeium"],"agentsDir":null},"version":{"bin":"windsurf","args":["--version"]},"format":"windsurf-rules","installKind":"roster","slugFrom":null,"dest":{"user":[],"project":[".windsurfrules"]}}, "hermes": {"id":"hermes","label":"Hermes","short":"Hermes","kebab":"hermes","accent":"#7C3AED","icon":null,"order":14,"scope":{"user":true,"project":false},"detect":{"dirs":[".hermes"],"agentsDir":".hermes/plugins"},"version":{"bin":"hermes","args":["--version"]},"format":"hermes-router-plugin","installKind":"plugin","slugFrom":null,"dest":{"user":[".hermes/plugins/agency-agents-router"],"project":[]}}, "vibe": {"id":"vibe","label":"Mistral Vibe","short":"Vibe","kebab":"vibe","accent":"#FA520F","icon":null,"order":15,"scope":{"user":true,"project":true},"detect":{"dirs":[".vibe"],"agentsDir":".vibe/agents"},"version":{"bin":"vibe","args":["--version"]},"format":"vibe-toml","installKind":"per-agent","slugFrom":"name","dest":{"user":[".vibe/agents/{slug}.toml",".vibe/prompts/{slug}.md"],"project":[".vibe/agents/{slug}.toml",".vibe/prompts/{slug}.md"]}}, - "zcode": {"id":"zcode","label":"ZCode","short":"ZCode","kebab":"zcode","accent":"#4263EB","icon":"zcode","order":16,"scope":{"user":true,"project":true},"detect":{"dirs":[".zcode"],"agentsDir":".zcode/agents"},"version":{"bin":"zcode","args":["--version"]},"format":"zcode-md","installKind":"per-agent","slugFrom":"name","dest":{"user":[".config/zcode/agents/{slug}.md"],"project":[".zcode/agents/{slug}.md"]}} + "zcode": {"id":"zcode","label":"ZCode","short":"ZCode","kebab":"zcode","accent":"#4263EB","icon":"zcode","order":16,"scope":{"user":true,"project":true},"detect":{"dirs":[".zcode"],"agentsDir":".zcode/agents"},"version":{"bin":"zcode","args":["--version"]},"format":"zcode-md","installKind":"per-agent","slugFrom":"name","dest":{"user":[".zcode/agents/{slug}.md"],"project":[".zcode/agents/{slug}.md"]}} } }