How tailscale/aperture-cli works
Aperture CLI is an interactive launcher that configures coding-agent clients to use Aperture providers and models. The principal flow is startup into the TUI, connection selection and endpoint verification (directly or through an embedded Tailscale bridge), then client-specific provider/backend/model selection and agent launch. Settings preserve endpoints, bridges, provider data, and launch preferences. The README documents the supported clients and bridge behavior; some client implementations and bridge wiring were not sampled, so those relationships are shown only where documented or supported by the index.
Main entry points: tui.go Interactive launcher · registry.go Client registry · global.go Global settings · attempt.go Connection attempt
Components 24
Launcher and UI
- CLI entrypoint
cmd/aperture/main.go - Interactive launcher
internal/tui/tui.go - Connection menus
internal/tui/menus.go - Removal flows
internal/tui/removal.go
Connections and bridges
- Connection attempt
internal/bridges/attempt.go - Bridge machine
internal/bridges/machine.go - Embedded node
internal/bridges/node.go - Bridge manager
internal/bridges/machines.go
Agent clients
- Client registry
internal/clients/registry.go - Claude Code
internal/clients/claudecode/claudecode.go - Codex
internal/clients/codex/codex.go - Codex model catalog
internal/clients/codex/catalog.go - Gemini CLI
internal/clients/gemini/gemini.go - Other agent clients
internal/clients - Pi-like harnesses
internal/clients/pilike/pilike.go - Provider extension
internal/clients/pilike/extension.go - Claude Cowork profile
internal/profiles/adapter.go
Configuration and profiles
- Global settings
internal/config/global.go - Endpoint settings
internal/config/endpoint.go - Provider settings
internal/config/providers.go - Desktop profiles
internal/profiles/profiles.go
Other components
- User
- Aperture endpoint
- Tailscale control plane
Connections 33
- User → CLI entrypoint: runs
README.md - CLI entrypoint → Interactive launcher: starts
cmd/aperture/main.go - CLI entrypoint → Desktop profiles: registers
cmd/aperture/main.go - Interactive launcher → Connection menus: renders
internal/tui/tui.go - Interactive launcher → Client registry: uses picker
internal/tui/tui.go - Interactive launcher → Connection attempt: starts connection
internal/tui/tui.go - Connection menus → Connection attempt: requests connection
internal/tui/menus.go - Connection menus → Removal flows: offers removal
internal/tui/menus.go - Removal flows → Bridge manager: destroys bridge
internal/tui/removal.go - Interactive launcher → Global settings: reads active settings
internal/tui/tui.go - Connection attempt → Global settings: updates endpoints
internal/bridges/attempt.go - Connection attempt → Bridge manager: runs bridge
- Bridge manager → Bridge machine: manages
- Bridge machine → Embedded node: brings up
internal/bridges/machine.go - Embedded node → Tailscale control plane: joins tailnet
README.md - Connection attempt → Aperture endpoint: verifies models
README.md - Interactive launcher → Aperture endpoint: checks endpoint
- Client registry → Claude Code: registers
internal/clients/claudecode/claudecode.go - Client registry → Codex: registers
- Client registry → Gemini CLI: registers
internal/clients/gemini/gemini.go - Client registry → Other agent clients: provides clients
- Client registry → Claude Cowork profile: adds platform client
internal/profiles/adapter.go - Claude Code → Provider settings: selects provider
internal/clients/claudecode/claudecode.go - Claude Code → Global settings: records launch
- Codex → Codex model catalog: updates catalog
- Codex → Provider settings: selects provider
internal/clients/codex/codex.go - Gemini CLI → Provider settings: selects provider
internal/clients/gemini/gemini.go - Other agent clients → Provider settings: configures routing
- Pi-like harnesses → Provider extension: writes extension
internal/clients/pilike/pilike.go - Claude Cowork profile → Global settings: records launch
internal/profiles/adapter.go - Claude Cowork profile → Aperture endpoint: routes requests
README.md - CLI entrypoint → Global settings: loads settings
- Endpoint settings → Global settings: persists endpoint data