aperture-cli

module

v0.0.7 Latest Latest Go to latest Published: May 1, 2026 License: BSD-3-Clause

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/tailscale/aperture-cli

Links

Open Source Insights

README ¶

aperture-cli

[!WARNING] This repository is experimental. It is under active development, may change significantly without notice.

A CLI launcher for coding agents preconfigured to work with Aperture. It manages installation, configuration and environment variables that make using multiple providers and models very easy.

Supported agents

Installation

go install github.com/tailscale/aperture-cli/cmd/aperture@latest

Or build from source:

make build

Usage

aperture

On first run, aperture will attempt to connect to http://ai. If it cannot reach that host, it will prompt you to configure an Aperture endpoint.

Flags

Flag	Description
`-version`	Print build version and exit
`-debug`	Print environment variables set before launching the agent

Development

make build   # build ./aperture
make test    # run tests
make install # install to $GOPATH/bin
make clean   # remove built binary

Directories ¶

Path	Synopsis
cmd
aperture command
internal
clients Package clients holds the registry of AI coding agent clients (Claude Code, Codex, Gemini, OpenCode, ...).	Package clients holds the registry of AI coding agent clients (Claude Code, Codex, Gemini, OpenCode, ...).
clients/claudecode Package claudecode is the Claude Code CLI client.	Package claudecode is the Claude Code CLI client.
clients/codex Package codex is the OpenAI Codex client.	Package codex is the OpenAI Codex client.
clients/gemini Package gemini is the Google Gemini CLI client.	Package gemini is the Google Gemini CLI client.
clients/opencode Package opencode is the OpenCode client.	Package opencode is the OpenCode client.
config Package config holds the launcher's app-level persistent state: the list of Aperture endpoints the user has configured, the active endpoint, the YOLO-mode flag, and the record of the last-used client launch.	Package config holds the launcher's app-level persistent state: the list of Aperture endpoints the user has configured, the active endpoint, the YOLO-mode flag, and the record of the last-used client launch.
menu Package menu defines the descriptors the TUI uses to render a generic, navigable menu stack.	Package menu defines the descriptors the TUI uses to render a generic, navigable menu stack.
profiles Package profiles is the vestigial home of the Claude Desktop (Claude Cowork) support.	Package profiles is the vestigial home of the Claude Desktop (Claude Cowork) support.
tui Package tui is the bubbletea-driven interactive launcher.	Package tui is the bubbletea-driven interactive launcher.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL