config

Sep 9, 2026

Changes in this version

+ const NativeMergeFeatureFlag

+ const NativeWorktreeFeatureFlag

+ func EffectiveNativeMergeEnabled(cfg *Config) bool

+ func EffectiveNativeWorktreeEnabled(cfg *Config) bool

type Config

+ NativeMergeWorktreeOverrides map[string]bool

+ NativeWorktreeSessionOverrides map[string]bool

+ func (c *Config) GetNativeMergeGlobalOverride() (value bool, ok bool)

+ func (c *Config) GetNativeMergeWorktreeOverride(worktreePath string) (forceNative bool, ok bool)

+ func (c *Config) GetNativeWorktreeGlobalOverride() (value bool, ok bool)

+ func (c *Config) GetNativeWorktreeSessionOverride(sessionName string) (forceNative bool, ok bool)

+ func (c *Config) SetNativeMergeGlobalOverride(forceNative *bool) error

+ func (c *Config) SetNativeMergeWorktreeOverride(worktreePath string, forceNative *bool) error

+ func (c *Config) SetNativeWorktreeGlobalOverride(forceNative *bool) error

+ func (c *Config) SetNativeWorktreeSessionOverride(sessionName string, forceNative *bool) error

Sep 7, 2026

Changes in this version

+ const FeaturePiSupport

+ const StreamHubFeatureFlag

+ const TymuxFeatureFlag

+ func EffectiveStreamHubEnabled(cfg *Config) bool

+ func EffectiveTymuxEnabled(cfg *Config) bool

+ func TmuxLifecycleV2Enabled() bool

type Config

+ Jules JulesConfig

+ func (c *Config) DeleteFeatureFlag(name string) error

+ func (c *Config) GetFeatureFlagOverride(name string) (value bool, ok bool)

+ func (c *Config) GetStreamHubGlobalOverride() (value bool, ok bool)

+ func (c *Config) GetTymuxGlobalOverride() (value bool, ok bool)

+ func (c *Config) MaxConcurrentJulesSessionsOrDefault() int

+ func (c *Config) MaxJulesSessionsPerDayOrDefault() int

+ func (c *Config) SetTymuxGlobalOverride(forceTymux *bool) error

+ type JulesConfig struct

+ EgressAcknowledgedRepos []string

+ Enabled bool

+ MaxConcurrentJulesSessions int

+ MaxJulesSessionsPerDay int

Sep 3, 2026

Changes in this version

type Config

+ CreationStale CreationStaleConfig

+ type CreationStaleConfig struct

+ ThresholdMinutes int

+ func (c CreationStaleConfig) ThresholdMinutesOrDefault() int

Aug 30, 2026

Changes in this version

type Config

+ RetryPolicy RetryPolicyConfig

+ type RetryPolicyConfig struct

+ Backoff string

+ Enabled *bool

+ InitialDelaySeconds int

+ MaxAttempts int

+ MaxDelaySeconds int

+ RetryOn []string

+ StaleTriggersRetry *bool

+ func (c RetryPolicyConfig) BackoffOrWarn() string

+ func (c RetryPolicyConfig) EnabledOrDefault() bool

+ func (c RetryPolicyConfig) FilteredRetryOn() []string

+ func (c RetryPolicyConfig) MaxAttemptsOrDefault() int

+ func (c RetryPolicyConfig) MaxDelaySecondsOrDefault() int

+ func (c RetryPolicyConfig) RetryOnOrDefault() []string

Aug 29, 2026

Changes in this version

+ var ErrTymuxRollbackRehearsalNotCompleted = errors.New(...)

+ func ResolveGlobalTymuxDefault(cfg *Config, requested bool) (bool, error)

type Config

+ HandoffSummary HandoffSummaryConfig

+ StreamHubGlobalOverride *bool

+ TymuxRollbackRehearsalCompletedAt *time.Time

+ TymuxSessionOverrides map[string]bool

+ func (c *Config) GetFeatureFlagWithDefault(name string, defaultValue bool) bool

+ func (c *Config) GetTymuxSessionOverride(sessionName string) (forceTymux bool, ok bool)

+ func (c *Config) RecordTymuxRollbackRehearsalCompleted() error

+ func (c *Config) SetStreamHubGlobalOverride(forceHub *bool) error

+ func (c *Config) SetTymuxSessionOverride(sessionName string, forceTymux *bool) error

+ type HandoffSummaryConfig struct

+ Enabled *bool

+ MaxMiddleExcerptTokens int

+ func (c HandoffSummaryConfig) EnabledOrDefault() bool

+ func (c HandoffSummaryConfig) HandoffSummaryConfigOrDefault() HandoffSummaryConfig

Aug 22, 2026

Changes in this version

+ var ErrRollbackRehearsalNotCompleted = errors.New(...)

+ func ResolveClaudeHistoryDir(homeDir string, isIsolated bool) (string, error)

+ func ResolveGlobalStreamHubDefault(cfg *Config, requested bool) (bool, error)

type Config

+ Remotes []RemoteConfig

+ RollbackRehearsalCompletedAt *time.Time

+ StreamHubSessionOverrides map[string]bool

+ func (c *Config) GetStreamHubSessionOverride(sessionName string) (forceHub bool, ok bool)

+ func (c *Config) RecordRollbackRehearsalCompleted() error

+ func (c *Config) RemoteByName(name string) (*RemoteConfig, bool)

+ func (c *Config) SetStreamHubSessionOverride(sessionName string, forceHub *bool) error

+ type RemoteConfig struct

+ BasePath string

+ Host string

+ IdentityRef string

+ Name string

+ User string

type TmuxExecGateConfig

+ InputFastLaneSlots int

+ func (c TmuxExecGateConfig) InputFastLaneSlotsOrDefault() int

Aug 16, 2026

Changes in this version

type Config

+ Slack SlackConfig

+ StaleSession StaleSessionConfig

+ func (c *Config) PromptCacheDirOrDefault() (string, error)

+ func (c *Config) SlackSigningSecretOverride() string

+ func (c *Config) SlackWebhookURLOverride() string

+ type SlackConfig struct

+ ApprovalEnabled bool

+ DashboardBaseURL string

+ NotifyOnQueueItem bool

+ QueueDepthThreshold int

+ SigningSecretEncrypted string

+ WebhookURLEncrypted string

+ type StaleSessionConfig struct

+ NotifyEnabled *bool

+ ThresholdMinutes int

+ func (c StaleSessionConfig) NotifyEnabledOrDefault() bool

+ func (c StaleSessionConfig) ThresholdMinutesOrDefault() int

type TmuxExecGateConfig

+ ResyncFastLaneSlots int

+ func (c TmuxExecGateConfig) ResyncFastLaneSlotsOrDefault() int

Aug 14, 2026

Changes in this version

+ type CallbackConfig struct

+ OnQueueItemCreatedURL string

+ OnSessionCompleteURL string

+ OnSessionStaleURL string

type Config

+ Callbacks CallbackConfig

+ ClaimantHostID string

+ func (c *Config) GetOrCreateClaimantHostID() (string, error)

Aug 13, 2026

Changes in this version

+ const DefaultInstanceLockTimeout

+ const InstanceLockFileName

+ func AcquireInstanceLock(configDir string, timeout time.Duration) (*flock.Flock, error)

+ func DefaultLauncherPresetsPath() (string, error)

+ func ImportSessionEnabled() bool

type Config

+ Quota QuotaConfig

+ func (c *Config) HeadlessFailureCaptureDirOrDefault() (string, error)

+ type LauncherPreset struct

+ Argv []string

+ DefaultPath string

+ ID string

+ Label string

+ Program string

+ type LauncherPresetsFile struct

+ Presets []LauncherPreset

+ Version int

+ func LoadLauncherPresets(path string) (*LauncherPresetsFile, error)

+ type QuotaConfig struct

+ AssumedWindowTokenBudget int64

+ ConsecutiveTicksToPause int

+ ConsecutiveTicksToResume int

+ Enabled bool

+ ForegroundThrottleDelaySeconds int

+ ManualOverrideGraceMinutes int

+ PauseBelowHeadroomPct float64

+ RateLimitWindowMinutes int

+ ResumeMarginPct float64

+ func (c QuotaConfig) QuotaConfigOrDefault() QuotaConfig

Aug 10, 2026

Changes in this version

type Config

+ AutoSpawnReadyItems *bool

+ GitHubEnterpriseHosts []GitHubEnterpriseHost

+ MaxConcurrentBacklogWorkItems int

+ SessionRetention SessionRetentionConfig

+ func (c *Config) AutoSpawnReadyItemsOrDefault() bool

+ func (c *Config) GetGitHubEnterpriseHosts() []GitHubEnterpriseHost

+ func (c *Config) MaxConcurrentBacklogWorkItemsOrDefault() int

+ type GitHubEnterpriseHost struct

+ ClientID string

+ Host string

+ type SessionRetentionConfig struct

+ Enabled *bool

+ RetentionDays int

+ func (c SessionRetentionConfig) EnabledOrDefault() bool

+ func (c SessionRetentionConfig) RetentionDaysOrDefault() int

Jul 21, 2026

Changes in this version

+ func IsIsolatedInstance() bool

+ func IsNamedInstance() bool

type Config

+ MaxAutoReworkIterations int

+ func (c *Config) BacklogAttachmentDirOrDefault() (string, error)

+ func (c *Config) MaxAutoReworkIterationsOrDefault() int

Jul 14, 2026

Changes in this version

type Config

+ TmuxExecGate TmuxExecGateConfig

+ func (c *Config) TriageArtifactDirOrDefault() (string, error)

+ type TmuxExecGateConfig struct

+ Slots int

+ func (c TmuxExecGateConfig) SlotsOrDefault() int

Jul 6, 2026

Changes in this version

+ var ErrAliasNotFound = errors.New("alias not found")

+ func ExpandEnvVars(m map[string]string) map[string]string

+ func GetAliasesByGroup(cfg *Config) map[string][]AliasConfig

+ func GetConfigDirForDir(dir string) (string, error)

+ func IsTestMode() bool

+ type AliasConfig struct

+ AutoYes bool

+ CLIFlags string

+ Description string

+ EnvVars map[string]string

+ Group string

+ Name string

+ NamePrefix string

+ Path string

+ Profile string

+ Program string

+ SessionType SessionType

+ Tags []string

+ func FindAlias(cfg *Config, name string) *AliasConfig

+ type BrowserPassthroughCDPConfig struct

+ ScreencastMaxFPS int

+ ScreencastMaxHeight int

+ ScreencastMaxWidth int

+ ScreencastQuality int

+ func (c *BrowserPassthroughCDPConfig) CDPConfigOrDefault() BrowserPassthroughCDPConfig

+ type BrowserPassthroughConfig struct

+ CDP BrowserPassthroughCDPConfig

+ DisplayBase int

+ DisplayRangeMax int

+ Enabled *bool

+ Resolution string

+ func (c *BrowserPassthroughConfig) IsEnabled() bool

+ type CapacityConfig struct

+ ContextWindowAutoPct float64

+ ContextWindowWarnPct float64

+ CostBudgetUSD float64

+ PollIntervalSeconds int

+ ProviderPriority []ProviderPriority

+ RateLimitWarnRemaining int

+ TransitionMode TransitionMode

+ func (c CapacityConfig) CapacityConfigOrDefault() CapacityConfig

type Config

+ AnalyticsMaxAgeDays int

+ AnalyticsMaxRows int

+ AnthropicAPIKey string

+ BrowserPassthrough BrowserPassthroughConfig

+ Capacity CapacityConfig

+ EscapeAnalyticsCaptureLevel string

+ EscapeAnalyticsDisableOSCRedaction bool

+ EscapeAnalyticsMaxRowsPerSession int

+ EscapeAnalyticsRetentionDays int

+ EscapeAnalyticsSamplingRate *float64

+ FeatureFlags map[string]bool

+ Hibernation HibernationConfig

+ MachineEncryptionKey string

+ NewProjectBaseDir string

+ ProcessManagerBackend string

+ PyroscopeServerAddress string

+ func NewConfig() *Config

+ func NewConfigWithExecutor(exec CommandExecutor) *Config

+ func (c *Config) AnalyticsMaxAgeDaysOrDefault() int

+ func (c *Config) AnalyticsMaxRowsOrDefault() int

+ func (c *Config) GetAvailablePrograms() []string

+ func (c *Config) GetClaudeCommand() (string, error)

+ func (c *Config) GetFeatureFlag(name string) bool

+ func (c *Config) GetOrCreateEncryptionKey() ([]byte, error)

+ func (c *Config) HibernationCheckpointDirOrDefault() (string, error)

+ func (c *Config) NewProjectBaseDirOrDefault() (string, error)

+ func (c *Config) OSCPayloadsAreRedacted() bool

+ func (c *Config) SetFeatureFlag(name string, value bool) error

+ type HibernationConfig struct

+ CheckpointDir string

+ Enabled bool

+ IdleTimeoutMinutes int

+ ResourcePressureThreshold int

+ RetentionDays int

+ type ProviderPriority struct

+ CLI string

+ Model string

type ResolvedDefaults

+ Branch string

+ Path string

+ SessionLabel string

+ func ResolveAlias(cfg *Config, aliasName, branch, label, extraFlags string) (ResolvedDefaults, error)

type SessionDefaults

+ Aliases []AliasConfig

+ type SessionType string

+ const SessionTypeDefault

+ const SessionTypeDirectory

+ const SessionTypeExistingWorktree

+ const SessionTypeNewProject

+ const SessionTypeNewWorktree

+ const SessionTypeOneOff

+ func (st SessionType) IsValid() bool

+ type TransitionMode string

+ const TransitionModeAuto

+ const TransitionModeManual

+ const TransitionModeNotify

Apr 26, 2026

Changes in this version

type Config

+ OneOffBaseDir string

+ func (c *Config) OneOffBaseDirOrDefault() (string, error)

Apr 21, 2026

Changes in this version

type Config

+ Notifications NotificationPrefs

+ func LoadConfigFromPath(path string) (*Config, error)

+ type NotificationPrefs struct

+ PushEnabled bool

Apr 14, 2026

Changes in this version

type Config

+ ConfigVersion int

+ SessionDefaults SessionDefaults

+ type DirectoryRule struct

+ Overrides ProfileDefaults

+ Path string

+ Profile string

+ type ProfileDefaults struct

+ AutoYes bool

+ CLIFlags string

+ CreatedAt time.Time

+ Description string

+ EnvVars map[string]string

+ Name string

+ Program string

+ Tags []string

+ UpdatedAt time.Time

+ type ResolvedDefaults struct

+ AutoYes bool

+ CLIFlags string

+ EnvVars map[string]string

+ MatchedDirectory string

+ Program string

+ Tags []string

+ UsedDirectory bool

+ UsedGlobal bool

+ UsedProfile bool

+ func ResolveDefaults(cfg *Config, workingDir, profileName string) ResolvedDefaults

+ type SessionDefaults struct

+ AutoYes bool

+ CLIFlags string

+ DirectoryRules []DirectoryRule

+ EnvVars map[string]string

+ Profiles map[string]ProfileDefaults

+ Program string

+ Tags []string

Apr 7, 2026

Changes in this version

+ const ConfigFileName

+ const DefaultLockTimeout

+ const DiscoveryConfigFileName

+ const InstancesFileName

+ const LockFileName

+ const StateFileName

+ var ErrConfigNotFound = fmt.Errorf("config file not found")

+ var ErrInvalidConfig = fmt.Errorf("invalid config file")

+ var ErrInvalidJSON = fmt.Errorf("invalid JSON")

+ func EnsureWorkspaceMeta()

+ func GetAvailablePrograms() []string

+ func GetClaudeCommand() (string, error)

+ func GetClaudeDir() (string, error)

+ func GetConfigDir() (string, error)

+ func GetPreferredWorkspaceFile(baseDir string) string

+ func ResetCommandExecutor()

+ func SaveConfig(config *Config) error

+ func SaveDiscoveryConfig(config *DiscoveryConfig) error

+ func SaveState(state *State) error

+ func SetCommandExecutor(executor CommandExecutor)

+ func SetPreferredWorkspace(baseDir, configDir string) error

+ type AppState interface

+ GetHelpScreensSeen func() uint32

+ SetHelpScreensSeen func(seen uint32) error

+ type ClaudeConfigManager struct

+ func NewClaudeConfigManager() (*ClaudeConfigManager, error)

+ func (m *ClaudeConfigManager) GetConfig(filename string) (*ConfigFile, error)

+ func (m *ClaudeConfigManager) ListConfigs() ([]ConfigFile, error)

+ func (m *ClaudeConfigManager) UpdateConfig(filename string, content string) error

+ func (m *ClaudeConfigManager) UpdateConfigWithValidation(filename string, content string) error

+ func (m *ClaudeConfigManager) ValidateJSON(filename string, content string) error

+ type CommandExecutor interface

+ Command func(name string, args ...string) *exec.Cmd

+ LookPath func(file string) (string, error)

+ Output func(cmd *exec.Cmd) ([]byte, error)

+ type Config struct

+ AutoYes bool

+ AvailablePrograms []string

+ BranchPrefix string

+ DaemonPollInterval int

+ DefaultProgram string

+ DetectNewSessions bool

+ KeyCategories map[string]string

+ ListenAddress string

+ LogCompress bool

+ LogMaxAge int

+ LogMaxFiles int

+ LogMaxSize int

+ LogsDir string

+ LogsEnabled bool

+ PasskeyEnabled bool

+ PasskeyRPID string

+ PerformBackgroundHealthChecks bool

+ SessionDetectionInterval int

+ StateRefreshInterval int

+ TerminalStreamingMode string

+ TmuxSessionPrefix string

+ UseSessionLogs bool

+ VCSPreference string

+ func DefaultConfig() *Config

+ func LoadConfig() *Config

+ func (c *Config) GetKeyCategoryForKey(key string) string

+ func (c *Config) RemoveKeyCategory(key string)

+ func (c *Config) SetKeyCategory(key, category string)

+ type ConfigFile struct

+ Content string

+ ModTime time.Time

+ Name string

+ Path string

+ type DiscoveryConfig struct

+ AllowExternalAttach bool

+ AutoRefreshExternal bool

+ ConfirmExternalOperations bool

+ DiscoverInterval int

+ ExcludedSocketPaths []string

+ Mode DiscoveryMode

+ SocketPaths []string

+ func DefaultDiscoveryConfig() *DiscoveryConfig

+ func LoadDiscoveryConfig() *DiscoveryConfig

+ func (c *DiscoveryConfig) CanAttachToExternal() bool

+ func (c *DiscoveryConfig) IsExternalDiscoveryEnabled() bool

+ func (c *DiscoveryConfig) IsManagedDiscoveryEnabled() bool

+ func (c *DiscoveryConfig) ShouldConfirmOperation(isExternal bool) bool

+ func (c *DiscoveryConfig) ShouldShowExternalInstances() bool

+ type DiscoveryMode string

+ const DiscoveryAll

+ const DiscoveryExternalOnly

+ const DiscoveryManagedOnly

+ type State struct

+ HelpScreensSeen uint32

+ UI UIState

+ func DefaultState() *State

+ func LoadState() *State

+ func NewTestState(testDir string) *State

+ func (s *State) Close() error

+ func (s *State) GetCategoryExpanded(category string) bool

+ func (s *State) GetHelpScreensSeen() uint32

+ func (s *State) GetSearchState() (bool, string)

+ func (s *State) GetSelectedIndex() int

+ func (s *State) GetUIState() UIState

+ func (s *State) RefreshState() error

+ func (s *State) SetCategoryExpanded(category string, expanded bool) error

+ func (s *State) SetHelpScreensSeen(seen uint32) error

+ func (s *State) SetHidePaused(hidePaused bool) error

+ func (s *State) SetSearchMode(searchMode bool, query string) error

+ func (s *State) SetSelectedIndex(index int) error

+ type StateManager interface

+ Close func() error

+ RefreshState func() error

+ type UIState struct

+ CategoryExpanded map[string]bool

+ HidePaused bool

+ SearchMode bool

+ SearchQuery string

+ SelectedIdx int

+ type UIStateAccess interface

+ GetCategoryExpanded func(category string) bool

+ GetSearchState func() (bool, string)

+ GetSelectedIndex func() int

+ GetUIState func() UIState

+ SetCategoryExpanded func(category string, expanded bool) error

+ SetHidePaused func(hidePaused bool) error

+ SetSearchMode func(searchMode bool, query string) error

+ SetSelectedIndex func(index int) error

+ type WorkspaceMeta struct

+ CWD string

+ ConfigDir string

+ LastUsed time.Time

+ Name string

+ Type string

+ WorkspaceID string

+ func ListAvailableWorkspaces(baseDir string) ([]WorkspaceMeta, error)

+ func ReadWorkspaceMeta(configDir string) (WorkspaceMeta, error)