Skip to main content

sync-gbrain

Maintains gbrain's code synchronization and updates search guidance in CLAUDE.md, ensuring efficient agent search functionality.

Install this skill

or
0/100

Security score

The sync-gbrain skill was audited on Jun 10, 2026 and we found 94 security issues across 3 threat categories. Review the findings below before installing.

Categories Tested

Security Issues

medium line 33

Template literal with variable interpolation in command context

SourceSKILL.md
33```bash
medium line 283

Template literal with variable interpolation in command context

SourceSKILL.md
283```bash
medium line 418

Template literal with variable interpolation in command context

SourceSKILL.md
418```bash
medium line 452

Template literal with variable interpolation in command context

SourceSKILL.md
452echo "before relying on \`gbrain search\` for code questions in this worktree."
medium line 580

Template literal with variable interpolation in command context

SourceSKILL.md
580```bash
low line 34

Access to hidden dotfiles in home directory

SourceSKILL.md
34_UPD=$(~/.claude/skills/gstack/bin/gstack-update-check 2>/dev/null || .claude/skills/gstack/bin/gstack-update-check 2>/dev/null || true)
low line 36

Access to hidden dotfiles in home directory

SourceSKILL.md
36mkdir -p ~/.gstack/sessions
low line 37

Access to hidden dotfiles in home directory

SourceSKILL.md
37touch ~/.gstack/sessions/"$PPID"
low line 38

Access to hidden dotfiles in home directory

SourceSKILL.md
38_SESSIONS=$(find ~/.gstack/sessions -mmin -120 -type f 2>/dev/null | wc -l | tr -d ' ')
low line 39

Access to hidden dotfiles in home directory

SourceSKILL.md
39find ~/.gstack/sessions -mmin +120 -type f -exec rm {} + 2>/dev/null || true
low line 40

Access to hidden dotfiles in home directory

SourceSKILL.md
40_PROACTIVE=$(~/.claude/skills/gstack/bin/gstack-config get proactive 2>/dev/null || echo "true")
low line 41

Access to hidden dotfiles in home directory

SourceSKILL.md
41_PROACTIVE_PROMPTED=$([ -f ~/.gstack/.proactive-prompted ] && echo "yes" || echo "no")
low line 44

Access to hidden dotfiles in home directory

SourceSKILL.md
44_SKILL_PREFIX=$(~/.claude/skills/gstack/bin/gstack-config get skill_prefix 2>/dev/null || echo "false")
low line 48

Access to hidden dotfiles in home directory

SourceSKILL.md
48source <(~/.claude/skills/gstack/bin/gstack-repo-mode 2>/dev/null) || true
low line 51

Access to hidden dotfiles in home directory

SourceSKILL.md
51_SESSION_KIND=$(~/.claude/skills/gstack/bin/gstack-session-kind 2>/dev/null || echo "interactive")
low line 54

Access to hidden dotfiles in home directory

SourceSKILL.md
54_LAKE_SEEN=$([ -f ~/.gstack/.completeness-intro-seen ] && echo "yes" || echo "no")
low line 56

Access to hidden dotfiles in home directory

SourceSKILL.md
56_TEL=$(~/.claude/skills/gstack/bin/gstack-config get telemetry 2>/dev/null || true)
low line 57

Access to hidden dotfiles in home directory

SourceSKILL.md
57_TEL_PROMPTED=$([ -f ~/.gstack/.telemetry-prompted ] && echo "yes" || echo "no")
low line 62

Access to hidden dotfiles in home directory

SourceSKILL.md
62_EXPLAIN_LEVEL=$(~/.claude/skills/gstack/bin/gstack-config get explain_level 2>/dev/null || echo "default")
low line 65

Access to hidden dotfiles in home directory

SourceSKILL.md
65_QUESTION_TUNING=$(~/.claude/skills/gstack/bin/gstack-config get question_tuning 2>/dev/null || echo "false")
low line 67

Access to hidden dotfiles in home directory

SourceSKILL.md
67mkdir -p ~/.gstack/analytics
low line 69

Access to hidden dotfiles in home directory

SourceSKILL.md
69echo '{"skill":"sync-gbrain","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(_repo=$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null | tr -cd 'a-zA-Z0-9._-'); echo "${_repo:-unk
low line 71

Access to hidden dotfiles in home directory

SourceSKILL.md
71for _PF in $(find ~/.gstack/analytics -maxdepth 1 -name '.pending-*' 2>/dev/null); do
low line 73

Access to hidden dotfiles in home directory

SourceSKILL.md
73if [ "$_TEL" != "off" ] && [ -x "~/.claude/skills/gstack/bin/gstack-telemetry-log" ]; then
low line 74

Access to hidden dotfiles in home directory

SourceSKILL.md
74~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id "$_SESSION_ID" 2>/dev/null || true
low line 80

Access to hidden dotfiles in home directory

SourceSKILL.md
80eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
low line 86

Access to hidden dotfiles in home directory

SourceSKILL.md
86~/.claude/skills/gstack/bin/gstack-learnings-search --limit 3 2>/dev/null || true
low line 91

Access to hidden dotfiles in home directory

SourceSKILL.md
91~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"sync-gbrain","event":"started","branch":"'"$_BRANCH"'","session":"'"$_SESSION_ID"'"}' 2>/dev/null &
low line 96

Access to hidden dotfiles in home directory

SourceSKILL.md
96_ROUTING_DECLINED=$(~/.claude/skills/gstack/bin/gstack-config get routing_declined 2>/dev/null || echo "false")
low line 107

Access to hidden dotfiles in home directory

SourceSKILL.md
107_CHECKPOINT_MODE=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_mode 2>/dev/null || echo "explicit")
low line 108

Access to hidden dotfiles in home directory

SourceSKILL.md
108_CHECKPOINT_PUSH=$(~/.claude/skills/gstack/bin/gstack-config get checkpoint_push 2>/dev/null || echo "false")
medium line 129

Access to hidden dotfiles in home directory

SourceSKILL.md
129In plan mode, allowed because they inform the plan: `$B`, `$D`, `codex exec`/`codex review`, writes to `~/.gstack/`, writes to the plan file, and `open` for generated artifacts.
medium line 137

Access to hidden dotfiles in home directory

SourceSKILL.md
137If `SKILL_PREFIX` is `"true"`, suggest/invoke `/gstack-*` names. Disk paths stay `~/.claude/skills/gstack/[skill-name]/SKILL.md`.
medium line 139

Access to hidden dotfiles in home directory

SourceSKILL.md
139If output shows `UPGRADE_AVAILABLE <old> <new>`: read `~/.claude/skills/gstack/gstack-upgrade/SKILL.md` and follow the "Inline upgrade flow" (auto-upgrade if configured, otherwise AskUserQuestion with
medium line 144

Access to hidden dotfiles in home directory

SourceSKILL.md
144- Missing `~/.claude/skills/gstack/.feature-prompted-continuous-checkpoint`: AskUserQuestion for Continuous checkpoint auto-commits. If accepted, run `~/.claude/skills/gstack/bin/gstack-config set che
medium line 145

Access to hidden dotfiles in home directory

SourceSKILL.md
145- Missing `~/.claude/skills/gstack/.feature-prompted-model-overlay`: inform "Model overlays are active. MODEL_OVERLAY shows the patch." Always touch marker.
medium line 158

Access to hidden dotfiles in home directory

SourceSKILL.md
158If B: run `~/.claude/skills/gstack/bin/gstack-config set explain_level terse`.
low line 162

Access to hidden dotfiles in home directory

SourceSKILL.md
162rm -f ~/.gstack/.writing-style-prompt-pending
low line 163

Access to hidden dotfiles in home directory

SourceSKILL.md
163touch ~/.gstack/.writing-style-prompted
low line 172

Access to hidden dotfiles in home directory

SourceSKILL.md
172touch ~/.gstack/.completeness-intro-seen
medium line 185

Access to hidden dotfiles in home directory

SourceSKILL.md
185If A: run `~/.claude/skills/gstack/bin/gstack-config set telemetry community`
medium line 195

Access to hidden dotfiles in home directory

SourceSKILL.md
195If B→A: run `~/.claude/skills/gstack/bin/gstack-config set telemetry anonymous`
medium line 196

Access to hidden dotfiles in home directory

SourceSKILL.md
196If B→B: run `~/.claude/skills/gstack/bin/gstack-config set telemetry off`
low line 200

Access to hidden dotfiles in home directory

SourceSKILL.md
200touch ~/.gstack/.telemetry-prompted
medium line 213

Access to hidden dotfiles in home directory

SourceSKILL.md
213If A: run `~/.claude/skills/gstack/bin/gstack-config set proactive true`
medium line 214

Access to hidden dotfiles in home directory

SourceSKILL.md
214If B: run `~/.claude/skills/gstack/bin/gstack-config set proactive false`
low line 218

Access to hidden dotfiles in home directory

SourceSKILL.md
218touch ~/.gstack/.proactive-prompted
medium line 260

Access to hidden dotfiles in home directory

SourceSKILL.md
260If B: run `~/.claude/skills/gstack/bin/gstack-config set routing_declined true` and say they can re-enable with `gstack-config set routing_declined false`.
medium line 264

Access to hidden dotfiles in home directory

SourceSKILL.md
264If `VENDORED_GSTACK` is `yes`, warn once via AskUserQuestion unless `~/.gstack/.vendoring-warned-$SLUG` exists:
medium line 276

Access to hidden dotfiles in home directory

SourceSKILL.md
2763. Run `~/.claude/skills/gstack/bin/gstack-team-init required` (or `optional`)
medium line 278

Access to hidden dotfiles in home directory

SourceSKILL.md
2785. Tell the user: "Done. Each developer now runs: `cd ~/.claude/skills/gstack && ./setup --team`"
low line 284

Access to hidden dotfiles in home directory

SourceSKILL.md
284eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)" 2>/dev/null || true
low line 285

Access to hidden dotfiles in home directory

SourceSKILL.md
285touch ~/.gstack/.vendoring-warned-${SLUG:-unknown}
low line 427

Access to hidden dotfiles in home directory

SourceSKILL.md
427_BRAIN_SYNC_BIN="~/.claude/skills/gstack/bin/gstack-brain-sync"
low line 428

Access to hidden dotfiles in home directory

SourceSKILL.md
428_BRAIN_CONFIG_BIN="~/.claude/skills/gstack/bin/gstack-config"
medium line 532

Access to hidden dotfiles in home directory

SourceSKILL.md
532If A/B and `~/.gstack/.git` is missing, ask whether to run `gstack-artifacts-init`. Do not block the skill.
low line 537

Access to hidden dotfiles in home directory

SourceSKILL.md
537"~/.claude/skills/gstack/bin/gstack-brain-sync" --discover-new 2>/dev/null || true
low line 538

Access to hidden dotfiles in home directory

SourceSKILL.md
538"~/.claude/skills/gstack/bin/gstack-brain-sync" --once 2>/dev/null || true
low line 581

Access to hidden dotfiles in home directory

SourceSKILL.md
581eval "$(~/.claude/skills/gstack/bin/gstack-slug 2>/dev/null)"
low line 598

Access to hidden dotfiles in home directory

SourceSKILL.md
598~/.claude/skills/gstack/bin/gstack-decision-search --recent 5 2>/dev/null
medium line 607

Access to hidden dotfiles in home directory

SourceSKILL.md
607**Cross-session decisions.** If `ACTIVE DECISIONS` are listed, treat them as prior settled calls with their rationale — do not silently re-litigate them; if you're about to reverse one, say so explici
medium line 620

Access to hidden dotfiles in home directory

SourceSKILL.md
620Curated jargon list lives at `~/.claude/skills/gstack/scripts/jargon-list.json` (80+ terms). On the first jargon term you encounter this session, Read that file once; treat the `terms` array as the ca
medium line 666

Access to hidden dotfiles in home directory

SourceSKILL.md
666Before each AskUserQuestion, choose `question_id` from `scripts/question-registry.ts` or `{skill}-{slug}`, then run `~/.claude/skills/gstack/bin/gstack-question-preference --check "<id>"`. `AUTO_DECID
low line 674

Access to hidden dotfiles in home directory

SourceSKILL.md
674~/.claude/skills/gstack/bin/gstack-question-log '{"skill":"sync-gbrain","question_id":"<id>","question_summary":"<short>","category":"<approval|clarification|routing|cherry-pick|feedback-loop>","door_
low line 683

Access to hidden dotfiles in home directory

SourceSKILL.md
683~/.claude/skills/gstack/bin/gstack-question-preference --write '{"question_id":"<id>","preference":"<pref>","source":"inline-user","free_text":"<optional original words>"}'
low line 703

Access to hidden dotfiles in home directory

SourceSKILL.md
703~/.claude/skills/gstack/bin/gstack-learnings-log '{"skill":"SKILL_NAME","type":"operational","key":"SHORT_KEY","insight":"DESCRIPTION","confidence":N,"source":"observed"}'
medium line 713

Access to hidden dotfiles in home directory

SourceSKILL.md
713`~/.gstack/analytics/`, matching preamble analytics writes.
low line 720

Access to hidden dotfiles in home directory

SourceSKILL.md
720rm -f ~/.gstack/analytics/.pending-"$_SESSION_ID" 2>/dev/null || true
low line 722

Access to hidden dotfiles in home directory

SourceSKILL.md
722~/.claude/skills/gstack/bin/gstack-timeline-log '{"skill":"SKILL_NAME","event":"completed","branch":"'$(git branch --show-current 2>/dev/null || echo unknown)'","outcome":"OUTCOME","duration_s":"'"$_T
low line 725

Access to hidden dotfiles in home directory

SourceSKILL.md
725echo '{"skill":"SKILL_NAME","duration_s":"'"$_TEL_DUR"'","outcome":"OUTCOME","browse":"USED_BROWSE","session":"'"$_SESSION_ID"'","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}' >> ~/.gstack/analytics/skill-
low line 728

Access to hidden dotfiles in home directory

SourceSKILL.md
728if [ "$_TEL" != "off" ] && [ -x ~/.claude/skills/gstack/bin/gstack-telemetry-log ]; then
low line 729

Access to hidden dotfiles in home directory

SourceSKILL.md
729~/.claude/skills/gstack/bin/gstack-telemetry-log \
medium line 753

Access to hidden dotfiles in home directory

SourceSKILL.md
753It does NOT touch `~/.gstack/` indexing (the existing `gstack-gbrain-source-wireup`
medium line 773

Access to hidden dotfiles in home directory

SourceSKILL.md
773`~/.claude/skills/gstack/bin/gstack-gbrain-sync.ts`.
low line 795

Access to hidden dotfiles in home directory

SourceSKILL.md
795~/.claude/skills/gstack/bin/gstack-gbrain-detect 2>/dev/null
low line 805

Access to hidden dotfiles in home directory

SourceSKILL.md
805_HASH=$(~/.claude/skills/gstack/bin/gstack-config endpoint-hash 2>/dev/null)
low line 806

Access to hidden dotfiles in home directory

SourceSKILL.md
806_POLICY=$(~/.claude/skills/gstack/bin/gstack-config get brain_trust_policy@$_HASH 2>/dev/null || echo unset)
low line 818

Access to hidden dotfiles in home directory

SourceSKILL.md
818~/.claude/skills/gstack/bin/gstack-config set brain_trust_policy@$_HASH personal
medium line 827

Access to hidden dotfiles in home directory

SourceSKILL.md
827`~/.gstack/transcripts/<run-id>/` and the artifacts pipeline pushes it to
low line 866

Access to hidden dotfiles in home directory

SourceSKILL.md
866Local gbrain config at ~/.gbrain/config.json points at an unreachable
low line 870

Access to hidden dotfiles in home directory

SourceSKILL.md
8702. Repair manually: mv ~/.gbrain/config.json ~/.gbrain/config.json.bak
low line 891

Access to hidden dotfiles in home directory

SourceSKILL.md
891bun run ~/.claude/skills/gstack/bin/gstack-gbrain-sync.ts <user-args>
medium line 896

Access to hidden dotfiles in home directory

SourceSKILL.md
896still run. State is persisted to `~/.gstack/.gbrain-sync-state.json` via
medium line 898

Access to hidden dotfiles in home directory

SourceSKILL.md
898`~/.gstack/.sync-gbrain.lock` (5-min stale-takeover).
low line 907

Access to hidden dotfiles in home directory

SourceSKILL.md
907SOURCE_ID=$(grep -o '"source_id":"[^"]*"' ~/.gstack/.gbrain-sync-state.json 2>/dev/null \
low line 958

Access to hidden dotfiles in home directory

SourceSKILL.md
958SOURCE_ID=$(grep -o '"source_id":"[^"]*"' ~/.gstack/.gbrain-sync-state.json 2>/dev/null \
low line 1014

Access to hidden dotfiles in home directory

SourceSKILL.md
1014if [ -f ~/.gbrain/config.json ] && \
low line 1071

Access to hidden dotfiles in home directory

SourceSKILL.md
1071- `~/.gstack/` curated memory (registered as `gstack-brain-<user>` source via
low line 1133

Access to hidden dotfiles in home directory

SourceSKILL.md
1133~/.gstack source. OK <gstack-brain-{user}> (page_count=<N>) — managed by /setup-gbrain
medium line 1168

Access to hidden dotfiles in home directory

SourceSKILL.md
1168Mac. The orchestrator acquires a lock at `~/.gstack/.sync-gbrain.lock` before
medium line 1175

Access to hidden dotfiles in home directory

SourceSKILL.md
1175and travels with `git push`/`git pull` — NOT through `~/.gstack/.brain-allowlist`
medium line 1176

Access to hidden dotfiles in home directory

SourceSKILL.md
1176(which is for `~/.gstack/` brain-sync only). On a different Mac with a synced
low line 168

External URL reference

SourceSKILL.md
168If `LAKE_INTRO` is `no`: say "gstack follows the **Boil the Ocean** principle — do the complete thing when AI makes marginal cost near-zero. Read more: https://garryslist.org/posts/boil-the-ocean" Off
low line 171

External URL reference

SourceSKILL.md
171open https://garryslist.org/posts/boil-the-ocean
Scanned on Jun 10, 2026
View Security Dashboard
Installation guide →
GitHub Stars 104.9K
Rate this skill
Categorydevelopment
UpdatedJune 10, 2026
claudeclaude-codecodexclinefrontenddesignsupabasedocxgitapitestingdevopsbackend
garrytan/gstack