launch

type Claude ¶

type Claude struct{}

Claude implements Runner for Claude Code integration.

func (c *Claude) Run(model string, 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, args []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 []string) error

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

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

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

func (c *Cline) String() string

type Codex ¶

type Codex struct{}

Codex implements Runner for Codex integration

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

func (c *Codex) String() string

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 ConfirmOptions ¶ added in v0.20.5

type ConfirmOptions struct {
	YesLabel string
	NoLabel  string
}

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, 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 []string) error

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

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

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

func (d *Droid) String() string

type Editor ¶

type Editor interface {
	Paths() []string
	Edit(models []string) 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, args []string) error

func (h *Hermes) 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
}

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, 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 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
}

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 []string) 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 = modelInfo

ModelInfo re-exports launcher model inventory details for callers.

type ModelItem ¶

type ModelItem struct {
	Name            string
	Description     string
	Recommended     bool
	VRAMBytes       int64
	ContextLength   int
	MaxOutputTokens int
}

ModelItem represents a model for selection UIs.

func IntegrationSelectionItems() ([]ModelItem, error)

type MultiSelector ¶

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

MultiSelector is a function type for multi item selection.

var DefaultMultiSelector MultiSelector

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(modelList []string) error

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

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

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

func (o *OpenCode) String() string

type Openclaw ¶

type Openclaw struct{}

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

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

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

func (c *Openclaw) Run(model string, 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 []string) error

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

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

func (p *Pi) Run(model string, 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, args []string) error

func (p *Poolside) 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 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
}

RunModelRequest controls how the root launcher resolves the chat model.

type Runner ¶

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

Runner executes a model with an integration.

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

type SingleSelector ¶

type SingleSelector func(title string, items []ModelItem, 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 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 []string) 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, args []string) error

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

func (v *VSCode) String() string