Перейти к содержанию

Быстрый старт

cautem — один CLI, который запускает coding-агентов в песочницах с политикой на Docker или Podman. Установите CLI, убедитесь, что контейнерный движок работает, и скачайте образ песочницы — затем запустите gateway и создайте первую песочницу.

Установка CLI

Полная инструкция по платформе: macOS или Linux.

через установщик рекомендуется

Установщик скачивает проверенный архив релиза из quarshell-cli, ставит CLI и вспомогательные файлы в ~/.local/bin и запускает локальный Gateway, если он включён для платформы. В текущем Windows-архиве есть только CLI. Выполните:

curl -LsSf https://raw.githubusercontent.com/KLORQ/quarshell-cli/main/install.sh | sh
cautem version
cautem status

cautem status должен показать Connected. CAUTEM_NO_START=1 отключает запуск gateway, CAUTEM_VERSION=vX.Y.Z закрепляет релиз.

Для Podman сначала запустите engine и установите CLI с CAUTEM_NO_START=1. Затем экспортируйте CAUTEM_GATEWAY_RUNTIME=podman до команды cautem gateway ensure, иначе установщик запустит Docker backend по умолчанию.

Бинарники и вспомогательные файлы ставятся в ~/.local/bin — этот каталог должен быть в PATH.

Для установки в другой каталог:

curl -LsSf https://raw.githubusercontent.com/KLORQ/quarshell-cli/main/install.sh \
  | CAUTEM_INSTALL_DIR=/usr/local/bin sh

из исходников

Сборка из workspace опубликованных модулей:

git clone https://github.com/KLORQ/quarshell-workspace.git
cd quarshell-workspace
tools/checkout-modules.sh
task workspace:sync

go build -C quarshell-cli -o cautem ./cmd/cautem
go build -C quarshell-gateway -o quarshell-gateway ./cmd/quarshell-gateway
./cautem install
./cautem version

Контейнерный движок

Нужен работающий провайдер вычислений. По умолчанию — Docker; Podman работает через тот же Engine API.

Docker Engine 28.0+ или Docker Desktop. На macOS и Windows лучше backend Docker VMM.

docker info
cautem doctor
cautem status

podman machine init     # один раз
podman machine start
export CAUTEM_GATEWAY_RUNTIME=podman
cautem gateway ensure
cautem status

systemctl --user enable --now podman.socket
export CAUTEM_GATEWAY_RUNTIME=podman
cautem gateway ensure
cautem status

cautem status должен подтвердить соединение с выбранным Gateway. Подробнее о движках: Docker · Podman.

Образ песочницы

Скачайте базовый образ — в нём есть всё, что нужно агенту в CLI:

docker pull ghcr.io/cautem/cautem/sandboxes/base:latest
export CAUTEM_USE_GHCR=1

Собрать образы самому

Из корня workspace: task runtime:image:cli собирает базовый образ, task docker:agent:cursor — агента Cursor. Полный список — Образы.