open-gsd/gsd-core

gsd-workstreams

Manage parallel workstreams — list, create, switch, status, progress, complete, and resume

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/open-gsd/gsd-core --skill gsd-workstreams

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

/gsd-workstreams

Manage parallel workstreams for concurrent milestone work.

Usage

/gsd-workstreams [subcommand] [args]

Subcommands

CommandDescription
listList all workstreams with status
create <name>Create a new workstream
status <name>Detailed status for one workstream
switch <name>Set active workstream
progressProgress summary across all workstreams
complete <name>Archive a completed workstream
resume <name>Resume work in a workstream

Step 1: Parse Subcommand

Parse the user's input to determine which workstream operation to perform. If no subcommand given, default to list.

Step 2: Execute Operation

list

Run: gsd_run query workstream.list --raw --cwd "$CWD" Display the workstreams in a table format showing name, status, current phase, and progress.

create

Run: gsd_run query workstream.create <name> --raw --cwd "$CWD" After creation, display the new workstream path and suggest next steps:

  • /gsd-new-milestone --ws <name> to set up the milestone

status

Run: gsd_run query workstream.status <name> --raw --cwd "$CWD" Display detailed phase breakdown and state information.

switch

Run: gsd_run query workstream.set <name> --raw --cwd "$CWD" Also set GSD_WORKSTREAM for the current session when the runtime supports it. If the runtime exposes a session identifier, GSD also stores the active workstream session-locally so concurrent sessions do not overwrite each other.

progress

Run: gsd_run query workstream.progress --raw --cwd "$CWD" Display a progress overview across all workstreams.

complete

Run: gsd_run query workstream.complete <name> --raw --cwd "$CWD" Archive the workstream to milestones/.

resume

Set the workstream as active and suggest /gsd-resume-work --ws <name>.

Step 3: Display Results

Format the JSON output from gsd-tools query into a human-readable display. Include the ${GSD_WS} flag in any routing suggestions.

Related by task

from this repository

More skills

All skills