From c1ab3396e23cc0e8788d1f788e1eb81d87757880 Mon Sep 17 00:00:00 2001 From: Cartisien Interactive Date: Fri, 29 May 2026 08:38:46 -0400 Subject: [PATCH 1/3] Add Zed host support (--host zed) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Installs gstack skills to ~/.agents/skills/gstack, matching Zed's global skill directory convention per https://zed.dev/docs/ai/skills. - globalRoot / localSkillRoot: .agents/skills/gstack - hostSubdir: .agents - frontmatter allowlist: name + description (1024 char limit, truncate) - pathRewrites: .claude/skills → .agents/skills - skipSkills: codex (Claude Code-specific) - suppressedResolvers: GBRAIN_CONTEXT_LOAD, GBRAIN_SAVE_RESULTS Co-Authored-By: Claude Sonnet 4.6 --- hosts/index.ts | 5 +++-- hosts/zed.ts | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 52 insertions(+), 2 deletions(-) create mode 100644 hosts/zed.ts diff --git a/hosts/index.ts b/hosts/index.ts index cc1c213b53..7cd3fcf620 100644 --- a/hosts/index.ts +++ b/hosts/index.ts @@ -16,9 +16,10 @@ import cursor from './cursor'; import openclaw from './openclaw'; import hermes from './hermes'; import gbrain from './gbrain'; +import zed from './zed'; /** All registered host configs. Add new hosts here. */ -export const ALL_HOST_CONFIGS: HostConfig[] = [claude, codex, factory, kiro, opencode, slate, cursor, openclaw, hermes, gbrain]; +export const ALL_HOST_CONFIGS: HostConfig[] = [claude, codex, factory, kiro, opencode, slate, cursor, openclaw, hermes, gbrain, zed]; /** Map from host name to config. */ export const HOST_CONFIG_MAP: Record = Object.fromEntries( @@ -65,4 +66,4 @@ export function getExternalHosts(): HostConfig[] { } // Re-export individual configs for direct import -export { claude, codex, factory, kiro, opencode, slate, cursor, openclaw, hermes, gbrain }; +export { claude, codex, factory, kiro, opencode, slate, cursor, openclaw, hermes, gbrain, zed }; diff --git a/hosts/zed.ts b/hosts/zed.ts new file mode 100644 index 0000000000..89e68bb032 --- /dev/null +++ b/hosts/zed.ts @@ -0,0 +1,49 @@ +import type { HostConfig } from '../scripts/host-config'; + +const zed: HostConfig = { + name: 'zed', + displayName: 'Zed', + cliCommand: 'zed', + cliAliases: [], + + globalRoot: '.agents/skills/gstack', + localSkillRoot: '.agents/skills/gstack', + hostSubdir: '.agents', + usesEnvVars: true, + + frontmatter: { + mode: 'allowlist', + keepFields: ['name', 'description'], + descriptionLimit: 1024, + descriptionLimitBehavior: 'truncate', + }, + + generation: { + generateMetadata: false, + skipSkills: ['codex'], + }, + + pathRewrites: [ + { from: '~/.claude/skills/gstack', to: '~/.agents/skills/gstack' }, + { from: '.claude/skills/gstack', to: '.agents/skills/gstack' }, + { from: '.claude/skills', to: '.agents/skills' }, + ], + + suppressedResolvers: ['GBRAIN_CONTEXT_LOAD', 'GBRAIN_SAVE_RESULTS'], + + runtimeRoot: { + globalSymlinks: ['bin', 'browse/dist', 'browse/bin', 'design/dist', 'gstack-upgrade', 'ETHOS.md'], + globalFiles: { + 'review': ['checklist.md', 'TODOS-format.md'], + }, + }, + + install: { + prefixable: false, + linkingStrategy: 'symlink-generated', + }, + + learningsMode: 'basic', +}; + +export default zed; From cfd344e33a8e394a98aea5d4f7c9cbd6a66e3584 Mon Sep 17 00:00:00 2001 From: Cartisien Interactive Date: Fri, 29 May 2026 08:57:21 -0400 Subject: [PATCH 2/3] Fix setup script to support --host zed - Add 'zed' to the validation allowlist (was failing with unknown host error) - Add INSTALL_ZED=0 flag and elif branch - Auto-detect zed in --host auto mode - Add install block that generates .zed/skills/ via gen:skill-docs, then copies to ~/.agents/skills/ (Zed's global skill directory) Co-Authored-By: Claude Sonnet 4.6 --- hosts/zed.ts | 2 +- setup | 63 ++++++++++++++++++++++++++++++++++++++++++++++++---- 2 files changed, 60 insertions(+), 5 deletions(-) diff --git a/hosts/zed.ts b/hosts/zed.ts index 89e68bb032..3477d01d66 100644 --- a/hosts/zed.ts +++ b/hosts/zed.ts @@ -8,7 +8,7 @@ const zed: HostConfig = { globalRoot: '.agents/skills/gstack', localSkillRoot: '.agents/skills/gstack', - hostSubdir: '.agents', + hostSubdir: '.zed', usesEnvVars: true, frontmatter: { diff --git a/setup b/setup index a9ab892c87..eebdb76af3 100755 --- a/setup +++ b/setup @@ -84,7 +84,7 @@ TEAM_MODE=0 NO_TEAM_MODE=0 while [ $# -gt 0 ]; do case "$1" in - --host) [ -z "$2" ] && echo "Missing value for --host (expected claude, codex, kiro, factory, opencode, openclaw, hermes, gbrain, or auto)" >&2 && exit 1; HOST="$2"; shift 2 ;; + --host) [ -z "$2" ] && echo "Missing value for --host (expected claude, codex, kiro, factory, opencode, zed, openclaw, hermes, gbrain, or auto)" >&2 && exit 1; HOST="$2"; shift 2 ;; --host=*) HOST="${1#--host=}"; shift ;; --local) LOCAL_INSTALL=1; shift ;; --prefix) SKILL_PREFIX=1; SKILL_PREFIX_FLAG=1; shift ;; @@ -97,7 +97,7 @@ while [ $# -gt 0 ]; do done case "$HOST" in - claude|codex|kiro|factory|opencode|auto) ;; + claude|codex|kiro|factory|opencode|zed|auto) ;; openclaw) echo "" echo "OpenClaw integration uses a different model — OpenClaw spawns Claude Code" @@ -132,7 +132,7 @@ case "$HOST" in echo "GBrain setup and brain skills ship from the GBrain repo." echo "" exit 0 ;; - *) echo "Unknown --host value: $HOST (expected claude, codex, kiro, factory, opencode, openclaw, hermes, gbrain, or auto)" >&2; exit 1 ;; + *) echo "Unknown --host value: $HOST (expected claude, codex, kiro, factory, opencode, zed, openclaw, hermes, gbrain, or auto)" >&2; exit 1 ;; esac # ─── Resolve skill prefix preference ───────────────────────── @@ -196,14 +196,16 @@ INSTALL_CODEX=0 INSTALL_KIRO=0 INSTALL_FACTORY=0 INSTALL_OPENCODE=0 +INSTALL_ZED=0 if [ "$HOST" = "auto" ]; then command -v claude >/dev/null 2>&1 && INSTALL_CLAUDE=1 command -v codex >/dev/null 2>&1 && INSTALL_CODEX=1 command -v kiro-cli >/dev/null 2>&1 && INSTALL_KIRO=1 command -v droid >/dev/null 2>&1 && INSTALL_FACTORY=1 command -v opencode >/dev/null 2>&1 && INSTALL_OPENCODE=1 + command -v zed >/dev/null 2>&1 && INSTALL_ZED=1 # If none found, default to claude - if [ "$INSTALL_CLAUDE" -eq 0 ] && [ "$INSTALL_CODEX" -eq 0 ] && [ "$INSTALL_KIRO" -eq 0 ] && [ "$INSTALL_FACTORY" -eq 0 ] && [ "$INSTALL_OPENCODE" -eq 0 ]; then + if [ "$INSTALL_CLAUDE" -eq 0 ] && [ "$INSTALL_CODEX" -eq 0 ] && [ "$INSTALL_KIRO" -eq 0 ] && [ "$INSTALL_FACTORY" -eq 0 ] && [ "$INSTALL_OPENCODE" -eq 0 ] && [ "$INSTALL_ZED" -eq 0 ]; then INSTALL_CLAUDE=1 fi elif [ "$HOST" = "claude" ]; then @@ -216,6 +218,8 @@ elif [ "$HOST" = "factory" ]; then INSTALL_FACTORY=1 elif [ "$HOST" = "opencode" ]; then INSTALL_OPENCODE=1 +elif [ "$HOST" = "zed" ]; then + INSTALL_ZED=1 fi migrate_direct_codex_install() { @@ -1076,6 +1080,57 @@ if [ "$INSTALL_OPENCODE" -eq 1 ]; then echo " opencode skills: $OPENCODE_SKILLS" fi +# 6d. Install for Zed +if [ "$INSTALL_ZED" -eq 1 ]; then + ZED_SKILLS="$HOME/.agents/skills" + ZED_GSTACK="$ZED_SKILLS/gstack" + ZED_GEN_DIR="$SOURCE_GSTACK_DIR/.zed/skills" + mkdir -p "$ZED_SKILLS" + + # Generate Zed-specific skill docs into .zed/skills/ + ( cd "$SOURCE_GSTACK_DIR" && PATH="$HOME/.bun/bin:$PATH" bun run gen:skill-docs --host zed ) || \ + echo " warning: gen:skill-docs --host zed failed — skills may be stale" >&2 + + # Runtime asset root + [ -L "$ZED_GSTACK" ] && rm -f "$ZED_GSTACK" + mkdir -p "$ZED_GSTACK" "$ZED_GSTACK/browse" "$ZED_GSTACK/gstack-upgrade" "$ZED_GSTACK/review" + _link_or_copy "$SOURCE_GSTACK_DIR/bin" "$ZED_GSTACK/bin" + _link_or_copy "$SOURCE_GSTACK_DIR/browse/dist" "$ZED_GSTACK/browse/dist" + _link_or_copy "$SOURCE_GSTACK_DIR/browse/bin" "$ZED_GSTACK/browse/bin" + if [ -f "$SOURCE_GSTACK_DIR/ETHOS.md" ]; then + _link_or_copy "$SOURCE_GSTACK_DIR/ETHOS.md" "$ZED_GSTACK/ETHOS.md" + fi + if [ -f "$ZED_GEN_DIR/gstack-upgrade/SKILL.md" ]; then + _link_or_copy "$ZED_GEN_DIR/gstack-upgrade/SKILL.md" "$ZED_GSTACK/gstack-upgrade/SKILL.md" + fi + for f in checklist.md TODOS-format.md; do + if [ -f "$SOURCE_GSTACK_DIR/review/$f" ]; then + _link_or_copy "$SOURCE_GSTACK_DIR/review/$f" "$ZED_GSTACK/review/$f" + fi + done + + # Root SKILL.md with path rewrites for Zed + sed -e "s|~/.claude/skills/gstack|~/.agents/skills/gstack|g" \ + -e "s|\.claude/skills/gstack|.agents/skills/gstack|g" \ + -e "s|\.claude/skills|.agents/skills|g" \ + "$SOURCE_GSTACK_DIR/SKILL.md" > "$ZED_GSTACK/SKILL.md" + + if [ ! -d "$ZED_GEN_DIR" ]; then + echo " warning: .zed/skills/ not found — run 'bun run gen:skill-docs --host zed' manually" >&2 + else + for skill_dir in "$ZED_GEN_DIR"/gstack*/; do + [ -f "$skill_dir/SKILL.md" ] || continue + skill_name="$(basename "$skill_dir")" + target_dir="$ZED_SKILLS/$skill_name" + mkdir -p "$target_dir" + cp "$skill_dir/SKILL.md" "$target_dir/SKILL.md" + done + echo "gstack ready (zed)." + echo " browse: $BROWSE_BIN" + echo " zed skills: $ZED_SKILLS" + fi +fi + # 7. Create .agents/ sidecar symlinks for the real Codex skill target. # The root Codex skill ends up pointing at $SOURCE_GSTACK_DIR/.agents/skills/gstack, # so the runtime assets must live there for both global and repo-local installs. From a1770eb2e10497c317bab5c6f2f857a371848361 Mon Sep 17 00:00:00 2001 From: Cartisien Interactive Date: Fri, 29 May 2026 09:18:04 -0400 Subject: [PATCH 3/3] Add maxFileBytes truncation for Zed's 100KB SKILL.md limit Zed enforces a hard 100KB ceiling on SKILL.md files (MAX_SKILL_FILE_SIZE in crates/agent_skills/agent_skills.rs). Seven gstack skills exceed this: ship (168KB), plan-ceo-review (132KB), office-hours (112KB), plan-design-review (108KB), plan-devex-review (106KB), spec (104KB), plan-eng-review (103KB). Changes: - host-config.ts: add optional `maxFileBytes` field to HostConfig - gen-skill-docs.ts: add truncateToMaxBytes() helper; call it in processTemplate() after the generated header is inserted (so header bytes are included in the budget). Truncates at last complete line that fits, appends a one-line notice pointing to the full Claude skill. - hosts/zed.ts: set maxFileBytes: 100 * 1024 Co-Authored-By: Claude Sonnet 4.6 --- hosts/zed.ts | 2 ++ scripts/gen-skill-docs.ts | 47 +++++++++++++++++++++++++++++++++++++++ scripts/host-config.ts | 7 ++++++ 3 files changed, 56 insertions(+) diff --git a/hosts/zed.ts b/hosts/zed.ts index 3477d01d66..45bcd6eb7a 100644 --- a/hosts/zed.ts +++ b/hosts/zed.ts @@ -23,6 +23,8 @@ const zed: HostConfig = { skipSkills: ['codex'], }, + maxFileBytes: 100 * 1024, + pathRewrites: [ { from: '~/.claude/skills/gstack', to: '~/.agents/skills/gstack' }, { from: '.claude/skills/gstack', to: '.agents/skills/gstack' }, diff --git a/scripts/gen-skill-docs.ts b/scripts/gen-skill-docs.ts index 30853f6776..a501456c58 100644 --- a/scripts/gen-skill-docs.ts +++ b/scripts/gen-skill-docs.ts @@ -531,6 +531,45 @@ function extractHookSafetyProse(tmplContent: string): string | null { const GENERATED_HEADER = `\n\n`; +/** + * Truncate a SKILL.md to at most `maxBytes` bytes, preserving the frontmatter + * and trimming the body at the last complete line that fits, then appending a + * one-line notice. Called after the generated header has been inserted so the + * header bytes are already included in the size budget. + */ +function truncateToMaxBytes(content: string, maxBytes: number): string { + if (Buffer.byteLength(content, 'utf-8') <= maxBytes) return content; + + const notice = '\n\n> [Truncated to fit host file size limit. Full skill: ~/.claude/skills/gstack]\n'; + const noticeBytes = Buffer.byteLength(notice, 'utf-8'); + const budget = maxBytes - noticeBytes; + + // Split at the end of the closing frontmatter `---` line. + const fmEnd = content.indexOf('\n---\n', 3); + const splitAt = fmEnd !== -1 ? fmEnd + 5 : 0; + const frontmatter = content.slice(0, splitAt); + const body = content.slice(splitAt); + + const fmBytes = Buffer.byteLength(frontmatter, 'utf-8'); + const bodyBudget = Math.max(0, budget - fmBytes); + + let bodyTrunc = body; + if (Buffer.byteLength(body, 'utf-8') > bodyBudget) { + const lines = body.split('\n'); + const kept: string[] = []; + let used = 0; + for (const line of lines) { + const lb = Buffer.byteLength(line + '\n', 'utf-8'); + if (used + lb > bodyBudget) break; + kept.push(line); + used += lb; + } + bodyTrunc = kept.join('\n'); + } + + return frontmatter + bodyTrunc + notice; +} + /** * Process external host output: routing, frontmatter, path rewrites, metadata. * Shared between Codex and Factory (and future external hosts). @@ -683,6 +722,14 @@ function processTemplate(tmplPath: string, host: Host = 'claude'): { outputPath: content = header + content; } + // Config-driven: truncate to maxFileBytes after header insertion (e.g. Zed's 100KB limit). + if (host !== 'claude' && !symlinkLoop) { + const hostCfg = getHostConfig(host); + if (hostCfg.maxFileBytes && Buffer.byteLength(content, 'utf-8') > hostCfg.maxFileBytes) { + content = truncateToMaxBytes(content, hostCfg.maxFileBytes); + } + } + // Catalog trim (Claude only — external hosts have their own frontmatter shapes) let catalogParts: CatalogParts | null = null; if (host === 'claude' && CATALOG_MODE === 'trim') { diff --git a/scripts/host-config.ts b/scripts/host-config.ts index 4421c4a799..a8c2cbd850 100644 --- a/scripts/host-config.ts +++ b/scripts/host-config.ts @@ -69,6 +69,13 @@ export interface HostConfig { // --- Content Rewrites --- /** Literal string replacements on generated SKILL.md content. Order matters, replaceAll. */ pathRewrites: Array<{ from: string; to: string }>; + /** + * Hard byte ceiling for generated SKILL.md files (e.g. 100 * 1024 for Zed). + * When set, the body is truncated at the last complete line that keeps the + * total file under this limit and a one-line truncation notice is appended. + * The frontmatter is never truncated. + */ + maxFileBytes?: number; /** Tool name string replacements on content. */ toolRewrites?: Record; /** Resolver functions that return empty string for this host. */