nudge

Documentation

Overview

Package nudge delivers an operator-triggered "check your inbox" prompt into an agent's tmux pane via send-keys. This is the ONLY place muster types into a pane; automated bus activity uses internal/wake (notify) instead.

Index

• type TmuxNudger
  • func (n TmuxNudger) Nudge(socketPath, paneID, modelType string, submit bool) (bool, error)

Types

type TmuxNudger

type TmuxNudger struct {
	Run   func(args ...string) error
	Sleep func(d time.Duration)
}

TmuxNudger types a nudge into a pane and optionally submits it. Run is the command executor (nil → real tmux) and Sleep is the delay function (nil → time.Sleep); both are injectable for testing.

func (TmuxNudger) Nudge

func (n TmuxNudger) Nudge(socketPath, paneID, modelType string, submit bool) (bool, error)

Nudge types the check-inbox line into the pane. When submit is requested it presses Enter to submit the turn: claude accepts the Enter immediately, while codex needs a short delay after the text before a standalone Enter registers as a submit (see codexSubmitDelay). Unknown model types are typed-only (submitted=false) because their send-keys submit behavior is unverified, so the caller can tell the operator to press Enter.