Gas Town Cursor
Agent Buildinggas-town-cursorGas Town Cursor is an Agent Skill for agent building published in the gastownhall/gastown repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/gastownhall/gastown/blob/HEAD/.cursor/skills/gas-town-cursor/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/gas-town-cursor, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Gas Town + Cursor Agent CLI
Use this skill when working in this repository with the cursor agent preset (CLI binary cursor-agent, sometimes symlinked as agent).
Concepts
| 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). |
Essential commands
- Build / run
gtfrom repo root:make buildorgo run ./cmd/gt …. - Point a session at the Cursor preset: spawn or config so the runtime uses
--agent cursor(or setGT_AGENT=cursorwhere applicable). - After changing hooks or settings:
gt up --restore(or role-specific restart) so agents reload config.
Resume semantics
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).
Read more
- Beads / plan handoff:
docs/cursor-runtime-beads-tasks.md - Agent instructions for automation:
AGENTS.mdandCLAUDE.md(project-wide, not Cursor-only)
Boundary
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.