app

package
v0.0.20 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 17, 2026 License: MIT Imports: 43 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	DialogAddProject      = "add_project"
	DialogCreateWorkspace = "create_workspace"
	DialogDeleteWorkspace = "delete_workspace"
	DialogRenameWorkspace = "rename_workspace"
	DialogCommitWorkspace = "commit_workspace"
	DialogTrustScripts    = "trust_scripts"
	DialogRemoveProject   = "remove_project"
	// DialogSelectAssistant is the legacy ID for the assistant-selection flow.
	// The dialog itself is built by common.NewAgentPicker and carries
	// common.AgentPickerDialogID at runtime; handleDialogResult still matches
	// DialogSelectAssistant alongside it so older callers keep routing.
	DialogSelectAssistant = "select_assistant"
	DialogQuit            = "quit"
	DialogCleanupTmux     = "cleanup_tmux"
)

DialogID constants

View Source 
const (
	HarnessCenter  = "center"
	HarnessSidebar = "sidebar"
	HarnessMonitor = "monitor"
)

HarnessMode values.

View Source 
const (
	HarnessOverlayNone     = ""
	HarnessOverlayDialog   = "dialog"
	HarnessOverlaySettings = "settings"
	HarnessOverlayPrefix   = "prefix"
	HarnessOverlayError    = "error"
	HarnessOverlayInput    = "input"
)

Overlay values accepted by HarnessOptions.Overlay. The empty value renders the base pane with no overlay (the historical harness behavior).

Variables

This section is empty.

Functions

This section is empty.

Types

type App 

type App struct {
	// contains filtered or unexported fields
}

App is the root Bubbletea model.

func New 

func New(version, commit, date string) (*App, error)

New creates a new App instance.

func (*App) CleanupTmuxOnExit added in v0.0.9 

func (a *App) CleanupTmuxOnExit()

CleanupTmuxOnExit is a no-op since sessions are always persisted across restarts.

func (*App) Init 

func (a *App) Init() tea.Cmd

Init initializes the application.

func (*App) IsTmuxAvailable added in v0.0.9 

func (a *App) IsTmuxAvailable() bool

IsTmuxAvailable returns whether tmux is installed and available.

func (*App) SetMsgSender added in v0.0.4 

func (a *App) SetMsgSender(send func(tea.Msg))

func (*App) Shutdown added in v0.0.5 

func (a *App) Shutdown()

Shutdown releases resources that may outlive the Bubble Tea program.

func (*App) Update 

func (a *App) Update(msg tea.Msg) (model tea.Model, cmd tea.Cmd)

Update handles all messages with panic recovery.

func (*App) View 

func (a *App) View() (view tea.View)

View renders the application using layer-based composition. This uses lipgloss Canvas to compose layers directly, enabling ultraviolet's cell-level differential rendering for optimal performance.

type GitOperations added in v0.0.14 

type GitOperations interface {
	CreateWorkspace(repoPath, workspacePath, branch, base string) error
	RemoveWorkspace(repoPath, workspacePath string) error
	DeleteBranch(repoPath, branch string) error
	DiscoverWorkspaces(project *data.Project) ([]data.Workspace, error)
}

GitOperations abstracts git workspace operations for testability.

type GitStatusService added in v0.0.12 

type GitStatusService interface {
	GetCached(root string) *git.StatusResult
	UpdateCache(root string, status *git.StatusResult)
	Invalidate(root string)
	Refresh(root string) (*git.StatusResult, error)
	RefreshFast(root string) (*git.StatusResult, error)
}

GitStatusService provides cached status reads and fresh refreshes.

type Harness 

type Harness struct {
	// contains filtered or unexported fields
}

Harness drives a headless render loop for profiling.

func NewHarness 

func NewHarness(opts HarnessOptions) (*Harness, error)

NewHarness builds a headless UI harness for the requested mode.

func (*Harness) Render 

func (h *Harness) Render() tea.View

Render returns the composed view for the harness mode.

func (*Harness) Step 

func (h *Harness) Step(frame int)

Step simulates output for the active tabs.

type HarnessOptions 

type HarnessOptions struct {
	Mode            string
	Tabs            int
	Width           int
	Height          int
	HotTabs         int
	PayloadBytes    int
	NewlineEvery    int
	ShowKeymapHints bool
	// Overlay, when non-empty, puts the App into the corresponding overlay
	// state (dialog/settings/prefix/...) after the base pane is built, so the
	// rendered frame exercises composeOverlays instead of only base-pane chrome.
	// See applyHarnessOverlay in harness_overlay.go for the accepted values.
	Overlay string
}

HarnessOptions configures the headless UI harness.

type KeyMap 

type KeyMap struct {
	// Prefix key (leader)
	Prefix key.Binding

	// Dashboard
	Enter        key.Binding
	Delete       key.Binding
	Rename       key.Binding
	ToggleFilter key.Binding
	Refresh      key.Binding

	// Agent/Chat
	Interrupt  key.Binding
	SendEscape key.Binding

	// Navigation
	Up    key.Binding
	Down  key.Binding
	Left  key.Binding
	Right key.Binding
}

KeyMap defines all keybindings for the application

func DefaultKeyMap 

func DefaultKeyMap() KeyMap

DefaultKeyMap returns the default keybindings

type ProjectRegistry added in v0.0.12 

type ProjectRegistry interface {
	Projects() ([]string, error)
	AddProject(path string) error
	RemoveProject(path string) error
}

ProjectRegistry is the minimal interface used by the app for project tracking.

type TmuxOps added in v0.0.12 

type TmuxOps interface {
	EnsureAvailable() error
	InstallHint() string
	ActiveAgentSessionsByActivity(window time.Duration, opts tmux.Options) ([]tmux.SessionActivity, error)
	SessionsWithTags(match map[string]string, keys []string, opts tmux.Options) ([]tmux.SessionTagValues, error)
	AllSessionStates(opts tmux.Options) (map[string]tmux.SessionState, error)
	SessionStateFor(sessionName string, opts tmux.Options) (tmux.SessionState, error)
	SessionHasClients(sessionName string, opts tmux.Options) (bool, error)
	SessionCreatedAt(sessionName string, opts tmux.Options) (int64, error)
	KillSession(sessionName string, opts tmux.Options) error
	KillSessionsMatchingTags(tags map[string]string, opts tmux.Options) (bool, error)
	KillSessionsWithPrefix(prefix string, opts tmux.Options) error
	KillSessionsWithPrefixMissingTag(prefix, tag string, opts tmux.Options) error
	KillWorkspaceSessions(wsID string, opts tmux.Options) error
	SetMonitorActivityOn(opts tmux.Options) error
	SetStatusOff(opts tmux.Options) error
	CapturePaneTail(sessionName string, lines int, opts tmux.Options) (string, bool)
	ContentHash(content string) [16]byte
}

TmuxOps defines tmux operations used by the app.

type UpdateService added in v0.0.12 

type UpdateService interface {
	Check() (*update.CheckResult, error)
	Upgrade(release *update.Release) error
	IsHomebrewBuild() bool
}

UpdateService wraps release checks and upgrades.

type WorkspaceStore added in v0.0.12 

type WorkspaceStore interface {
	ListByRepo(repo string) ([]*data.Workspace, error)
	ListByRepoIncludingArchived(repo string) ([]*data.Workspace, error)
	LoadMetadataFor(workspace *data.Workspace) (bool, error)
	UpsertFromDiscovery(workspace *data.Workspace) error
	Save(workspace *data.Workspace) error
	Delete(id data.WorkspaceID) error
	Rename(id data.WorkspaceID, newName string) error
	SetEnv(id data.WorkspaceID, env map[string]string) error
	ResolvedDefaultAssistant() string
}

WorkspaceStore is the minimal interface used by the app for workspace metadata.

Source Files

View all Source files

Directories

Path Synopsis
Package activity implements tmux session activity detection using screen-delta hysteresis and tag-based output timestamps.
 Package activity implements tmux session activity detection using screen-delta hysteresis and tag-based output timestamps.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.