gsd:surface

Sub-commands: list · status · profile · disable · enable · reset

Sub-command routing

Parse the first token of $ARGUMENTS:

Token	Action
list	Show enabled + disabled clusters and skills
status	Alias for list plus token cost summary
profile <name>	Write baseProfile and re-stage
profile <n1>,<n2>	Composed profiles (comma-separated, no spaces)
disable <cluster>	Add cluster to disabledClusters, re-stage
enable <cluster>	Remove cluster from disabledClusters, re-stage
reset	Delete .gsd-surface.json, return to install-time profile
(none)	Treat as list

---

list / status

Call listSurface(runtimeConfigDir, manifest, CLUSTERS) from get-shit-done/bin/lib/surface.cjs. Display:

Enabled (N skills, ~T tokens):
  core_loop:   new-project  discuss-phase  plan-phase  execute-phase  help  update
  audit_review: …
  …

Disabled:
  utility:  health  stats  settings  …

Token cost: ~T (budget cap ~500 tokens for 200k context @ 1%)

For status also append:

Base profile:   standard  (from .gsd-surface.json)
Install profile: standard  (from .gsd-profile)

---

profile <name>

1. Read current surface: readSurface(runtimeConfigDir) → if null, seed from readActiveProfile(runtimeConfigDir).
2. Set surfaceState.baseProfile = name.
3. writeSurface(runtimeConfigDir, surfaceState).
4. Resolve and re-apply: applySurface(runtimeConfigDir, commandsDir, agentsDir, manifest, CLUSTERS).
5. Confirm: "Surface updated to profile <name>. N skills enabled."

---

disable <cluster>

Valid cluster names: core_loop, audit_review, milestone, research_ideate, workspace_state, docs, ui, ai_eval, ns_meta, utility.

1. Validate cluster name against Object.keys(CLUSTERS).
2. Read or initialize surface state.
3. Add cluster to surfaceState.disabledClusters (deduplicate).
4. writeSurface → applySurface.
5. Confirm: "Disabled cluster <cluster>. N skills removed from surface."