profiles

Documentation

Overview

Package profiles is the vestigial home of the Claude Desktop (Claude Cowork) support. Every other agent has been ported to internal/clients; this package stays until Claude Desktop is ported too. It exposes a lightweight clients.Client adapter via Client() so the rest of the app sees one unified registry.

Index

• func GatewayURL(apertureHost string) string
• func RegisterIfSupported()
• type Backend
• type BackendType
• type ClaudeDesktopProfile
  • func (c *ClaudeDesktopProfile) BinaryName() string
  • func (c *ClaudeDesktopProfile) CommonPaths() []string
  • func (c *ClaudeDesktopProfile) Env(_ string, _ Backend) (map[string]string, error)
  • func (c *ClaudeDesktopProfile) InstallHint() string
  • func (c *ClaudeDesktopProfile) Launch(apertureHost string) error
  • func (c *ClaudeDesktopProfile) Name() string
  • func (c *ClaudeDesktopProfile) RequiredCompat(b Backend) []string
  • func (c *ClaudeDesktopProfile) RunInstall(apertureHost string) (*exec.Cmd, error)
  • func (c *ClaudeDesktopProfile) SupportedBackends() []Backend

Functions

func GatewayURL

func GatewayURL(apertureHost string) string

GatewayURL normalizes the aperture host for Claude Cowork's gateway config. Claude Cowork requires HTTPS and no trailing slash.

func RegisterIfSupported

func RegisterIfSupported()

RegisterIfSupported registers the Claude Desktop client on platforms that support it (darwin, windows). Call from the cmd entrypoint after importing the other client packages, to keep platform gating in one place.

Types

type Backend

type Backend struct {
	Type        BackendType
	DisplayName string
}

Backend is a selectable upstream destination. Kept for Claude Desktop's internal bookkeeping; not exposed outside this package.

type BackendType

type BackendType string

BackendType identifies the upstream Claude Desktop routes to.

const (
	// BackendAnthropic is the only backend Claude Desktop supports.
	BackendAnthropic BackendType = "anthropic"
)

type ClaudeDesktopProfile

type ClaudeDesktopProfile struct{}

ClaudeDesktopProfile implements Profile for the Claude Cowork application (Claude Code GUI). During install, it writes platform-specific gateway configuration (macOS plist / Windows registry) and downloads the installer. On launch, it re-checks the configuration and starts the desktop app.

func (*ClaudeDesktopProfile) BinaryName

func (c *ClaudeDesktopProfile) BinaryName() string

func (*ClaudeDesktopProfile) CommonPaths

func (c *ClaudeDesktopProfile) CommonPaths() []string

func (*ClaudeDesktopProfile) Env

func (c *ClaudeDesktopProfile) Env(_ string, _ Backend) (map[string]string, error)

Env is not used for desktop app profiles but satisfies the Profile interface.

func (*ClaudeDesktopProfile) InstallHint

func (c *ClaudeDesktopProfile) InstallHint() string

func (*ClaudeDesktopProfile) Launch

func (c *ClaudeDesktopProfile) Launch(apertureHost string) error

Launch checks whether the gateway configuration matches the current aperture host, updates it if needed, and starts the desktop app.

func (*ClaudeDesktopProfile) Name

func (c *ClaudeDesktopProfile) Name() string

func (*ClaudeDesktopProfile) RequiredCompat

func (c *ClaudeDesktopProfile) RequiredCompat(b Backend) []string

func (*ClaudeDesktopProfile) RunInstall

func (c *ClaudeDesktopProfile) RunInstall(apertureHost string) (*exec.Cmd, error)

RunInstall writes the gateway configuration and returns a command that downloads and runs the installer. The TUI executes this with terminal takeover so the user sees download progress.

func (*ClaudeDesktopProfile) SupportedBackends

func (c *ClaudeDesktopProfile) SupportedBackends() []Backend