Gas Town v0.5.0

Pre-compiled binaries for Linux, macOS (Intel & Apple Silicon), and Windows.

Installation

Homebrew (macOS/Linux):

brew install steveyegge/gastown/gt

npm (Node.js):

npm install -g @gastown/gt

Manual Install: Download the appropriate binary for your platform below, extract it, and place it in your PATH.

Changelog

Features

• cd347dfdf93e70ac995cf75d01cb794f953a94c8 feat(bead): add 'read' as alias for 'show' subcommand
• f6fab3afadf7b936a30533e0a71cad4bb60cc8a4 feat(cmd): add --comment as alias for --reason in gt close
• e12aa45dd68ea23e415395aca0f9b903a86d0375 feat(config): add Env field to RuntimeConfig and AgentPresetInfo (#860)
• f00b0254f224ac026d0f660169874677a3de489d feat(config): add OpenCode as built-in agent preset (#861)
• 7a2090bb15b70cbd352992cedcbc2452e690d553 feat(config): add ShellQuote helper for safe env var escaping (#830)
• d0a1e165e55bab28d949164a8e25107b83a132a5 feat(convoy): add redundant observers to Witness and Refinery
• aef99753dfd3d70982853a9498f57b95f4ad243b feat(convoy): add specific convoy ID check and dry-run flag
• 9b412707ab7dbb031bff12936a5b6f15c79e9fad feat(convoy): default owner to creator when not specified
• 0db2bda6e6d815da66de7bdec8e17941a5f31a6a feat(deacon): add zombie-scan command for tmux-verified process cleanup
• 5791cd7e34db7ea6cb6ae5058910d5c6fc997ef8 feat(doctor): add auto-fix capability to SessionHookCheck (#857)
• 6c5c671595b00adcd79488b5764434f65a4c31fb feat(doctor): add routing-mode check to detect .beads-planning routing bug (#810)
• afc1ff04b1657d8332ddf0ee94032fdd75b365e9 feat(formula): add verification legs and presets to code-review (#841)
• 37f465bde5148518772d883a87319e4c69cf49c0 feat(hooks): add gt block-pr-workflow command for PreToolUse hook
• d0e49a216aaf2dd2d3f429792b491721401ec07b feat(hooks): add hook registry and install command (bd-qj9nc)
• 1dc31024ca2e1fff45ff6157ea6683f59ed484b7 feat(mail): accept multiple message IDs in delete command
• d610d444d78cf03f8e6f824d84380ff3d53e5bf9 feat(mail): add --all flag to 'gt mail inbox' command
• 3d7b1093954b477187a2b68bd50c2d0edcf18cae feat(mail): add --body as alias for --message/-m in gt mail send
• 785d9adfef7eb2bd58114ddd1242a09bc59d44f4 feat(mail): add gt mail hook as alias for gt hook attach
• b612df0463ada48fb1590496538e11aa1f768fb4 feat(mail): add numeric index support to 'gt mail read'
• 6616a4726cd2ecac8eaa84c00641c624ab3ebcdb feat(mail): support positional message arg in reply command
• 44d5b4fdd2f8cda92bc2724a6f5e7db692edbf29 feat(orphans): add --aggressive flag for tmux-verified orphan detection
• 6e2169de7f88b3c3849ed72f967b6a6f1cab7ae8 feat(orphans): add gt orphans kill command
• d67aa0212cb40ae6deab04b0fee816dc0867409b feat(refinery): use squash merge to eliminate redundant merge commits (#856)
• 544cacf36de74979b43a3ca592a534f96914cfd9 feat(roles): add config-based role definition system (Phase 1)
• a6102830785430065d79c908563a691fb14da44c feat(roles): switch daemon to config-based roles, remove role beads (Phase 2+3)
• 9f06eb94c4f0fea3ca24b9125c540c30e540670e feat(seance): support cross-account session access
• 7c2f9687ecf1840c450cfb36bb3f1fedb8e0f429 feat(wisp): add misclassified wisp detection and defense-in-depth filtering (#833)
• 02390251fc6135aebc3baa166ac8b0cffacdb62a feat: Add configurable polecat branch naming (#825)
• dff6c3fb3c23a1fbf2feed7c6a21346a2a62857c feat: add aliases and deacon status line display
• fd6125933628db3fca35baf67ec1f8df8ebcce9d feat: add initial prompt for autonomous patrol startup (deacon & witness) (#769)

Bug Fixes

• fa1f812ce987052e6fb8bf6ea4bca9030e428337 fix(beads): multi-repo routing for custom types and role slots
• a8be623eeb10aaabd396a4040de89d6f03453ca6 fix(cmd): extract orphan cleanup to platform-specific files (#835)
• 55a3b9858a73049e1e039d3c1ee0bf5d7469eb87 fix(config): correct Claude prompt prefix from > to ❯ (#765)
• 35abe21c504f3d81097e110eb407dcbc229cf39e fix(convoy): pass specific convoy ID in ConvoyWatcher check
• a8bedd2172d51ac50a9229f718e7c4d2f75f9980 fix(costs): add event to BeadsCustomTypes constant (#731)
• 45951c0fad399b937d7248334ceb886b31421b87 fix(costs): skip test affected by bd CLI 0.47.2 commit bug
• fb4c415127484ac479c48e70e730928ef9feb228 fix(crew): auto-recover from stale tmux pane references
• e57297cb1b1d6248d2d47b776e0c4cb55f4c4141 fix(crew): don't kill pane processes when creating new session
• 183a0d7d8d9b06684ec396f272792492ef3ae879 fix(crew): use directory name as source of truth in loadState (#785)
• 0cdcd0a20b2dcf07a11422001ecbff5e70ad18a0 fix(daemon): spawn Deacon immediately after killing stuck session (#729)
• 3931d10af369e695a8e6d531127e9afbc44a71b0 fix(dashboard): use registered rigs for merge queue instead of hardcoded repos (#863)
• e59955a5804c762819bdeb9bca83ef499edc9daf fix(docs): link for go install (#792)
• 2119841d57d98d166e86d6bd55799e66da788e3e fix(doctor): check patrol formulas instead of placeholder beads (#715)
• 77126283dd9c76ecf4eaff348a48f51a073ea78c fix(done): allow completion when work pushed directly to main
• 9a91a1b94f2c3e42a8620fc03e5f322d5a3e7acf fix(done): restrict gt done to polecats only
• 2fe23b7be5b98b29eff42b61e38674e7591b4516 fix(done): terminate polecat session for all exit types (#800)
• 1a0f2d6b3be7a37be8680eea67b0d45f28d0f2d0 fix(formula): clarify WITNESS_PING routing in witness patrol (#854)
• 987502ebb39b6dfced314415c7a85a1de4202746 fix(formula): sync source formula with embedded changes (#845)
• e591f2ae2512d68265e535f39a3f514095e107b9 fix(formulas): replace hardcoded ~/gt/ paths with $GT_ROOT (#758)
• 08cee416a40b30286389483d3af61a223cf762f9 fix(handoff): normalize identity in sendHandoffMail (#780)
• 48ace2cbf36ce242e28d4b8f0ec297b5bcab310c fix(handoff): preserve GT_AGENT across session restarts (#788)
• 39b1c11bb66ecb743bc7b34303b9025116cd0763 fix(handoff): use env var fallback when town root detection fails
• c42b5db7ab9c3cd98aaa69d5a60a2629de7e7fd6 fix(hook): normalize agent ID trailing slash in agentIDToBeadID (gt-az3jjb)
• 77ac332a413638ba1a44c359f223b5d33cad25c0 fix(hooks): add PreToolUse pr-workflow guard to settings templates
• 7016b33b39a934d48dbc71540fe30341e6e0efbb fix(hooks): allow feature branches in contributor workflow (#850)
• 40cc4c9335bbd7d3320bffa705392eeebee7d3fa fix(identity): copy all agent fields during polecat identity rename

Others

• 5c45b4438a71983503c59523b09236a9e2965b6e Add Windows stub for orphan cleanup (#808)
• 7e5c3dd6951d4e239a98cafd65f464ef0f26d9f7 Add comprehensive tests for internal/dog package (#737)
• 477c28c9d19c21188db12b92d9fbb4b3fcfb29d2 Create initial commit before gh repo create --push
• 6966eb4c28c4070e7d96f0f43c806c575b650d9a Escape backticks and dollar signs in quoteForShell (#777)
• 2514507a49a0ad6547b15c1545f99ffb8236170e Fix GT_ROOT export for beads formula search compatibility (#718)
• 6bfe61f796d51db95f9def16a29bb1547cdd791d Fix daemon shutdown detection bug
• 1b036aadf51450d39b4f381fd528e8d4fc4ec0b0 Fix deacon patrol process leak by killing pane processes before respawn (#745)
• 1e97d1e6372a89ca55f8a936876feec67f975f76 Fix go-19z: updateAgentHookBead uses wrong directory for rig-level beads (#733)
• 9de8859be0bebaf86d6ca0339fc1151c2057effc Fix orphan detection to recognize hq-* sessions (#744)
• e4ebd0784ab5728721d316f74fdf3d0966c903e5 Fix settings templates to use 'gt prime --hook' for session ID tracking (#719)
• 371074cc67a35d210ff8d854c693f8ee703893af Fix tmux error handling for "no current target" (#755)
• 3d5a66f85096030b5213e5531cde2f278ca9a29d Fixing unit tests on windows (#813)
• b2b9cbc836f222ac360163e72ffe310c7819939a Merge upstream/main into fix/fresh-install-fixes
• 748fa739318876c16c5b7e7a1dd0a43bbc380031 chore(formula): trim verbose witness-patrol description
• 5cc2995345508906702dfd6a631700a48387243a chore(release): v0.5.0
• 5a14053a6bd32444bb4a297feb7b89acda53035e docs(templates): add explicit bead filing guidance to role templates
• 6a22b47ef6f8c91243dc64398ea94bcc1f82af0e fix(await-signal): update agent last_activity on signal received (#774)
• 78ca8bd5bfa5d5cf0bfe15de97b31ee05ab5b642 fix(witness,refinery): remove ZFC-violating state types
• 0a6b0b892f38c99d0f830a4c28ce8234a696500a fix(witness,rig): code review cleanup
• a5bbe244445c5c9319d42ede784da8714155f6ae perf: parallelize mail inbox queries for ~6x speedup
• dcf7b81011b61bbc027c87c8669431dd48a18931 refactor(hooks): rename to gt tap guard pr-workflow
• 5218102f4916a9d20e54797f823bf2aba3f724f4 refactor(witness,refinery): ZFC-compliant state management