// Develop and operate Gas Town with the Cursor agent preset (cursor-agent CLI): gt flags, hooks at .cursor/hooks.json, session resume, and how this repo differs from README marketing copy.
Canonical commit workflow for Gas Town crew members: pre-flight checks, branch creation, gt commit with agent identity, push, and PR creation. Use when ready to commit and submit work for review.
List GitHub issues in a formatted ASCII table. Supports filters like --state, --assignee, --label. Use for issue triage and tracking workflows.
List GitHub PRs in a formatted ASCII table. Supports filters like --state, --author, --label. Use for PR review workflows and sheriff duties.
PR Sheriff workflow: triage PRs into easy-wins and crew assignments. Prints recommendations inline - does NOT post to GitHub.
The definitive guide for working with gastown's convoy system -- batch work tracking, event-driven feeding, stage-launch workflow, and dispatch safety guards. Use when writing convoy code, debugging convoy behavior, adding convoy features, testing convoy changes, or answering questions about how convoys work. Triggers on convoy, convoy manager, convoy feeding, dispatch, stranded convoy, feedFirstReady, feedNextReadyIssue, IsSlingableType, isIssueBlocked, CheckConvoysForIssue, gt convoy, gt sling, stage, launch, staged, wave.
| name | gas-town-cursor |
| description | Develop and operate Gas Town with the Cursor agent preset (cursor-agent CLI): gt flags, hooks at .cursor/hooks.json, session resume, and how this repo differs from README marketing copy. |
Use this skill when working in this repository with the cursor agent preset (CLI binary cursor-agent, sometimes symlinked as agent).
| Name | Meaning |
|---|---|
Preset cursor | Gas Town agent id (GT_AGENT=cursor). Config lives in internal/config/agents.go (AgentCursor). |
Binary cursor-agent | The Cursor Agent CLI process name for pane/detection; install docs may also symlink agent → same binary. |
| Hooks | Cursor lifecycle hooks are configured at .cursor/hooks.json (see preset HooksSettingsFile). |
gt from repo root: make build or go run ./cmd/gt ….--agent cursor (or set GT_AGENT=cursor where applicable).gt up --restore (or role-specific restart) so agents reload config.The Cursor preset uses --resume <chatId> style resume (ResumeStyle: flag). Session identity is not carried in a dedicated env var in the same way as Claude’s CLAUDE_SESSION_ID; follow the preset fields in internal/config/agents.go (ResumeFlag, ResumeStyle).
docs/cursor-runtime-beads-tasks.mdAGENTS.md and CLAUDE.md (project-wide, not Cursor-only)Project README is user-facing product overview; .cursor/README.md is Cursor-specific onboarding for this repo. Prefer linking to those files instead of duplicating long install steps inside skills.