Versions in this module Expand all Collapse all v0 v0.3.3 Aug 19, 2026 v0.3.2 Aug 19, 2026 v0.3.1 Aug 19, 2026 v0.3.0 Aug 17, 2026 v0.2.8 Aug 17, 2026 Changes in this version + var ErrGitHubUnknownFlow = errors.New("github: unknown flow id") + var ErrNotPreviewable = errors.New("preview: project is not previewable") + var ErrPreviewSetupRequired = errors.New("preview: launch setup is required") + func EnsureFreshActiveRemote(ctx context.Context) error + func IsRunning() (bool, int, error) + func PIDPath() (string, error) + func SocketPath() (string, error) + func WriteRemoteSession(name string, s *cloud.Session) error + type APIError struct + Code string + Message string + ProjectConfigPath string + SetupPrompt string + StatusCode int + func (e *APIError) Error() string + type BackendClient struct + func (b *BackendClient) Agents(ctx context.Context, hostname string, ref agent.GitRef) ([]agent.AgentInfo, error) + func (b *BackendClient) ConfigOptions(ctx context.Context, hostname string, ref agent.GitRef) ([]agent.ConfigOption, error) + func (b *BackendClient) Presets(ctx context.Context, hostname string) ([]presets.Preset, error) + type BridgeBind struct + Err string + IP string + Reason string + type BridgeClient struct + func (b *BridgeClient) PairComplete(ctx context.Context, code string) (string, error) + func (b *BridgeClient) PairPoll(ctx context.Context) ([]string, error) + func (b *BridgeClient) RevokeAllDevices(ctx context.Context) (*BridgeStatus, error) + func (b *BridgeClient) RevokeDevice(ctx context.Context, pubkey string) (*BridgeStatus, error) + func (b *BridgeClient) Status(ctx context.Context) (*BridgeStatus, error) + func (b *BridgeClient) TrustNetwork(ctx context.Context, fingerprint, label string) (*BridgeStatus, error) + type BridgeDevice struct + AddedAt time.Time + LastSeen *time.Time + Name string + PubKey string + type BridgeNetwork struct + Fingerprint string + Label string + type BridgeStatus struct + Binds []BridgeBind + Devices []BridgeDevice + HostKey string + LANIP string + LastConnectedAt *time.Time + LastDevice string + Network BridgeNetwork + NetworkTrusted bool + Port int + Tailnet *BridgeTailnet + URLs []string + type BridgeTailnet struct + DNSName string + IP string + type Client struct + func NewClient(sockPath string) *Client + func NewDefaultClient() (*Client, error) + func NewLocalClient() (*Client, error) + func NewRemoteClient() (*Client, error) + func NewTCPClient(baseURL, authToken string) *Client + func (c *Client) Backend(backend agent.BackendType) *BackendClient + func (c *Client) Bridge() *BridgeClient + func (c *Client) GitHubConnectCancel(ctx context.Context, flowID string) error + func (c *Client) GitHubConnectStart(ctx context.Context) (GitHubDeviceFlowStart, error) + func (c *Client) GitHubConnectStatus(ctx context.Context, flowID string) (GitHubDeviceFlowStatus, error) + func (c *Client) GitHubCreatePR(ctx context.Context, worktreeID string, req GitHubCreatePRRequest) (GitHubCreatePRResponse, error) + func (c *Client) GitHubDisconnect(ctx context.Context) error + func (c *Client) GitHubPullRequestInspect(ctx context.Context, locator GitHubPullRequestLocator) (GitHubPullRequestInspection, error) + func (c *Client) GitHubPullRequestLaunch(ctx context.Context, req GitHubPullRequestLaunchRequest) (host.CreateWorktreeResult, error) + func (c *Client) GitHubStatus(ctx context.Context) (GitHubStatus, error) + func (c *Client) Host(hostname string) *HostClient + func (c *Client) Ping(ctx context.Context) error + func (c *Client) PingInfo(ctx context.Context) (*PingResponse, error) + func (c *Client) Preview(worktreeID string) *PreviewClient + func (c *Client) Session(id string) *SessionClient + func (c *Client) Sessions() *SessionsClient + func (c *Client) SignPreviewToken(ctx context.Context, token string, ttl time.Duration) (PreviewSignedURL, error) + func (c *Client) SoftwareManifest(ctx context.Context) (agent.SoftwareManifest, error) + func (c *Client) Status(ctx context.Context) (*StatusResponse, error) + type GitHubCreatePRRequest struct + Base string + Body string + Draft bool + Title string + type GitHubCreatePRResponse struct + BaseBranch string + HeadBranch string + HeadSHA string + PRNumber int + PRURL string + type GitHubDeviceFlowStart struct + ExpiresAt time.Time + FlowID string + Interval int + UserCode string + VerificationURI string + VerificationURIComplete string + type GitHubDeviceFlowState string + const GitHubFlowCanceled + const GitHubFlowDenied + const GitHubFlowError + const GitHubFlowExpired + const GitHubFlowPending + const GitHubFlowSuccess + type GitHubDeviceFlowStatus struct + Error string + GitHubLogin string + State GitHubDeviceFlowState + type GitHubPRAlreadyExistsError struct + ExistingURL string + Message string + func (e *GitHubPRAlreadyExistsError) Error() string + type GitHubPullRequestInspection struct + Author string + BaseBranch string + HTMLURL string + HeadBranch string + HeadOwner string + HeadRepo string + HeadSHA string + IsPrivate bool + Title string + type GitHubPullRequestLaunchRequest struct + ExpectedHeadSHA string + type GitHubPullRequestLocator struct + Number int + Owner string + Repo string + type GitHubStatus struct + Available bool + Connected bool + GitHubLogin string + InstalledAt time.Time + Scopes []string + type HostClient struct + func (h *HostClient) AuthFlowStatus(ctx context.Context, providerID, flowID string) (agent.DeviceFlowStatus, error) + func (h *HostClient) CancelAuthFlow(ctx context.Context, providerID, flowID string) error + func (h *HostClient) DeleteAuthCredential(ctx context.Context, providerID string) error + func (h *HostClient) Hostname() string + func (h *HostClient) ListAuthProviders(ctx context.Context, backend agent.BackendType) ([]agent.ProviderAuthInfo, error) + func (h *HostClient) ListBranches(ctx context.Context, ref agent.GitRef) ([]host.BranchInfo, error) + func (h *HostClient) MergeBranch(ctx context.Context, ref agent.GitRef, branch, commitMessage string) (host.MergeResult, error) + func (h *HostClient) RemoveWorktree(ctx context.Context, ref agent.GitRef, branch string, force bool) error + func (h *HostClient) ResolveWorktree(ctx context.Context, ref agent.GitRef, branch string) (host.WorktreeInfo, error) + func (h *HostClient) StartAuthDeviceFlow(ctx context.Context, providerID string) (agent.DeviceFlowStart, error) + func (h *HostClient) StartAuthOAuthCodeFlow(ctx context.Context, providerID string) (agent.DeviceFlowStart, error) + func (h *HostClient) SubmitAuthAPIKey(ctx context.Context, providerID, key string, metadata map[string]string) (agent.DeviceFlowStart, error) + func (h *HostClient) SubmitAuthCode(ctx context.Context, providerID, flowID, code string) error + type PingResponse struct + PID int + Status string + Uptime string + Version string + type PreviewClient struct + func (p *PreviewClient) Logs(ctx context.Context) ([]byte, error) + func (p *PreviewClient) Named(name string) *PreviewClient + func (p *PreviewClient) Start(ctx context.Context) (*PreviewStatus, error) + func (p *PreviewClient) Status(ctx context.Context) (*PreviewStatus, error) + func (p *PreviewClient) Stop(ctx context.Context) error + type PreviewSetupRequiredError struct + Message string + ProjectConfigPath string + SetupPrompt string + func (e *PreviewSetupRequiredError) Error() string + func (e *PreviewSetupRequiredError) Unwrap() error + type PreviewSignedURL struct + ExpiresAt time.Time + SignedURL string + type PreviewStatus struct + Available bool + Kind string + LastError string + Port int + ProjectConfigPath string + ServiceName string + SetupPrompt string + SetupRequired bool + State string + Token string + URL string + type SessionClient struct + func (s *SessionClient) Abort(ctx context.Context) error + func (s *SessionClient) Delete(ctx context.Context) error + func (s *SessionClient) Fork(ctx context.Context, messageID string) (*agent.SessionInfo, error) + func (s *SessionClient) Get(ctx context.Context) (*agent.SessionInfo, error) + func (s *SessionClient) ID() string + func (s *SessionClient) MarkRead(ctx context.Context) error + func (s *SessionClient) Messages(ctx context.Context) ([]agent.MessageData, error) + func (s *SessionClient) PendingPermissions(ctx context.Context) ([]agent.PermissionData, error) + func (s *SessionClient) ReplyPermission(ctx context.Context, permissionID string, allow bool, denyMessage string) error + func (s *SessionClient) Send(ctx context.Context, opts agent.SendMessageOpts) error + func (s *SessionClient) SetDraft(ctx context.Context, draft string) error + func (s *SessionClient) SetVisibility(ctx context.Context, visibility agent.SessionVisibility) error + func (s *SessionClient) ToggleFollowUp(ctx context.Context) (bool, error) + type SessionsClient struct + func (s *SessionsClient) Create(ctx context.Context, req agent.StartRequest) (*agent.SessionInfo, error) + func (s *SessionsClient) Discover(ctx context.Context, backend agent.BackendType, seedDir string) error + func (s *SessionsClient) List(ctx context.Context) ([]agent.SessionInfo, error) + func (s *SessionsClient) Search(ctx context.Context, p agent.SearchParams) ([]agent.SessionInfo, error) + func (s *SessionsClient) Subscribe(ctx context.Context) (<-chan agent.Event, error) + type StatusResponse struct + PID int + Sessions []agent.SessionInfo + Uptime string v0.2.7 Aug 10, 2026 v0.2.6 Aug 10, 2026 v0.2.5 Aug 10, 2026 v0.2.4 Aug 10, 2026 v0.2.3 Aug 10, 2026 v0.2.2 Aug 6, 2026 v0.2.1 Aug 5, 2026 v0.2.0 Aug 3, 2026