launch

type AccountState ¶ added in v0.23.2

type AccountState struct {
	Status accountStateStatus
	Plan   string
}

type AccountStatePrefetch ¶ added in v0.23.2

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

func StartAccountStatePrefetch(ctx context.Context) *AccountStatePrefetch

func (p *AccountStatePrefetch) StateIfReady() *AccountState

func (p *AccountStatePrefetch) StateUpdates(ctx context.Context) <-chan *AccountState

type Claude ¶

type Claude struct{}

Claude implements Runner for Claude Code integration.

func (c *Claude) Run(model string, _ []LaunchModel, args []string) error

func (c *Claude) String() string

type ClaudeDesktop ¶ added in v0.23.0

type ClaudeDesktop struct{}

ClaudeDesktop configures and launches Claude Desktop in third-party inference mode using Ollama Cloud as the gateway.

func (c *ClaudeDesktop) AutodiscoveredModel() string

func (c *ClaudeDesktop) AutodiscoveryConfigured() bool

func (c *ClaudeDesktop) ConfigurationSuccessMessage() string

func (c *ClaudeDesktop) ConfigureAutodiscovery() error

func (c *ClaudeDesktop) Onboard() error

func (c *ClaudeDesktop) Paths() []string

func (c *ClaudeDesktop) RequiresInteractiveOnboarding() bool

func (c *ClaudeDesktop) Restore() error

func (c *ClaudeDesktop) RestoreHint() string

func (c *ClaudeDesktop) RestoreSuccessMessage() string

func (c *ClaudeDesktop) Run(_ string, _ []LaunchModel, _ []string) error

func (c *ClaudeDesktop) SkipModelReadiness() bool

func (c *ClaudeDesktop) String() string

func (c *ClaudeDesktop) Supported() error

type Cline ¶

type Cline struct{}

Cline implements Runner and Editor for the Cline CLI integration

func (c *Cline) Edit(models []LaunchModel) error

func (c *Cline) Models() []string

func (c *Cline) Paths() []string

func (c *Cline) Run(model string, _ []LaunchModel, args []string) error

func (c *Cline) String() string

type Codex ¶

type Codex struct{}

Codex implements Runner for Codex integration

func (c *Codex) Restore() error

func (c *Codex) RestoreSuccessMessage() string

func (c *Codex) Run(model string, models []LaunchModel, args []string) error

func (c *Codex) SkipRestoreInstallCheck() bool

func (c *Codex) String() string

type CodexApp ¶ added in v0.24.0

type CodexApp struct{}

CodexApp configures the desktop Codex app with one launch-selected default model while leaving model discovery and switching to Codex's Ollama provider.

func (c *CodexApp) ConfigurationSuccessMessage() string

func (c *CodexApp) Configure(model string) error

func (c *CodexApp) ConfigureWithModels(primary string, models []LaunchModel) error

func (c *CodexApp) CurrentModel() string

func (c *CodexApp) Onboard() error

func (c *CodexApp) Paths() []string

func (c *CodexApp) RequiresInteractiveOnboarding() bool

func (c *CodexApp) Restore() error

func (c *CodexApp) RestoreHint() string

func (c *CodexApp) RestoreSuccessMessage() string

func (c *CodexApp) Run(_ string, _ []LaunchModel, args []string) error

func (c *CodexApp) String() string

func (c *CodexApp) Supported() error

type ConfigurationSuccessIntegration ¶ added in v0.23.0

type ConfigurationSuccessIntegration interface {
	ConfigurationSuccessMessage() string
}

ConfigurationSuccessIntegration can print a short message after launcher successfully switches an app into a launch-managed mode.

type ConfirmDefault ¶ added in v0.32.0

type ConfirmDefault int

const (
	ConfirmDefaultYes ConfirmDefault = iota
	ConfirmDefaultNo
)

type ConfirmOptions ¶ added in v0.20.5

type ConfirmOptions struct {
	YesLabel string
	NoLabel  string
	Default  ConfirmDefault
}

ConfirmOptions customizes labels for confirmation prompts.

type Copilot ¶ added in v0.21.0

type Copilot struct{}

Copilot implements Runner for GitHub Copilot CLI integration.

func (c *Copilot) Run(model string, _ []LaunchModel, args []string) error

func (c *Copilot) String() string

type Droid ¶

type Droid struct{}

Droid implements Runner and Editor for Droid integration

func (d *Droid) Edit(models []LaunchModel) error

func (d *Droid) Models() []string

func (d *Droid) Paths() []string

func (d *Droid) Run(model string, _ []LaunchModel, args []string) error

func (d *Droid) String() string

type Editor ¶

type Editor interface {
	Paths() []string
	Edit(models []LaunchModel) error
	Models() []string
}

Editor can edit config files for integrations that support model configuration.

type Hermes ¶ added in v0.21.0

type Hermes struct{}

Hermes is intentionally not an Editor integration: launch owns one primary model and the local Ollama endpoint, while Hermes keeps its own discovery and switching UX after startup.

func (h *Hermes) Configure(model string) error

func (h *Hermes) CurrentModel() string

func (h *Hermes) Onboard() error

func (h *Hermes) Paths() []string

func (h *Hermes) RefreshRuntimeAfterConfigure() error

func (h *Hermes) RequiresInteractiveOnboarding() bool

func (h *Hermes) Run(_ string, _ []LaunchModel, args []string) error

func (h *Hermes) String() string

type HermesDesktop ¶ added in v0.30.5

type HermesDesktop struct {
	Hermes
}

func (h *HermesDesktop) Onboard() error

func (h *HermesDesktop) Run(_ string, _ []LaunchModel, args []string) error

func (h *HermesDesktop) String() string

type IntegrationInfo ¶

type IntegrationInfo struct {
	Name        string
	DisplayName string
	Description string
}

IntegrationInfo contains display information about a registered integration.

func ListIntegrationInfos() []IntegrationInfo

type IntegrationInstallSpec ¶

type IntegrationInstallSpec struct {
	CheckInstalled  func() bool
	EnsureInstalled func() error
	URL             string
	Command         []string
}

IntegrationInstallSpec describes how launcher should detect and guide installation.

type IntegrationLaunchRequest ¶

type IntegrationLaunchRequest struct {
	Name                 string
	ModelOverride        string
	ForceConfigure       bool
	ConfigureOnly        bool
	Restore              bool
	ExtraArgs            []string
	Policy               *LaunchPolicy
	AccountState         *AccountState
	AccountStateProvider func() *AccountState
	AccountStateUpdates  func(context.Context) <-chan *AccountState
}

IntegrationLaunchRequest controls the canonical integration launcher flow.

type IntegrationSpec ¶

type IntegrationSpec struct {
	Name        string
	Runner      Runner
	Aliases     []string
	Hidden      bool
	Description string
	Install     IntegrationInstallSpec
}

IntegrationSpec is the canonical registry entry for one integration.

func ListVisibleIntegrationSpecs() []IntegrationSpec

func LookupIntegrationSpec(name string) (*IntegrationSpec, error)

type Kimi ¶ added in v0.21.1

type Kimi struct{}

Kimi implements Runner for Kimi Code CLI integration.

func (k *Kimi) Run(model string, _ []LaunchModel, args []string) error

func (k *Kimi) String() string

type LaunchConfirmMode ¶

type LaunchConfirmMode int

LaunchConfirmMode controls confirmation behavior across launch flows.

const (
	// LaunchConfirmPrompt prompts the user for confirmation.
	LaunchConfirmPrompt LaunchConfirmMode = iota
	// LaunchConfirmAutoApprove skips prompts and treats confirmation as accepted.
	LaunchConfirmAutoApprove
	// LaunchConfirmRequireYes rejects confirmation requests with a --yes hint.
	LaunchConfirmRequireYes
)

type LaunchMissingModelMode ¶

type LaunchMissingModelMode int

LaunchMissingModelMode controls local missing-model handling in launch flows.

const (
	// LaunchMissingModelPromptToPull prompts to pull a missing local model.
	LaunchMissingModelPromptToPull LaunchMissingModelMode = iota
	// LaunchMissingModelAutoPull pulls a missing local model without prompting.
	LaunchMissingModelAutoPull
	// LaunchMissingModelFail fails immediately when a local model is missing.
	LaunchMissingModelFail
)

type LaunchModel ¶ added in v0.30.0

type LaunchModel struct {
	Name            string
	Remote          bool
	ToolCapable     bool
	Capabilities    []modelpkg.Capability
	ContextLength   int
	MaxOutputTokens int
	EmbeddingLength int
	Size            int64
	Details         api.ModelDetails
}

LaunchModel is the model metadata Launch passes to integration config writers after resolving selected model names through the per-run inventory.

func (m LaunchModel) HasCapability(capability modelpkg.Capability) bool

func (m LaunchModel) WithCloudLimits() LaunchModel

type LaunchPolicy ¶

type LaunchPolicy struct {
	Confirm      LaunchConfirmMode
	MissingModel LaunchMissingModelMode
}

LaunchPolicy controls launch behavior that may vary by caller context.

type LauncherIntegrationState ¶

type LauncherIntegrationState struct {
	Name            string
	DisplayName     string
	Description     string
	Installed       bool
	AutoInstallable bool
	Selectable      bool
	Changeable      bool
	CurrentModel    string
	ModelUsable     bool
	InstallHint     string
	Editor          bool
}

LauncherIntegrationState is the launch-owned status for one launcher integration.

type LauncherState ¶

type LauncherState struct {
	LastSelection  string
	RunModel       string
	RunModelUsable bool
	Integrations   map[string]LauncherIntegrationState
	AccountState   *AccountState
}

LauncherState is the launch-owned snapshot used to render the root launcher menu.

func BuildLauncherState(ctx context.Context) (*LauncherState, error)

type ManagedAutodiscoveryCloudIntegration ¶ added in v0.23.0

type ManagedAutodiscoveryCloudIntegration interface {
	UsesOllamaCloud() bool
}

ManagedAutodiscoveryCloudIntegration marks an autodiscovery integration whose discovered model catalog depends on the user's local Ollama Cloud auth state.

type ManagedAutodiscoveryIntegration ¶ added in v0.23.0

type ManagedAutodiscoveryIntegration interface {
	Paths() []string
	AutodiscoveredModel() string
	AutodiscoveryConfigured() bool
	ConfigureAutodiscovery() error
	Onboard() error
}

ManagedAutodiscoveryIntegration is for managed integrations that do not need a launcher-selected model because the app discovers available models itself.

type ManagedInteractiveOnboarding ¶ added in v0.21.0

type ManagedInteractiveOnboarding interface {
	RequiresInteractiveOnboarding() bool
}

ManagedInteractiveOnboarding lets a managed integration declare whether its onboarding step really requires an interactive terminal. Hermes does not.

type ManagedModelListConfigurer ¶ added in v0.23.0

type ManagedModelListConfigurer interface {
	ConfigureWithModels(primary string, models []LaunchModel) error
}

ManagedModelListConfigurer lets managed single-model integrations receive the launcher's model list while still preserving one primary selected model.

type ManagedModelReadinessSkipper ¶ added in v0.23.0

type ManagedModelReadinessSkipper interface {
	SkipModelReadiness() bool
}

ManagedModelReadinessSkipper lets managed integrations opt out of local Ollama model readiness checks when the configured runtime is not the local daemon.

type ManagedOnboardingValidator ¶ added in v0.21.0

type ManagedOnboardingValidator interface {
	OnboardingComplete() bool
}

ManagedOnboardingValidator lets managed integrations re-check saved onboarding state when launcher needs a stronger live readiness signal.

type ManagedRuntimeRefresher ¶ added in v0.21.0

type ManagedRuntimeRefresher interface {
	RefreshRuntimeAfterConfigure() error
}

ManagedRuntimeRefresher lets managed integrations refresh any long-lived background runtime after launch rewrites their config.

type ManagedSingleModel ¶ added in v0.21.0

type ManagedSingleModel interface {
	Paths() []string
	Configure(model string) error
	CurrentModel() string
	Onboard() error
}

ManagedSingleModel is the narrow launch-owned config path for integrations like Hermes that have one primary model selected by launcher, need launcher to persist minimal config, and still keep their own model discovery and onboarding UX. This stays separate from Runner-only integrations and the multi-model Editor flow so Hermes-specific behavior stays scoped to one path.

type ModelInfo ¶

type ModelInfo = LaunchModel

ModelInfo re-exports launcher model inventory details for callers.

type ModelItem ¶

type ModelItem struct {
	Name            string
	Description     string
	Recommended     bool
	VRAMBytes       int64
	MaxOutputTokens int
	RequiredPlan    string
	ToolCapable     bool
	Capabilities    []modelpkg.Capability
	Size            int64
	Details         api.ModelDetails
}

ModelItem represents model metadata before selector-only UI state is derived.

func IntegrationSelectionItems() ([]ModelItem, error)

type MultiSelector ¶

type MultiSelector func(title string, items []SelectionItem, preChecked []string) ([]string, error)

MultiSelector is a function type for multi item selection.

var DefaultMultiSelector MultiSelector

type MultiSelectorWithUpdates ¶ added in v0.23.2

type MultiSelectorWithUpdates func(title string, items []SelectionItem, preChecked []string, updates <-chan []SelectionItem) ([]string, error)

MultiSelectorWithUpdates is a multi item selector that can receive refreshed item state while open.

var DefaultMultiSelectorWithUpdates MultiSelectorWithUpdates

type OMP ¶ added in v0.30.6

type OMP struct{}

OMP implements Runner for the OMP coding-agent integration.

func (o *OMP) Configure(model string) error

func (o *OMP) ConfigureWithModels(primary string, models []LaunchModel) error

func (o *OMP) CurrentModel() string

func (o *OMP) Onboard() error

func (o *OMP) Paths() []string

func (o *OMP) RequiresInteractiveOnboarding() bool

func (o *OMP) Run(model string, _ []LaunchModel, args []string) error

func (o *OMP) String() string

type OpenCode ¶

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

OpenCode implements Runner and Editor for OpenCode integration. Config is passed via OPENCODE_CONFIG_CONTENT env var at launch time instead of writing to opencode's config files.

func (o *OpenCode) Edit(models []LaunchModel) error

func (o *OpenCode) Models() []string

func (o *OpenCode) Paths() []string

func (o *OpenCode) Run(model string, models []LaunchModel, args []string) error

func (o *OpenCode) String() string

type Openclaw ¶

type Openclaw struct{}

func (c *Openclaw) Edit(models []LaunchModel) error

func (c *Openclaw) Models() []string

func (c *Openclaw) Paths() []string

func (c *Openclaw) Run(model string, _ []LaunchModel, args []string) error

func (c *Openclaw) String() string

type Pi ¶

type Pi struct{}

Pi implements Runner and Editor for Pi (Pi Coding Agent) integration

func (p *Pi) Edit(models []LaunchModel) error

func (p *Pi) Models() []string

func (p *Pi) Paths() []string

func (p *Pi) Run(_ string, _ []LaunchModel, args []string) error

func (p *Pi) String() string

type Poolside ¶ added in v0.22.0

type Poolside struct{}

Poolside implements Runner for Poolside's CLI.

func (p *Poolside) Run(model string, _ []LaunchModel, args []string) error

func (p *Poolside) String() string

type Qwen ¶ added in v0.30.1

type Qwen struct{}

func (q *Qwen) Configure(model string) error

func (q *Qwen) CurrentModel() string

func (q *Qwen) Onboard() error

func (q *Qwen) Paths() []string

func (q *Qwen) RequiresInteractiveOnboarding() bool

func (q *Qwen) Run(model string, _ []LaunchModel, args []string) error

func (q *Qwen) String() string

type RestorableIntegration ¶ added in v0.23.0

type RestorableIntegration interface {
	Restore() error
}

RestorableIntegration lets integrations switch back from a launch-managed mode to the application's normal/default mode.

type RestoreHintIntegration ¶ added in v0.23.0

type RestoreHintIntegration interface {
	RestoreHint() string
}

RestoreHintIntegration can provide a short restore command after launch switches an app into a launch-managed mode.

type RestoreInstallCheckSkipper ¶ added in v0.30.1

type RestoreInstallCheckSkipper interface {
	SkipRestoreInstallCheck() bool
}

RestoreInstallCheckSkipper lets cleanup-only restore flows run even when the external integration binary has already been removed.

type RestoreSuccessIntegration ¶ added in v0.23.0

type RestoreSuccessIntegration interface {
	RestoreSuccessMessage() string
}

RestoreSuccessIntegration can print a short message after launcher restores an app back to its default mode.

type RunModelRequest ¶

type RunModelRequest struct {
	ForcePicker          bool
	Policy               *LaunchPolicy
	AccountState         *AccountState
	AccountStateProvider func() *AccountState
	AccountStateUpdates  func(context.Context) <-chan *AccountState
}

RunModelRequest controls how the root launcher resolves the chat model.

type Runner ¶

type Runner interface {
	Run(model string, models []LaunchModel, args []string) error
	String() string
}

Runner executes an integration with the selected model and its resolved launch metadata. models is ordered with the primary model first.

func LookupIntegration(name string) (string, Runner, error)

type SelectionItem ¶ added in v0.23.2

type SelectionItem struct {
	Name              string
	Description       string
	Recommended       bool
	AvailabilityBadge string
}

SelectionItem represents a model row after launch has derived selector-only UI state.

func ApplyAccountStateToSelectionItems(items []ModelItem, state AccountState) []SelectionItem

func SelectionItemsWithAccountState(items []ModelItem, state *AccountState) []SelectionItem

type SingleSelector ¶

type SingleSelector func(title string, items []SelectionItem, current string) (string, error)

SingleSelector is a function type for single item selection. current is the name of the previously selected item to highlight; empty means no pre-selection.

var DefaultSingleSelector SingleSelector

type SingleSelectorWithUpdates ¶ added in v0.23.2

type SingleSelectorWithUpdates func(title string, items []SelectionItem, current string, updates <-chan []SelectionItem) (string, error)

SingleSelectorWithUpdates is a single item selector that can receive refreshed item state while open.

var DefaultSingleSelectorWithUpdates SingleSelectorWithUpdates

type Spinner ¶ added in v0.32.0

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

Spinner is a handle on a running animated spinner. Stop halts the spinner and clears its line (it blocks until the spinner has fully stopped and is safe to call multiple times). Cancelled returns a channel that is closed if the user interrupts the spinner (e.g. with Ctrl+C); wait loops can select on it to abort early. For the non-interactive ANSI fallback the channel is never closed because Ctrl+C raises SIGINT and terminates the process directly.

func NewSpinner(stop func(), cancelled chan struct{}) *Spinner

func StartSpinner(message string) *Spinner

func (s *Spinner) Cancelled() <-chan struct{}

func (s *Spinner) Stop()

type SupportedIntegration ¶ added in v0.23.0

type SupportedIntegration interface {
	Supported() error
}

SupportedIntegration lets an integration report platform support separately from whether the underlying app binary is installed.

type VSCode ¶ added in v0.18.3

type VSCode struct{}

VSCode implements Runner and Editor for Visual Studio Code integration.

func (v *VSCode) Edit(models []LaunchModel) error

func (v *VSCode) FocusVSCode()

func (v *VSCode) IsRunning() bool

func (v *VSCode) Models() []string

func (v *VSCode) Paths() []string

func (v *VSCode) Quit()

func (v *VSCode) Run(model string, _ []LaunchModel, args []string) error

func (v *VSCode) ShowInModelPicker(models []string) error

func (v *VSCode) String() string