deathbyknowledge/gsv-system-operations
skills/gsv-system-operations/SKILL.md
Guide on how to operate and update a GSV deployment, including which layer changed, what to validate, and what to deploy or sync.
$ install --global
skillsauthnpx skillsauth add deathbyknowledge/gsv gsv-system-operationsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 6, 2026, 2:50 AM209.1s1 file scanned
SKILL.md
- name:
- gsv-system-operations
- description:
- Guide on how to operate and update a GSV deployment, including which layer changed, what to validate, and what to deploy or sync.
GSV System Operations
Identify the Layer
Validate and deploy the layer you changed:
gateway/src/*: Gateway worker, Kernel, process runtime, syscalls, packages, auth, adapters, inference, native tools.web/src/*orweb/public/*: Desktop web shell and app host.builtin-packages/*: builtin apps synced fromroot/gsv.adapters/*: standalone WhatsApp, Discord, or test adapter workers.cli/*: Rust host CLI and device daemon.ripgit/*: git-backed storage worker.
Combined changes require each affected update path.
Local Validation
Gateway:
cd gateway
npx tsc --noEmit
npm run test:run
Web:
cd web
npm run check
npm run build
CLI:
cd cli
cargo fmt --check
cargo test
Adapters:
cd adapters/whatsapp && npx tsc --noEmit
cd adapters/discord && npm run typecheck
cd adapters/test && npm run typecheck
Use the smallest relevant checks when the change is narrow.
Deploy and Sync
Gateway:
cd gateway
npm run deploy
Web shell:
cd web
npm run build
Adapter workers:
cd adapters/whatsapp && npm run deploy
cd adapters/discord && npm run deploy
Builtin packages are not updated by redeploying Gateway alone. Update the root/gsv source, then run:
gsv packages sync
If package runtime, SDK, assembler, or Gateway behavior changed, deploy those components before syncing builtins.
Bootstrap Upstream for Development
Bootstrap imports root/gsv from the configured upstream. For development, use the configured bootstrap upstream/ref instead of merging to main just to test seeded packages or skills.
Use explicit setup/bootstrap args when available, or configure worker dev vars such as:
GSV_BOOTSTRAP_UPSTREAM=deathbyknowledge/gsv#my-branch
GSV_BOOTSTRAP_REF=my-branch
If both are set, explicit request args win, then environment, then the default https://github.com/deathbyknowledge/gsv#main.
Operational Distinctions
- Redeploying Gateway changes Kernel/runtime code.
- Rebuilding web changes the Desktop shell bundle.
- Syncing builtins reassembles installed builtin packages from
root/gsv. - Pulling upstream refreshes a ripgit source from its remote.
- Checking out a package moves its installed source ref.
- Syncing a package re-runs assembly for the ref it already points at.
Do not collapse these into one "update" step. Pick the operation that matches the state you need to change.
Related Skills
deathbyknowledge/browser-shell
development
VerifiedTrustedCommunity
Use active GSV web shell browser targets to inspect windows/apps, run browser JS, open files, and move files across targets.
58SKILL.mdUpdated May 25, 2026
deathbyknowledge/gsv-process-identity
documentation
VerifiedTrustedCommunity
Guide on what a GSV process is, how to orient around its identity, cwd, virtual filesystem paths, source mounts, and runtime events.
58SKILL.mdUpdated May 6, 2026
deathbyknowledge/gsv-process-coordination
documentation
VerifiedTrustedCommunity
Guide on how to coordinate durable GSV processes, including spawning, IPC, handoffs, scheduled work, conversation state, and compaction.
58SKILL.mdUpdated May 6, 2026
deathbyknowledge/gsv-context-and-skills
documentation
VerifiedTrustedCommunity
Guide on how context and skills work in GSV and how to add/edit them.
58SKILL.mdUpdated May 6, 2026