beads/crew/emma 37f465bde5 feat(hooks): add gt block-pr-workflow command for PreToolUse hook ...

Implements infrastructure-level enforcement of the "no PRs" policy.
When a Claude Code agent tries to run `gh pr create`, `git checkout -b`,
or `git switch -c`, the PreToolUse hook calls this command which:

- Detects if we're in a Gas Town agent context (crew, polecat, etc.)
- If so, exits with code 2 to BLOCK the tool execution
- Outputs helpful guidance on what to do instead (push to main)

This makes the rule ironclad - agents can't create PRs even if they
try, because the hook intercepts and blocks before execution.

Hook configuration (add to .claude/settings.json):
  "PreToolUse": [{
    "matcher": "Bash(gh pr create*)",
    "hooks": [{"command": "gt block-pr-workflow --reason pr-create"}]
  }]

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-19 10:09:15 -08:00

..

account_test.go

…

account.go

…

activity.go

…

agent_state_test.go

…

agent_state.go

…

agents.go

…

audit_test.go

…

audit.go

…

bead.go

feat(bead): add 'gt bead show' subcommand

2026-01-16 15:56:29 -08:00

beads_db_init_test.go

fix(beads): init db for tracked beads after clone (#376)

2026-01-11 23:03:47 -08:00

beads_routing_integration_test.go

fix(beads): prevent routes.jsonl corruption and add doctor check for rig-level routes.jsonl (#377)

2026-01-12 01:45:26 -08:00

beads_version_test.go

…

beads_version.go

fix(hook): handle error from events.LogFeed (#440)

2026-01-13 13:40:57 -08:00

block_pr_workflow.go

feat(hooks): add gt block-pr-workflow command for PreToolUse hook

2026-01-19 10:09:15 -08:00

boot_test.go

feat(refinery,boot): add --agent flag for model selection (#469)

2026-01-13 13:14:47 -08:00

boot.go

feat(refinery,boot): add --agent flag for model selection (#469)

2026-01-13 13:14:47 -08:00

broadcast.go

fix(broadcast): exclude sender from recipients

2026-01-17 03:19:08 -08:00

callbacks.go

…

cat.go

feat(cmd): add 'gt cat' command to display bead content

2026-01-15 17:44:40 -08:00

checkpoint_cmd.go

…

close.go

feat(cmd): add desire-path commands for agent ergonomics

2026-01-16 15:28:55 -08:00

commit_test.go

feat(identity): add gt commit wrapper and gt trail command

2026-01-13 19:34:29 -08:00

commit.go

feat(identity): add gt commit wrapper and gt trail command

2026-01-13 19:34:29 -08:00

config_test.go

…

config.go

feat(identity): add gt commit wrapper and gt trail command

2026-01-13 19:34:29 -08:00

convoy.go

fix(convoy): capture stderr for 'couldn't track issue' warnings

2026-01-17 00:37:57 -08:00

costs_test.go

…

costs_workdir_test.go

fix(beads): align agent bead prefixes and force multi-hyphen IDs (#482)

2026-01-16 12:33:51 -08:00

costs.go

fix(costs): disable cost tracking until Claude Code exposes cost data

2026-01-17 02:49:17 -08:00

crew_add.go

feat: Set and Forget - Seamless Gas Town Integration (#255)

2026-01-08 20:25:01 -08:00

crew_at.go

refactor(config): remove BEADS_DIR from agent environment and add doctor check (#455)

2026-01-13 22:13:57 -08:00

crew_cycle.go

…

crew_helpers.go

fix(tmux): use switch-client when already inside tmux session

2026-01-16 15:27:59 -08:00

crew_lifecycle.go

fix(orphan): prevent Claude Code session leaks on macOS

2026-01-17 03:49:18 -08:00

crew_list_test.go

test: cover gt crew list --all

2026-01-09 02:22:36 +13:00

crew_list.go

feat: add --all to gt crew list

2026-01-09 02:22:20 +13:00

crew_maintenance.go

…

crew_status.go

feat(crew): accept rig name as positional arg in crew status

2026-01-12 23:07:49 -08:00

crew.go

docs: improve help text and add nudge documentation

2026-01-17 02:55:39 -08:00

cycle.go

…

daemon.go

…

dashboard_test.go

…

dashboard.go

…

deacon.go

docs: improve help text and add nudge documentation

2026-01-17 02:55:39 -08:00

disable.go

feat: Set and Forget - Seamless Gas Town Integration (#255)

2026-01-08 20:25:01 -08:00

dnd_test.go

…

dnd.go

…

doctor.go

fix(doctor): add zombie session check to detect dead Claude in tmux

2026-01-16 14:54:45 -08:00

dog.go

docs: improve help text and add nudge documentation

2026-01-17 02:55:39 -08:00

done_test.go

fix(dog): exclude non-dog entries from kennel listing

2026-01-17 09:46:25 -08:00

done.go

fix(orphan): prevent Claude Code session leaks on macOS

2026-01-17 03:49:18 -08:00

down_test.go

Feat/gt down tests (#15) (#18) (#330)

2026-01-10 22:56:33 -08:00

down.go

fix(down): prevent tmux server exit when all sessions killed

2026-01-17 01:34:38 -08:00

enable.go

feat: Set and Forget - Seamless Gas Town Integration (#255)

2026-01-08 20:25:01 -08:00

errors_test.go

fix(errors): use errors.As for wrapped error handling (#462)

2026-01-16 11:05:59 -08:00

errors.go

fix(errors): use errors.As for wrapped error handling (#462)

2026-01-16 11:05:59 -08:00

escalate_impl.go

fix(config): don't export empty GT_ROOT/BEADS_DIR in AgentEnv (#385)

2026-01-12 02:45:03 -08:00

escalate.go

feat(escalate): align config schema with design doc

2026-01-12 02:31:06 -08:00

feed.go

…

formula.go

fix(beads): align agent bead prefixes and force multi-hyphen IDs (#482)

2026-01-16 12:33:51 -08:00

gate.go

…

gitinit.go

feat(doctor): add safeguards for town root branch protection

2026-01-09 14:11:53 -08:00

handoff.go

fix(handoff): use correct witness working directory (#444)

2026-01-13 13:39:55 -08:00

help.go

feat(ui): import comprehensive UX system from beads

2026-01-09 22:46:06 -08:00

hook_slot_integration_test.go

…

hook.go

feat(cmd): add desire-path commands for agent ergonomics

2026-01-16 15:28:55 -08:00

hooks_test.go

…

hooks.go

…

info.go

chore: Bump version to 0.4.0

2026-01-17 12:46:49 -08:00

init.go

feat(doctor): add custom types check and centralize BeadsCustomTypes

2026-01-09 13:30:11 -08:00

install_integration_test.go

fix(install): allow --wrappers in existing town without recreating HQ (#366)

2026-01-11 18:45:24 -08:00

install.go

fix(install): set allowed_prefixes for convoy beads during gt install (#601)

2026-01-17 00:00:47 -08:00

issue.go

…

log.go

…

mail_announce.go

refactor(beads,mail): split large files into focused modules

2026-01-09 23:01:55 -08:00

mail_channel.go

fix(mail): improve channel subscribe/unsubscribe feedback

2026-01-17 09:49:53 -08:00

mail_check.go

refactor(beads,mail): split large files into focused modules

2026-01-09 23:01:55 -08:00

mail_group_test.go

feat(mail): add group management commands

2026-01-14 21:18:20 -08:00

mail_group.go

feat(mail): add group management commands

2026-01-14 21:18:20 -08:00

mail_identity.go

refactor(beads,mail): split large files into focused modules

2026-01-09 23:01:55 -08:00

mail_inbox.go

fix(mail): refactor duplicated inbox logic and fix clear race condition (#435)

2026-01-13 13:45:25 -08:00

mail_queue.go

feat(mail): add queue management commands

2026-01-14 21:29:37 -08:00

mail_search.go

refactor(beads,mail): split large files into focused modules

2026-01-09 23:01:55 -08:00

mail_send.go

feat(mail): update mail send to use address resolver

2026-01-14 21:19:54 -08:00

mail_test.go

feat(mail): implement beads-native gt mail claim command

2026-01-14 21:25:11 -08:00

mail_thread.go

refactor(beads,mail): split large files into focused modules

2026-01-09 23:01:55 -08:00

mail.go

feat(mail): add 'ack' alias for mark-read command

2026-01-17 01:33:29 -08:00

mayor.go

docs: improve help text and add nudge documentation

2026-01-17 02:55:39 -08:00

migrate_agents_test.go

fix(migrate_agents_test): test actually calls getMigrationStatusIcon

2026-01-16 12:41:23 -08:00

migrate_agents.go

fix(migrate_agents_test): test actually calls getMigrationStatusIcon

2026-01-16 12:41:23 -08:00

molecule_attach_from_mail_test.go

…

molecule_attach_from_mail.go

…

molecule_attach.go

…

molecule_await_signal_test.go

…

molecule_await_signal.go

chore: Bump version to 0.4.0

2026-01-17 12:46:49 -08:00

molecule_lifecycle.go

feat(patrol): add daily patrol digest aggregation

2026-01-17 02:11:12 -08:00

molecule_status.go

fix(hook): warn when hooked bead is already closed

2026-01-09 22:10:09 -08:00

molecule_step_test.go

…

molecule_step.go

…

molecule.go

…

mq_integration.go

feat(mq): add configurable integration branch naming (#104)

2026-01-09 00:41:35 -08:00

mq_list.go

fix(mq): skip closed MRs in list, next, and ready views (#563)

2026-01-16 15:23:28 -08:00

mq_next.go

fix(mq): skip closed MRs in list, next, and ready views (#563)

2026-01-16 15:23:28 -08:00

mq_status.go

…

mq_submit.go

fix(resume): capture error in handoff message fallback (#583)

2026-01-16 15:27:38 -08:00

mq_test.go

fix(resume): capture error in handoff message fallback (#583)

2026-01-16 15:27:38 -08:00

mq_testutil_test.go

…

mq.go

feat(mq): add configurable integration branch naming (#104)

2026-01-09 00:41:35 -08:00

namepool.go

fix(namepool): only persist runtime state, not config in state file

2026-01-17 01:40:02 -08:00

notify.go

…

nudge_test.go

…

nudge.go

docs: improve help text and add nudge documentation

2026-01-17 02:55:39 -08:00

orphans.go

feat(orphans): make kill command handle both commits and processes

2026-01-16 15:44:07 -08:00

park.go

…

patrol_helpers.go

…

patrol_test.go

test(patrol): add unit tests for patrol.go

2026-01-17 03:47:18 -08:00

patrol.go

fix(patrol): add idempotency check for digest command

2026-01-17 03:41:18 -08:00

peek.go

…

plugin.go

feat(plugin): add run and history commands for plugin management

2026-01-12 16:42:33 -08:00

polecat_cycle_test.go

…

polecat_cycle.go

…

polecat_dotdir_test.go

…

polecat_helpers.go

fix(beads): align agent bead prefixes and force multi-hyphen IDs (#482)

2026-01-16 12:33:51 -08:00

polecat_identity.go

fix(beads): align agent bead prefixes and force multi-hyphen IDs (#482)

2026-01-16 12:33:51 -08:00

polecat_spawn.go

fix(polecat): kill orphan sessions and clear stale hooks during allocation (#448)

2026-01-13 13:37:00 -08:00

polecat.go

docs: improve help text and add nudge documentation

2026-01-17 02:55:39 -08:00

prime_molecule.go

fix: handle bd --no-daemon exit code 0 bug on not-found (#339)

2026-01-11 18:37:01 -08:00

prime_output.go

feat(crew): accept rig name as positional arg in crew status

2026-01-12 23:07:49 -08:00

prime_session.go

refactor(prime): split 1833-line file into logical modules

2026-01-10 18:28:14 -08:00

prime_state.go

refactor(prime): split 1833-line file into logical modules

2026-01-10 18:28:14 -08:00

prime_test.go

fix(dog): exclude non-dog entries from kennel listing

2026-01-17 09:46:25 -08:00

prime.go

feat(crew): accept rig name as positional arg in crew status

2026-01-12 23:07:49 -08:00

process_unix.go

fix: Windows build support with platform-specific process/signal handling

2026-01-13 20:59:15 -08:00

process_windows.go

fix: Windows build support with platform-specific process/signal handling

2026-01-13 20:59:15 -08:00

ready_test.go

fix(ready): filter formula scaffolds from gt ready output (gt-579)

2026-01-16 15:38:08 -08:00

ready.go

fix(ready): filter formula scaffolds from gt ready output (gt-579)

2026-01-16 15:38:08 -08:00

refinery_test.go

feat(refinery,boot): add --agent flag for model selection (#469)

2026-01-13 13:14:47 -08:00

refinery.go

docs: improve help text and add nudge documentation

2026-01-17 02:55:39 -08:00

release.go

…

resume.go

fix(resume): capture error in handoff message fallback (#583)

2026-01-16 15:27:38 -08:00

rig_config.go

…

rig_detect.go

feat: Set and Forget - Seamless Gas Town Integration (#255)

2026-01-08 20:25:01 -08:00

rig_dock.go

…

rig_helpers.go

…

rig_integration_test.go

test(rig): add tests for agent bead creation during rig add (#578)

2026-01-16 15:23:35 -08:00

rig_park.go

feat(rig): support parking multiple rigs in single call

2026-01-12 17:44:37 -08:00

rig_quick_add.go

feat: Set and Forget - Seamless Gas Town Integration (#255)

2026-01-08 20:25:01 -08:00

rig.go

fix(rig): respect parked/docked status in gt up and gt rig start

2026-01-17 00:50:46 -08:00

role_e2e_test.go

feat: add RoleEnvVars and improve gt role CLI

2026-01-09 21:52:09 -08:00

role.go

refactor(config): remove BEADS_DIR from agent environment and add doctor check (#455)

2026-01-13 22:13:57 -08:00

root.go

fix(lint): resolve errcheck and unparam violations

2026-01-11 18:06:09 -08:00

routes_jsonl_corruption_test.go

fix(beads): prevent routes.jsonl corruption and add doctor check for rig-level routes.jsonl (#377)

2026-01-12 01:45:26 -08:00

seance.go

…

session.go

…

shell.go

feat: Set and Forget - Seamless Gas Town Integration (#255)

2026-01-08 20:25:01 -08:00

show.go

feat(cli): add 'gt show' command for inspecting beads

2026-01-15 19:19:13 -08:00

sling_batch.go

fix(sling): auto-attach work molecule and handle dead polecats

2026-01-13 14:01:49 +01:00

sling_convoy.go

fix(namepool): persist custom names to settings/config.json

2026-01-17 00:37:38 -08:00

sling_dog.go

refactor(sling): split 1560-line file into 7 focused modules

2026-01-12 03:11:59 -08:00

sling_formula.go

fix(sling): set attached_molecule field when bonding formula to bead (#451)

2026-01-16 11:41:05 -08:00

sling_helpers.go

fix(sling): set attached_molecule field when bonding formula to bead (#451)

2026-01-16 11:41:05 -08:00

sling_target.go

refactor(sling): split 1560-line file into 7 focused modules

2026-01-12 03:11:59 -08:00

sling_test.go

fix(channel): enforce RetentionHours in channel message retention

2026-01-17 04:49:57 -08:00

sling.go

fix(sling): set attached_molecule field when bonding formula to bead (#451)

2026-01-16 11:41:05 -08:00

stale.go

feat(stale): add gt stale command for binary staleness check

2026-01-12 03:10:58 -08:00

start.go

fix(polecat): kill orphan sessions and clear stale hooks during allocation (#448)

2026-01-13 13:37:00 -08:00

status_test.go

…

status.go

Fix bd daemon command syntax and flags (#522)

2026-01-17 00:00:50 -08:00

statusline_test.go

…

statusline.go

chore: Bump version to 0.4.0

2026-01-17 12:46:49 -08:00

swarm.go

fix(polecat): kill orphan sessions and clear stale hooks during allocation (#448)

2026-01-13 13:37:00 -08:00

synthesis_test.go

…

synthesis.go

codex

2026-01-08 12:36:54 -05:00

thanks.go

feat(ui): import comprehensive UX system from beads

2026-01-09 22:46:06 -08:00

theme.go

…

town_cycle.go

…

trail.go

feat(identity): add gt commit wrapper and gt trail command

2026-01-13 19:34:29 -08:00

uninstall.go

feat: Set and Forget - Seamless Gas Town Integration (#255)

2026-01-08 20:25:01 -08:00

unsling.go

fix(sling): remove obsolete --naked flag

2026-01-11 22:23:21 -08:00

up_test.go

perf(up): parallelize all agent startup with concurrency limit (#476)

2026-01-13 13:46:50 -08:00

up.go

fix(rig): respect parked/docked status in gt up and gt rig start

2026-01-17 00:50:46 -08:00

version.go

chore: Bump version to 0.4.0

2026-01-17 12:46:49 -08:00

whoami.go

…

witness_test.go

feat: add witness start agent override

2026-01-09 21:56:53 -08:00

witness.go

docs: improve help text and add nudge documentation

2026-01-17 02:55:39 -08:00

worktree.go

…