feat(witness): add --env flag for environment variable overrides

Extends the --agent flag with a more general --env flag that allows
setting arbitrary environment variables when starting a witness.

Precedence (highest to lowest):
1. CLI --env overrides
2. Role bead env_vars
3. config.AgentEnv() defaults

Examples:
  gt witness start greenplace --env ANTHROPIC_MODEL=claude-3-haiku
  gt witness restart greenplace --env DEBUG=1 --env VERBOSE=true

Co-authored-by: joshuavial <git@codewithjv.com>
This commit is contained in:
gastown/crew/gus
2026-01-09 22:00:43 -08:00
committed by Steve Yegge
parent f9473c7b9e
commit 86751e1ea5
6 changed files with 36 additions and 24 deletions

View File

@@ -759,7 +759,7 @@ func runRigBoot(cmd *cobra.Command, args []string) error {
} else {
fmt.Printf(" Starting witness...\n")
witMgr := witness.NewManager(r)
if err := witMgr.Start(false, ""); err != nil {
if err := witMgr.Start(false, "", nil); err != nil {
if err == witness.ErrAlreadyRunning {
skipped = append(skipped, "witness (already running)")
} else {
@@ -839,7 +839,7 @@ func runRigStart(cmd *cobra.Command, args []string) error {
} else {
fmt.Printf(" Starting witness...\n")
witMgr := witness.NewManager(r)
if err := witMgr.Start(false, ""); err != nil {
if err := witMgr.Start(false, "", nil); err != nil {
if err == witness.ErrAlreadyRunning {
skipped = append(skipped, "witness")
} else {
@@ -1418,7 +1418,7 @@ func runRigRestart(cmd *cobra.Command, args []string) error {
skipped = append(skipped, "witness")
} else {
fmt.Printf(" Starting witness...\n")
if err := witMgr.Start(false, ""); err != nil {
if err := witMgr.Start(false, "", nil); err != nil {
if err == witness.ErrAlreadyRunning {
skipped = append(skipped, "witness")
} else {

View File

@@ -235,7 +235,7 @@ func startRigAgents(t *tmux.Tmux, townRoot string) {
fmt.Printf(" %s %s witness already running\n", style.Dim.Render("○"), r.Name)
} else {
witMgr := witness.NewManager(r)
if err := witMgr.Start(false, ""); err != nil {
if err := witMgr.Start(false, "", nil); err != nil {
if err == witness.ErrAlreadyRunning {
fmt.Printf(" %s %s witness already running\n", style.Dim.Render("○"), r.Name)
} else {

View File

@@ -118,7 +118,7 @@ func runUp(cmd *cobra.Command, args []string) error {
}
mgr := witness.NewManager(r)
if err := mgr.Start(false, ""); err != nil {
if err := mgr.Start(false, "", nil); err != nil {
if err == witness.ErrAlreadyRunning {
printStatus(fmt.Sprintf("Witness (%s)", rigName), true, mgr.SessionName())
} else {

View File

@@ -18,6 +18,7 @@ var (
witnessForeground bool
witnessStatusJSON bool
witnessAgentOverride string
witnessEnvOverrides []string
)
var witnessCmd = &cobra.Command{
@@ -43,6 +44,7 @@ states and takes action to keep work flowing.
Examples:
gt witness start greenplace
gt witness start greenplace --agent codex
gt witness start greenplace --env ANTHROPIC_MODEL=claude-3-haiku
gt witness start greenplace --foreground`,
Args: cobra.ExactArgs(1),
RunE: runWitnessStart,
@@ -96,7 +98,8 @@ Stops the current session (if running) and starts a fresh one.
Examples:
gt witness restart greenplace
gt witness restart greenplace --agent codex`,
gt witness restart greenplace --agent codex
gt witness restart greenplace --env ANTHROPIC_MODEL=claude-3-haiku`,
Args: cobra.ExactArgs(1),
RunE: runWitnessRestart,
}
@@ -105,12 +108,14 @@ func init() {
// Start flags
witnessStartCmd.Flags().BoolVar(&witnessForeground, "foreground", false, "Run in foreground (default: background)")
witnessStartCmd.Flags().StringVar(&witnessAgentOverride, "agent", "", "Agent alias to run the Witness with (overrides town default)")
witnessStartCmd.Flags().StringArrayVar(&witnessEnvOverrides, "env", nil, "Environment variable override (KEY=VALUE, can be repeated)")
// Status flags
witnessStatusCmd.Flags().BoolVar(&witnessStatusJSON, "json", false, "Output as JSON")
// Restart flags
witnessRestartCmd.Flags().StringVar(&witnessAgentOverride, "agent", "", "Agent alias to run the Witness with (overrides town default)")
witnessRestartCmd.Flags().StringArrayVar(&witnessEnvOverrides, "env", nil, "Environment variable override (KEY=VALUE, can be repeated)")
// Add subcommands
witnessCmd.AddCommand(witnessStartCmd)
@@ -143,7 +148,7 @@ func runWitnessStart(cmd *cobra.Command, args []string) error {
fmt.Printf("Starting witness for %s...\n", rigName)
if err := mgr.Start(witnessForeground, witnessAgentOverride); err != nil {
if err := mgr.Start(witnessForeground, witnessAgentOverride, witnessEnvOverrides); err != nil {
if err == witness.ErrAlreadyRunning {
fmt.Printf("%s Witness is already running\n", style.Dim.Render("⚠"))
fmt.Printf(" %s\n", style.Dim.Render("Use 'gt witness attach' to connect"))
@@ -296,7 +301,7 @@ func runWitnessAttach(cmd *cobra.Command, args []string) error {
sessionName := witnessSessionName(rigName)
// Ensure session exists (creates if needed)
if err := mgr.Start(false, ""); err != nil && err != witness.ErrAlreadyRunning {
if err := mgr.Start(false, "", nil); err != nil && err != witness.ErrAlreadyRunning {
return err
} else if err == nil {
fmt.Printf("Started witness session for %s\n", rigName)
@@ -329,7 +334,7 @@ func runWitnessRestart(cmd *cobra.Command, args []string) error {
_ = mgr.Stop()
// Start fresh
if err := mgr.Start(false, witnessAgentOverride); err != nil {
if err := mgr.Start(false, witnessAgentOverride, witnessEnvOverrides); err != nil {
return fmt.Errorf("starting witness: %w", err)
}