Lightweight sandboxing(bwrap) wrapper for the pi coding agent.

A developer released pi-box, a Bash wrapper that runs the pi coding agent inside a bubblewrap (bwrap) sandbox. The project mounts the working directory read-write at /work, keeps host home directories hidden unless explicitly mounted read-only via -H, and stores the agent's profile and sessions in a project-local .pi-box directory. It also supports attaching to running sandboxes, one-shot prompts, and optional X11/GPU passthrough.

| | /usr/bin/env bash | | | pi-box — запуск pi в изолированной bwrap-песочнице. | | | | | | Проект монтируется в /work целиком; всё, что нужно инструменту, лежит в | | | <проект /.pi-box. Наружу ничего не пишется, домашние каталоги хоста | | | и ключи в них внутри не видны — кроме явного -H, и то только для чтения. | | | | | | Внутри: /work проект, rw , /box/profile, /box/sessions, /pi ro , /home пусто. | | | | | | Полная справка: pi-box --help | | | set -uo pipefail | | | ── цвета ──────────────────────────────────────────────────────────────────── | | | Только для терминала: в конвейере лишние escape-последовательности мешают. | | | if -t 1 ; then | | | C RST=$'\033 0m'; C B=$'\033 1m'; C DIM=$'\033 2m' | | | C CYAN=$'\033 36m'; C GREEN=$'\033 32m'; C YEL=$'\033 33m'; C RED=$'\033 31m' | | | else | | | C RST=""; C B=""; C DIM=""; C CYAN=""; C GREEN=""; C YEL=""; C RED="" | | | fi | | | ── справка ──────────────────────────────────────────────────────────────── | | | Текст целиком внутри функции, а не вырезан из шапки по номерам строк: | | | правка шапки однажды уже обрезала help посреди предложения. | | | usage { | | | cat <<EOF | | | ${C B}pi-box${C RST} — ${C CYAN}pi${C RST} в изолированной песочнице bwrap . | | | Основной режим — запуск pi в текущем каталоге. Проект монтируется в /work и | | | доступен на запись; домашние каталоги хоста внутри не видны. | | | Повторный вызов подключается к уже запущенной песочнице. | | | ${C B}ЗАПУСК${C RST} | | | ${C GREEN}pi-box${C RST} PATH запустить по умолчанию текущий каталог | | | ${C GREEN}pi-box${C RST} -p "промпт" PATH один запрос, без TUI | | | ${C GREEN}pi-box${C RST} -a ИМЯ\|PATH подключиться к запущенной | | | ${C GREEN}pi-box${C RST} -m меню песочниц даже если есть своя | | | ${C GREEN}pi-box${C RST} -x + X11 и GPU: рендер 3D, окна | | | ${C GREEN}pi-box${C RST} -H + домашний каталог, только чтение | | | ${C DIM}Без аргументов открывается меню песочниц.${C RST} | | | ${C B}ФАЙЛЫ${C RST} | | | ${C GREEN}pi-box${C RST} -l список песочниц | | | ${C GREEN}pi-box${C RST} --rm ИМЯ\|PATH удалить .pi-box проекта | | | ${C GREEN}pi-box${C RST} -f не спрашивать подтверждения при удалении | | | ${C GREEN}pi-box${C RST} --new пересоздать сносит профиль и сессии | | | ${C GREEN}pi-box${C RST} -v SRC:DST :ro\|rw смонтировать каталог можно несколько | | | ${C B}ВНУТРИ ПЕСОЧНИЦЫ${C RST} | | | ${C CYAN}/work${C RST} проект, чтение и запись | | | ${C CYAN}\$HOME${C RST} весь дом, только чтение с -H | | | ${C CYAN}/box/profile${C RST} профиль pi: auth, settings, модели, плагины | | | ${C CYAN}/box/sessions${C RST} сессии | | | ${C CYAN}/pi${C RST} установленный pi только чтение | | | ${C DIM}Состояние инструмента — <проект /.pi-box профиль, сессии ; сам каталог | | | агенту не виден. /home внутри пуст, корень, /etc и /var — только чтение.${C RST} | | | ${C B}-H: ДОМАШНИЙ КАТАЛОГ${C RST} | | | Дом монтируется рядом с /work по своему пути, ${C B}только для чтения${C RST}. | | | Агент видит конфиги и может искать файлы, но ничего там не меняет. | | | От чтения скрыты известные хранилища секретов: | | | ${C DIM}.ssh .gnupg .aws .kube .docker .mozilla .netrc .git-credentials | | | .my.cnf .pgpass .password-store .config/gh .config/gcloud .local/share/keyrings${C RST} | | | ${C B}ПЕРЕМЕННЫЕ${C RST} | | | ${C CYAN}PI BOX HOME${C RST} реестр песочниц по умолчанию ~/.local/share/pi-box | | | ${C CYAN}PI BOX PI${C RST} каталог @earendil-works с установленным pi | | | ${C CYAN}PI BOX RUNTIME${C RST} откуда брать auth, модели и плагины по умолчанию ~/.pi/agent | | | ${C DIM}Нужны bwrap, tmux и установленный pi.${C RST} | | | EOF | | | } | | | ── настройки ──────────────────────────────────────────────────────────────── | | | PI BOX HOME="${PI BOX HOME:-${XDG DATA HOME:-$HOME/.local/share}/pi-box}" | | | PI SRC="${PI BOX PI:-$HOME/.local/lib/node modules/@earendil-works}" | | | PI BASENAME="pi-coding-agent" | | | RUNTIME="${PI BOX RUNTIME:-$HOME/.pi/agent}" источник auth/models/плагинов | | | SESSION ID="${PI BOX SESSION ID:-main}" | | | BOX DIRNAME=".pi-box" | | | TMUX NAME="${PI BOX TMUX:-pi-box}" | | | XAUTHORITY нужен для -x/--x11: без него X11 отказывает в доступе. Если | | | переменная не задана, ищем файл в обычных местах. | | | if -z "${XAUTHORITY:-}" ; then | | | for c in "$HOME/.Xauthority" "${XDG RUNTIME DIR:-/run/user/$ id -u }/xauth" \ | | | "$HOME/.local/share/sx/xauthority"; do | | | -f "$c" && { XAUTHORITY="$c"; break; } | | | done | | | fi | | | require pi { | | | if -f "$PI SRC/$PI BASENAME/dist/bundle/cli.js" ; then | | | echo "${C RED}Не найден pi${C RST}: $PI SRC/$PI BASENAME" &2 | | | echo "Укажи установку через ${C CYAN}PI BOX PI${C RST} или поставь pi обычным способом." &2 | | | exit 1 | | | fi | | | } | | | Проверяем зависимости до работы: иначе падение будет невнятным или, хуже, | | | скрипт напишет «запущена», не запустив ничего . | | | require tools { | | | local miss= t | | | for t in bwrap tmux; do | | | command -v "$t" /dev/null 2 &1 \|\| miss+= "$t" | | | done | | | node ищем один раз и запоминаем путь: запускать будем именно его, а не | | | жёсткий /usr/bin/node — иначе с nvm проверка проходит, а запуск падает. | | | NODE BIN=$ command -v node 2 /dev/null | | | -n "$NODE BIN" \|\| miss+= "node" | | | ${ miss @ } -eq 0 && return 0 | | | echo "${C RED}Нет программ${C RST}: ${miss }" &2 | | | echo "Нужны: bwrap bubblewrap , tmux и node." &2 | | | echo "Пример установки Debian/Ubuntu : sudo apt install bubblewrap tmux nodejs" &2 | | | exit 1 | | | } | | | Реестр песочниц: без общего каталога перечислять иначе нечего. | | | register { | | | mkdir -p "$PI BOX HOME" | | | grep -qxF "$1" "$PI BOX HOME/boxes" 2 /dev/null \|\| echo "$1" "$PI BOX HOME/boxes" | | | } | | | Сокет в /tmp: путь внутри проекта может быть длинным, а sun path — 107 байт. | | | box socket { echo "/tmp/pi-box-$ id -u /$ printf %s "$1" \| md5sum \| cut -c1-12 .sock"; } | | | ── создание .pi-box ───────────────────────────────────────────────────────── | | | box init { | | | local project="$1" | | | local d="$project/$BOX DIRNAME" | | | mkdir -p "$d"/{profile/extensions,sessions,tmp} | | | Ключи не должны попасть в git: внутри .pi-box игнорируем всё. | | | -f "$d/.gitignore" \|\| printf ' \n' "$d/.gitignore" | | | -f "$RUNTIME/auth.json" && install -m 600 "$RUNTIME/auth.json" "$d/profile/auth.json" | | | -f "$RUNTIME/models-store.json" && install -m 600 "$RUNTIME/models-store.json" "$d/profile/models-store.json" | | | Плагины не копируются: они берутся из $RUNTIME/extensions при запуске. | | | Если нужны свои — положи их сюда, и они получат приоритет. | | | if -f "$d/profile/settings.json" ; then | | | local provider model | | | provider=$ sed -n 's/. "defaultProvider" : "$ ^" $". /\1/p' "$RUNTIME/settings.json" 2 /dev/null \| head -1 | | | model=$ sed -n 's/. "defaultModel" : "$ ^" $". /\1/p' "$RUNTIME/settings.json" 2 /dev/null \| head -1 | | | cat "$d/profile/settings.json" <<EOF | | | { | | | "packages": , | | | "defaultProvider": "${provider:-ez-ai}", | | | "defaultModel": "${model:-deepseek/deepseek-v4.1-flash}", | | | "theme": "dark" | | | } | | | EOF | | | fi | | | cat "$d/tmp/tmux.conf" <<'EOF' | | | set -g default-terminal "tmux-256color" | | | set -as terminal-features ", :RGB" | | | set -g extended-keys on | | | set -g extended-keys-format csi-u | | | set -g mouse on | | | set -g history-limit 50000 | | | EOF | | | } | | | ── argv для bwrap ───────────────────────────────────────────────────────────── | | | /work монтируется как есть, но поверх .pi-box кладётся пустой tmpfs. Профиль | | | rw pi пишет lock-файлы , но auth.json и models-store.json — ro поверх, чтобы | | | случайная запись или rm не сломали ключ. | | | box bwrap { | | | local project="$1" | | | local p="$project/$BOX DIRNAME/profile" | | | BW= | | | bwrap | | | --ro-bind /usr /usr | | | --ro-bind /etc /etc | | | --ro-bind /var /var | | | --proc /proc | | | --dev /dev | | | --tmpfs /tmp | | | /home не пробрасываем: там чужие каталоги, ключи и конфиги. Внутри | | | остаётся пустой tmpfs, а нужное pi, проект смонтировано точечно. | | | --tmpfs /home | | | --bind "$project" /work | | | --dir /box | | | --bind "$p" /box/profile | | | --bind "$project/$BOX DIRNAME/sessions" /box/sessions | | | pi берём из установки на хосте, только чтение. | | | --ro-bind "$PI SRC" /pi | | | Окружение и рабочий каталог — самим bwrap, без shell-обвязки: | | | так значения с кавычками и $ ... не попадут в интерпретатор. | | | --setenv HOME /box | | | --setenv PI CODING AGENT DIR /box/profile | | | --chdir /work | | | --unshare-pid | | | --die-with-parent | | | | | | Ctrl-H: домашний каталог рядом с /work, только чтение. Именно ro, а не | | | «дом как проект»: агент может читать конфиги и искать файлы, но ничего | | | там не меняет. Секреты маскируем даже от чтения — они не нужны для работы, | | | а утекут в контекст модели при первом же ls. | | | if "$HOMERO" = 1 ; then | | | local hp="$HOME" | | | BW+= --ro-bind "$hp" "$hp" | | | Каталог — пустым tmpfs, файл — /dev/null: --tmpfs на файл bwrap | | | отвергает «Destination is not a directory», проверено . | | | local sec | | | for sec in .ssh .gnupg .password-store .aws .kube .docker .mozilla \ | | | .config/gh .config/gcloud .local/share/keyrings \ | | | .netrc .git-credentials .my.cnf .pgpass; do | | | -e "$hp/$sec" \|\| continue | | | if -d "$hp/$sec" ; then | | | BW+= --tmpfs "$hp/$sec" | | | else | | | BW+= --ro-bind /dev/null "$hp/$sec" | | | fi | | | done | | | fi | | | Маскируем .pi-box внутри /work — свой и чужие вложенные песочницы . | | | | | | Именно --tmpfs на существующий каталог, а не безусловный --tmpfs на путь: | | | bwrap создаёт точку монтирования в реальной файловой системе, если её нет | | | проверено . Иначе на хосте появлялся пустой каталог-ловушка, а find root | | | затем находил его и подменял им проект. | | | | | | Пути вложенных берём из реестра, а не find: обход всего $HOME занимал | | | десятки секунд, а известных песочниц единицы. | | | local nested rel | | | -d "$project/$BOX DIRNAME" && BW+= --tmpfs "/work/$BOX DIRNAME" | | | while IFS= read -r nested; do | | | -n "$nested" \|\| continue | | | -d "$nested/$BOX DIRNAME" \|\| continue | | | case "$nested" in | | | "$project"/ rel="${nested $project}" ;; | | | continue ;; | | | esac | | | BW+= --tmpfs "/work$rel/$BOX DIRNAME" | | | done < "$PI BOX HOME/boxes" | | | Раскладку /bin, /lib, /lib64, /sbin повторяем с хоста, а не угадываем: на | | | merged-usr это симлинки в usr, но на Fedora /lib64 - usr/lib64, и жёсткий | | | usr/lib оставил бы /lib64 битым. Симлинк — копируем цель, настоящий | | | каталог — монтируем. | | | local l tgt | | | for l in /bin /lib /lib64 /sbin; do | | | tgt=$ readlink "$l" 2 /dev/null | | | if -n "$tgt" ; then | | | BW+= --symlink "$tgt" "$l" | | | elif -d "$l" ; then | | | BW+= --ro-bind "$l" "$l" | | | fi | | | done | | | node бывает вне /usr nvm, /opt, /usr/local , а этих каталогов внутри нет: | | | запуск упал бы, хотя проверка command -v прошла. Пробрасываем тот самый | | | бинарник, которым запускаем, чтобы проверка и запуск не расходились. | | | case "$NODE BIN" in | | | /usr/ \|/etc/ \|/var/ ;; | | | -n "$NODE BIN" && BW+= --ro-bind "$NODE BIN" "$NODE BIN" ;; | | | esac | | | Плагины: нет своих — подключаем каталог из $RUNTIME read-only, чтобы | | | правка плагина была видна во всех песочницах сразу. Есть свои — ничего не | | | монтируем, чтобы не перекрыть намеренную настройку. | | | if -z "$ ls -A "$p/extensions" 2 /dev/null " && -d "$RUNTIME/extensions" ; then | | | BW+= --ro-bind "$RUNTIME/extensions" /box/profile/extensions | | | fi | | | Ключи — только чтение, поверх rw-профиля. | | | -f "$p/auth.json" && BW+= --ro-bind "$p/auth.json" /box/profile/auth.json | | | -f "$p/models-store.json" && BW+= --ro-bind "$p/models-store.json" /box/profile/models-store.json | | | -v src:dst :ro\|rw — как в docker. Целевую точку bwrap создаёт сам, включая | | | вложенную. | | | local v src dst mode rest | | | for v in ${VOLUMES @ +"${VOLUMES @ }"}; do | | | -n "$v" \|\| continue | | | src="${v%%: }"; rest="${v :}" | | | "$rest" = "$v" && { echo "-v: нужен вид <источник :<куда :ro\|rw , получил '$v'" &2; exit 1; } | | | dst="${rest%%: }" | | | mode="${rest :}"; "$mode" = "$rest" && mode="rw" | | | src="${src/ \~/$HOME}" | | | -e "$src" \|\| { echo "-v: нет источника '$src'" &2; exit 1; } | | | case "$mode" in | | | ro\|readonly BW+= --ro-bind "$src" "$dst" ;; | | | rw\|readwrite BW+= --bind "$src" "$dst" ;; | | | echo "-v: режим '$mode' неизвестен ro или rw " &2; exit 1 ;; | | | esac | | | done | | | -x/--x11: проброс X11 и GPU. /sys нужен Mesa, иначе рендер уходит на llvmpipe. | | | if "$X11" = 1 ; then | | | -d /dev/dri && BW+= --dev-bind /dev/dri /dev/dri | | | -d /sys && BW+= --ro-bind /sys /sys | | | -d /tmp/.X11-unix && BW+= --ro-bind /tmp/.X11-unix /tmp/.X11-unix | | | -n "${XAUTHORITY:-}" && -f "$XAUTHORITY" && BW+= --ro-bind "$XAUTHORITY" /box/.Xauthority | | | BW+= --setenv DISPLAY "${DISPLAY:-:0}" | | | -n "${XAUTHORITY:-}" && BW+= --setenv XAUTHORITY /box/.Xauthority | | | BW+= --setenv LIBGL ALWAYS SOFTWARE 0 | | | Звук и сессия — только если есть. | | | -n "${XDG RUNTIME DIR:-}" && -d "$XDG RUNTIME DIR" && \ | | | BW+= --ro-bind "$XDG RUNTIME DIR" "$XDG RUNTIME DIR" --setenv XDG RUNTIME DIR "$XDG RUNTIME DIR" | | | fi | | | } | | | ── поиск песочниц ─────────────────────────────────────────────────────────── | | | Из реестра: "<путь " по имени каталога, точному пути или части имени. | | | find box { | | | local want="$1" | | | -f "$PI BOX HOME/boxes" \|\| return 1 | | | local line hit="" | | | while IFS= read -r line; do | | | -n "$line" \|\| continue | | | -d "$line" \|\| continue | | | if "$line" = "$want" \|\| "$ basename "$line" " = "$want" ; then | | | echo "$line"; return 0 | | | fi | | | case "$ basename "$line" " in "$want" hit="$line" ;; esac | | | done < "$PI BOX HOME/boxes" | | | -n "$hit" && { echo "$hit"; return 0; } | | | return 1 | | | } | | | is running { | | | local s; s=$ box socket "$1" | | | -S "$s" && tmux -S "$s" has-session -t "$TMUX NAME" 2 /dev/null | | | } | | | Режимы запущенной песочницы читаем из argv живого bwrap: скрипт их нигде не | | | хранит, а процесс о них знает. Так статус честный и после перезапуска | | | инструмента. Вывод: " X11 ~ro" или пусто. | | | box modes { | | | local s pid argv | | | s=$ box socket "$1" | | | -S "$s" \|\| return 0 | | | pid=$ tmux -S "$s" list-panes -a -F ' {pane pid}' 2 /dev/null \| head -1 | | | -n "$pid" && -r "/proc/$pid/cmdline" \|\| return 0 | | | argv=$ tr '\0' '\n' < "/proc/$pid/cmdline" 2 /dev/null | | | grep -qx '/dev/dri' <<< "$argv" && printf ' X11' | | | Дом виден как ro-bind самого $HOME — ищем именно такую пару аргументов. | | | grep -A1 -x -- '--ro-bind' <<< "$argv" \| grep -qx -- "$HOME" && printf ' ~ro' | | | } | | | running boxes { | | | -f "$PI BOX HOME/boxes" \|\| return 0 | | | local line | | | while IFS= read -r line; do | | | -n "$line" && -d "$line" && is running "$line" && echo "$line" | | | done < "$PI BOX HOME/boxes" | | | } | | | cmd list { | | | -s "$PI BOX HOME/boxes" \|\| { echo "песочниц нет"; return; } | | | local line n sz sess run | | | while IFS= read -r line; do | | | -n "$line" \|\| continue | | | if -d "$line/$BOX DIRNAME" ; then | | | printf " %-24s удалена \n" "$ basename "$line" " | | | continue | | | fi | | | n=$ basename "$line" ; sz=$ du -sh "$line/$BOX DIRNAME" 2 /dev/null \| cut -f1 | | | sess=$ find "$line/$BOX DIRNAME/sessions" -maxdepth 1 -name ' .jsonl' 2 /dev/null \| wc -l | | | run=""; is running "$line" && run=" запущена " | | | printf " %-24s %6s сессий:%s%s\n" "$n" "$sz" "$sess" "${C GREEN}$run${C RST}" | | | done < "$PI BOX HOME/boxes" | | | echo | | | echo "удалить: pi-box --rm <имя " | | | } | | | cmd rm { | | | local target="${1:-}" line sock pid | | | -n "$target" \|\| { echo "укажи песочницу pi-box -l "; exit 1; } | | | line=$ find box "$target" \|\| { echo "нет песочницы '$target' pi-box -l " &2; exit 1; } | | | confirm rm "$line" \|\| return 1 | | | Гасим ровно процессы песочницы: PID панелей tmux, а потом сам сервер. | | | pkill по строке argv тут опасен — под шаблон попадает и наш собственный | | | shell, если в его аргументах есть тот же путь. | | | sock=$ box socket "$line" | | | for pid in $ tmux -S "$sock" list-panes -a -F ' {pane pid}' 2 /dev/null ; do | | | kill "$pid" 2 /dev/null | | | done | | | tmux -S "$sock" kill-server 2 /dev/null | | | sleep 1 | | | rm -rf "$line/$BOX DIRNAME" && echo "${C GREEN}удалено${C RST}: $line/$BOX DIRNAME" | | | Убираем из реестра. | | | if -f "$PI BOX HOME/boxes" ; then | | | grep -vxF "$line" "$PI BOX HOME/boxes" "$PI BOX HOME/boxes.tmp" 2 /dev/null \|\| true | | | mv "$PI BOX HOME/boxes.tmp" "$PI BOX HOME/boxes" | | | fi | | | } | | | Удаление запущенной песочницы прерывает работу и сносит профиль с историей — | | | отменить это нельзя. Спрашиваем только у активной: у остановленной терять | | | нечего, и подтверждение там было бы лишним шумом. | | | confirm rm { | | | local line="$1" ans="" | | | is running "$line" \|\| return 0 | | | "$FORCE" = 1 && return 0 | | | printf '%s' "${C YEL}«$ basename "$line" » запущена${C RST} — работа прервётся, профиль и история сессий удалятся. Удалить? y/N " &2 | | | Читаем с терминала, а не со stdin: в режиме --rm stdin бывает занят | | | конвейером, а в меню его уже прочитал fzf. Нет терминала cron, скрипт — | | | отвечать некому, поэтому не удаляем: пусть решает --force. | | | { read -r ans < /dev/tty; } 2 /dev/null \|\| { | | | echo "нет терминала для подтверждения — используй --force" &2 | | | return 1 | | | } | | | case "$ans" in | | | yYдД return 0 ;; | | | esac | | | echo "отменено" &2 | | | return 1 | | | } | | | ── интерактивное меню ──────────────────────────────────────────────────────── | | | ── интерактивное меню ──────────────────────────────────────────────────────── | | | Живёт в текущем экране fzf --height , история остаётся видна. Цикл: | | | после удаления или отказа показываем список снова, пока не выбрана песочница | | | или пользователь не нажал Esc. | | | | | | Enter открыть создать, если выбран текущий каталог | | | Ctrl-D удалить выбранную | | | Esc выйти | | | | | | Цель — одной командой сделать всё: завести, открыть, снести. | | | cmd menu { | | | command -v fzf /dev/null 2 &1 \|\| { | | | echo "${C RED}Нужен fzf${C RST} для интерактивного выбора." &2 | | | echo "Установи fzf или используй аргументы pi-box -l, pi-box PATH ." &2 | | | exit 1 | | | } | | | local here; here=$ pwd -P | | | Из домашнего каталога песочницу не создаём см. проверку ниже , поэтому | | | и строки «создать» для него нет. | | | "$here" = "$HOME" && here="" | | | while :; do | | | Однострочные строки: fzf 0.74 разворачивает \n внутри элемента | | | нестабильно — при единственной строке рисует «␊» вместо переноса, | | | поэтому многострочность не используем. Разделитель полей — \x1f, | | | а не таб: таб может встретиться в пути. | | | local -a rows= | | | Создание — отдельная заметная строка, а не серый путь: раньше её было | | | не отличить от «открыть существующую». | | | -n "$here" && rows+= "${C CYAN}+ создать здесь${C RST} ${C DIM}$here${C RST}\x1fHERE" | | | if -f "$PI BOX HOME/boxes" ; then | | | local line name run st m | | | while IFS= read -r line; do | | | -n "$line" \|\| continue | | | -d "$line/$BOX DIRNAME" \|\| continue | | | "$line" = "$here" && continue | | | name=$ basename "$line" | | | Статус и режимы — в первой колонке: её видно. Режимы берём у живого | | | процесса, чтобы после перезапуска инструмента они не пропадали. | | | if is running "$line"; then | | | m=$ box modes "$line" | | | st="${C GREEN}●${C RST}${C YEL}${m}${C RST}" | | | else | | | st="${C DIM}·${C RST}" | | | fi | | | sz=$ du -sh "$line/$BOX DIRNAME" 2 /dev/null \| cut -f1 | | | rows+= "$ printf '%-16s %s' "$name" "$st" ${C DIM}${sz} $line${C RST}\x1f$line" | | | done < "$PI BOX HOME/boxes" | | | fi | | | Активные режимы — в приглашении: видно, с чем откроется выбранная. | | | local modes="" | | | "$X11" = 1 && modes=" · ${C YEL}X11${C RST}" | | | "$HOMERO" = 1 && modes="$modes · ${C YEL}\$HOME ro${C RST}" | | | local out="" | | | out=$ printf '%b\0' "${rows @ }" \| fzf --ansi --read0 \ | | | --height="${FZF HEIGHT:-~45%}" \ | | | --reverse --border --no-multi \ | | | --expect=ctrl-d,ctrl-x,ctrl-h \ | | | --prompt="песочница${modes} " \ | | | --header='Enter — открыть · Ctrl-D — удалить · Ctrl-X — X11 · Ctrl-H — $HOME ro · Esc — выход' \ | | | --delimiter='\x1f' --with-nth=1 --accept-nth=2 \|\| exit 0 | | | local -a kl= | | | readarray -t kl < < printf '%s\n' "$out" | | | ${kl 1 :-}: при set -u обращение к отсутствующему элементу — ошибка, | | | а при Enter fzf отдаёт одну строку без имени клавиши . | | | local pressed="${kl 0 :-}" want="${kl 1 :-}" | | | При Enter строки с клавишей нет — выбор оказывается первым. | | | "${ kl @ }" -lt 2 && { pressed=""; want="${kl 0 :-}"; } | | | case "$pressed" in | | | ctrl-x X11=$ 1 - X11 ; continue ;; | | | ctrl-h HOMERO=$ 1 - HOMERO ; continue ;; | | | esac | | | -n "$want" \|\| continue | | | if "$pressed" = ctrl-d ; then | | | if "$want" = HERE ; then | | | echo "${C YEL}Здесь ещё нет песочницы — удалять нечего${C RST}" &2 | | | continue | | | fi | | | cmd rm "$want" | | | continue | | | fi | | | "$want" = HERE && MENU PROJECT="$here" \|\| MENU PROJECT="$want" | | | return 0 | | | done | | | } | | | cmd attach { | | | local want="${1:-}" line | | | if -z "$want" ; then | | | local run= ; while IFS= read -r l; do run+= "$l" ; done < < running boxes | | | case "${ run @ }" in | | | 0 echo "нет запущенных песочниц pi-box -l " &2; exit 1 ;; | | | 1 line="${run 0 }" ;; | | | echo "запущено несколько — укажи имя:" &2 | | | for l in "${run @ }"; do echo " $ basename "$l" " &2; done; exit 1 ;; | | | esac | | | else | | | line=$ find box "$want" \|\| { echo "нет песочницы '$want' pi-box -l " &2; exit 1; } | | | fi | | | is running "$line" \|\| { echo "песочница '$ basename "$line" ' не запущена" &2; exit 1; } | | | exec tmux -S "$ box socket "$line" " attach -t "$TMUX NAME" | | | } | | | ── разбор аргументов ──────────────────────────────────────────────────────── | | | NEW=0; PROMPT=""; ATTACH=""; X11=0; HOMERO=0; VOLUMES= ; PROJECT=""; MENU=0; FORCE=0 | | | while $ -gt 0 ; do | | | case "$1" in | | | -h\|--help usage; exit 0 ;; | | | -l\|--list cmd list; exit 0 ;; | | | --rm shift; cmd rm "${1:-}"; exit $? ;; | | | -f\|--force FORCE=1; shift ;; | | | --new NEW=1; shift ;; | | | -m\|--menu MENU=1; shift ;; | | | -x\|--x11 X11=1; shift ;; | | | -H\|--home HOMERO=1; shift ;; | | | -v\|--volume VOLUMES+= "${2:-}" ; shift 2 ;; | | | -a\|--attach ATTACH="1"; shift | | | case "${1:-}" in ''\|- ;; ATTACH="$1"; shift ;; esac ;; | | | -p\|--print PROMPT="${2:-}"; shift 2 ;; | | | - echo "неизвестный флаг: $1" &2; exit 1 ;; | | | PROJECT="$1"; shift ;; | | | esac | | | done | | | Зависимости проверяем сразу после разбора аргументов: --help и -l должны | | | работать без них, а всё остальное — нет. | | | require tools | | | -n "$ATTACH" && { "$ATTACH" = 1 && cmd attach "" \|\| cmd attach "$ATTACH"; } | | | Ищем .pi-box вверх по дереву — как git. Запуск из подкаталога подхватывает | | | уже существующую песочницу, а не плодит вложенную. | | | find root { | | | local dir="$1" | | | while :; do | | | -d "$dir/$BOX DIRNAME" && { echo "$dir"; return 0; } | | | "$dir" = "/" && break | | | dir=$ dirname "$dir" | | | done | | | return 1 | | | } | | | PROJECT="${PROJECT:-$PWD}" | | | -d "$PROJECT" \|\| { echo "${C RED}нет каталога${C RST}: $PROJECT" &2; exit 1; } | | | realpath -P: без него один проект попадёт в реестр под разными путями | | | симлинки, .. , относительный путь , и песочница «раздвоится». | | | PROJECT=$ cd "$PROJECT" 2 /dev/null && pwd -P | | | -n "$PROJECT" \|\| { echo "${C RED}не удалось определить каталог${C RST}: $PWD" &2; exit 1; } | | | ROOT=$ find root "$PROJECT" \|\| ROOT="" | | | Меню — только когда песочницы нет ни здесь, ни выше. Если мы уже в проекте | | | с .pi-box, запуск/подключение ожидается сразу, без списка. | | | if "$MENU" = 1 \|\| { -z "$ROOT" && "$NEW" = 0 && -z "$PROMPT" \ | | | && "$X11" = 0 && ${ VOLUMES @ } = 0 && -z "$ATTACH" ; }; then | | | cmd menu | | | PROJECT="${MENU PROJECT:-$PROJECT}" | | | ROOT=$ find root "$PROJECT" \|\| ROOT="" | | | fi | | | -n "$ROOT" \|\| ROOT="$PROJECT" | | | Защита: корень и дом — это не проект. Иначе /work получил бы весь $HOME | | | включая .ssh, .pi, чужие проекты , и агент мог бы их править. Дом для чтения | | | даёт Ctrl-H — он монтирует $HOME рядом с /work, не делая его проектом. | | | case "$ROOT" in | | | "$HOME" echo "${C RED}Нельзя${C RST} запускать в домашнем каталоге: /work получил бы весь $HOME." &2 | | | echo "Зайди в каталог проекта: ${C CYAN}cd ~/code/myproject && pi-box${C RST}" &2 | | | echo "Весь дом только для чтения — ${C CYAN}pi-box -m${C RST} и Ctrl-H." &2 | | | exit 1 ;; | | | "/" echo "${C RED}Нельзя${C RST} использовать корень / как проект." &2; exit 1 ;; | | | esac | | | .pi-box не должен быть симлинком. Проект монтируется в /work rw, поэтому | | | симлинк в .pi-box позволял бы писать за пределы песочницы в ~/.ssh, /etc | | | и увёл бы --rm на чужой каталог. Не тюрьма — страховка от случайности. | | | reject link { | | | -L "$1" \|\| { | | | echo "${C RED}опасный симлинк${C RST}: $1" &2 | | | echo ".pi-box и всё внутри должны быть настоящими каталогами и файлами." &2 | | | exit 1 | | | } | | | } | | | reject link "$ROOT/$BOX DIRNAME" | | | for sub in profile profile/extensions sessions tmp profile/auth.json \ | | | profile/models-store.json profile/settings.json tmp/tmux.conf; do | | | reject link "$ROOT/$BOX DIRNAME/$sub" | | | done | | | register "$ROOT" | | | --new на работающей песочнице сносит профиль из-под живой сессии: она | | | продолжит держать старые файлы bind , а новая запустится с чистым профилем — | | | и два процесса будут писать в одно место. Отказываемся. | | | if "$NEW" = 1 && is running "$ROOT"; then | | | echo "${C RED}Песочница запущена${C RST} — сначала останови её:" &2 | | | echo " ${C CYAN}pi-box --rm $ basename "$ROOT" ${C RST} или подключись: pi-box -a " &2 | | | exit 1 | | | fi | | | require pi | | | "$NEW" = 1 && rm -rf "$ROOT/$BOX DIRNAME" | | | box init "$ROOT" | | | pi монтируется в /pi целиком как каталог @earendil-works, поэтому путь к | | | cli.js повторяет его структуру. | | | PI="/pi/$PI BASENAME/dist/bundle/cli.js" | | | box bwrap "$ROOT" | | | ── один запрос ────────────────────────────────────────────────────────────── | | | Без bash -c: переменные и cwd ставятся самим bwrap. Через bash -c значение | | | с кавычкой или $ ... попадало в shell — проверено, PI BOX SESSION ID мог | | | выполнить произвольную команду. Теперь значения идут аргументами, не строкой. | | | if -n "$PROMPT" ; then | | | exec "${BW @ }" "$NODE BIN" "$PI" -p \ | | | --session-dir /box/sessions --session-id "$SESSION ID" "$PROMPT" | | | fi | | | ── интерактив ─────────────────────────────────────────────────────────────── | | | Через tmux: опции терминала надо выставить до создания панели, иначе панель | | | унаследует screen-256color и потеряет truecolor, а Shift+Enter — Enter. | | | | | | -c "$ROOT": каталог сессии, из него открываются новые окна prefix+c . | | | tmux-сервер живёт СНАРУЖИ bwrap, поэтому новые окна — обычные шеллы хоста, | | | и путь должен быть настоящим: /work существует только внутри песочницы. | | | SOCK=$ box socket "$ROOT" | | | mkdir -p "$ dirname "$SOCK" " | | | if is running "$ROOT"; then | | | -t 0 && exec tmux -S "$SOCK" attach -t "$TMUX NAME" | | | echo "${C GREEN}песочница${C RST} '${C B}$ basename "$ROOT" ${C RST}' уже запущена — ${C CYAN}pi-box -a${C RST}" | | | exit 0 | | | fi | | | tmux new-session возвращает 0 даже когда панель не поднялась проверено , | | | поэтому успех подтверждаем отдельной проверкой, а не кодом возврата. | | | tmux -S "$SOCK" -f "$ROOT/$BOX DIRNAME/tmp/tmux.conf" new-session -d -s "$TMUX NAME" -c "$ROOT" \ | | | "${BW @ }" "$NODE BIN" "$PI" \ | | | --session-dir /box/sessions --session-id "$SESSION ID" | | | if is running "$ROOT"; then | | | echo "${C RED}не удалось запустить песочницу${C RST}" &2 | | | echo "Проверь, что проект лежит в доступном каталоге; запусти без tmux:" &2 | | | echo " ${C CYAN}pi-box -p \"echo test\"${C RST}" &2 | | | exit 1 | | | fi | | | -t 0 && exec tmux -S "$SOCK" attach -t "$TMUX NAME" | | | echo "${C GREEN}песочница${C RST} '${C B}$ basename "$ROOT" ${C RST}' запущена — ${C CYAN}pi-box -a${C RST}" |