Aperture CLI
Лаунчер запускает Claude Code, Codex, Gemini CLI и другие агенты с настройками Aperture от Tailscale, есть режим моста
- 89 ★ репозитория
- Последний коммит
- BSD-3-Clause
Расширенный доступ
Почему такой уровень
- Лаунчер задает окружение агентов и направляет их запросы к моделям через выбранный адрес Aperture, а мост регистрирует устройство в вашем `tailnet`.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/tailscale/aperture-cli/main/install.sh | shПервая команда из README: ставит `aperture` в `/usr/local/bin`; прочитайте скрипт до запуска. `APERTURE_INSTALL_DIR=$HOME/.local/bin` убирает sudo.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Лаунчер задает окружение агентов и направляет их запросы к моделям через выбранный адрес Aperture, а мост регистрирует устройство в вашем `tailnet`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
aperture ставит и настраивает кодинг-агентов так, чтобы они работали через Aperture, сервис Tailscale. Лаунчер сам задает переменные окружения и конфигурацию, поэтому одна команда `aperture` открывает меню агентов, а `aperture codex --model openai/gpt-5-mini` сразу запускает выбранный агент с нужной моделью. Поддерживаются Claude Code, Gemini CLI, OpenCode, Codex, GitHub Copilot CLI, Hermes Agent, Oh My Pi, Pi и Claude Cowork. При первом запуске лаунчер пробует `http://ai` и, если хост недоступен, просит указать адрес Aperture. Режим моста подключает лаунчер к Aperture через встроенный узел Tailscale: в сети `tailnet` виден только прокси лаунчера, полный клиент Tailscale на машине не нужен. Все настройки TUI доступны и командами: `aperture bridge add`, `aperture endpoint add`, `aperture serve` держит мост на фиксированном порту, есть и пример юнита systemd.
Для кого. Командам, которые используют Aperture от Tailscale как точку доступа к моделям и хотят запускать разных агентов с одной настройкой.
Подходит, если
- Разработчик переключается между Claude Code и Codex и не хочет вручную менять ключи и адреса
- На машине нельзя поставить Tailscale целиком, поэтому нужен встроенный мост до Aperture
- Адрес Aperture нужно зафиксировать для клиентов через `aperture serve --bridge work`
- Настройку лаунчера кладут в скрипт, дотфайл или юнит systemd через команды `endpoint` и `bridge`
Не подходит, если
- Aperture в организации не используется: лаунчер рассчитан только на него
- Нужна стабильная версия: автор прямо называет репозиторий альфа-версией и обещает значительные изменения
- Достаточно запускать одного агента с его собственными настройками
Пример запроса к агенту
Запусти Codex через aperture с моделью openai/gpt-5-mini и проверь, что `endpoint` e1 отвечаетОграничения
Репозиторий помечен как альфа-версия и может существенно меняться без предупреждения. Лаунчер работает только с Aperture: если `http://ai` отвечает, но принадлежит другой сети `tailnet`, нужно сменить адрес через `Change URL`. Каждый процесс `aperture` на мосту регистрируется отдельным устройством `tailnet`, новому устройству нужен один вход либо ключ `TS_AUTHKEY`. Построенные на macOS файлы подписаны и нотаризованы, но архив из браузера Gatekeeper может заблокировать. Установочный скрипт ставит бинарный файл в `/usr/local/bin`.
Как отключить. Удалите бинарный файл `aperture` из `/usr/local/bin` (или каталога из `APERTURE_INSTALL_DIR`) и снимите мосты командой `aperture bridge delete <имя>`: она сначала выводит машины моста из `tailnet`.
Частые вопросы
Как установить aperture?
Выполните `curl -fsSL https://raw.githubusercontent.com/tailscale/aperture-cli/main/install.sh | sh`, скрипт проверяет контрольную сумму релиза. Есть и `go install github.com/tailscale/aperture-cli/cmd/aperture@latest`.
Как запустить Codex через aperture?
Выполните `aperture codex --endpoint e1` либо `aperture codex --model openai/gpt-5-mini`. Первый неизвестный флаг или `--` передает остальное агенту без изменений.
Что такое режим моста?
Встроенный узел Tailscale, через который лаунчер достает Aperture. В `tailnet` виден только прокси лаунчера, а полный клиент Tailscale на машине не нужен.
Как войти в `tailnet` без браузера?
Задайте `TS_AUTHKEY` многоразовым ключом от нужной сети `tailnet`: новые устройства авторизуются без браузера, а уже зарегистрированные используют сохраненные учетные данные.
Какие агенты поддерживаются?
Claude Code, Gemini CLI, OpenCode, Codex, GitHub Copilot CLI, Hermes Agent, Oh My Pi, Pi и Claude Cowork. Их запускают по имени бинарного файла, например `aperture codex`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыArcBox запускает Claude Code в одноразовой микровиртуалке на Mac: своя ОС, пустая рабочая папка и старт примерно за секунду
Платформа на вашем сервере, которая выдает каждому агенту свою Linux-машину с SSH и MCP-инструментами для команд и файлов
CLI запускает команды и ИИ-агентов в изолированных микро-ВМ с загрузкой до 125 мс и скрывает ключи API от самой песочницы.
CLI запускает Claude Code и Codex в изолированных контейнерах Docker с брандмауэром, воркдеревьями и образом без Dockerfile.
AgentBox запускает Claude Code, Codex и Open Code в отдельных виртуальных машинах: на вашем ПК, своем сервере или в облаке.
Нативный терминал для macOS с MCP-сервером и CLI: агенты видят панели, команды и вывод, а разрешения вы даете в одном окне
Коротко о README
В README отмечен альфа-статус, перечислены поддерживаемые агенты, установка скриптом, через Go и из исходников, режим моста, выбор и смена подключений, параллельные сессии и командная строка.