Как установить, обновить и удалить appagent?

Коротко: на компьютере ставится bash scripts/install.sh, обновляется git pull плюс /reload-plugins, снимается bash scripts/uninstall.sh. Данные ваших проектов при удалении не стираются.

Требования: Node ≥ 20, Claude Code 2.1.28x (терминал или вкладка Code в Desktop).

Установка на компьютер

Из корня репозитория appagent:

bash scripts/install.sh --dry-run   # показать, что будет сделано, ничего не меняя
bash scripts/install.sh

Что меняется, и больше ничего:

  • ~/.claude/skills/orch — ссылка на каталог plugin/ репозитория (Claude Code грузит её как плагин);
  • ~/.local/bin/orch — ссылка на команду orch для терминала.

Затем в открытой сессии Claude Code выполните /reload-plugins, в проекте — /orch:init. Проверка установки: orch doctor или /orch:doctor (установщик запускает её сам; отключить — --no-doctor).

Необязательные опции (повторный запуск безопасен):

bash scripts/install.sh --statusline      # строка состояния appagent; прежний settings.json сохраняется копией settings.json.bak-orch-<время>
bash scripts/install.sh --explore-haiku   # дешёвая встроенная разведка (создаёт ~/.claude/agents/Explore.md, если его нет)
bash scripts/install.sh --marketplace     # через локальный маркетплейс veyro вместо ссылки
bash scripts/install.sh --help            # все опции; --force заменяет чужие statusLine и ~/.local/bin/orch (старое уходит в копию)

Ваши ~/.claude/settings.local.json, хуки и другие скиллы установщик не трогает.

Свой сервер

Если нужно, чтобы работа шла на облачном сервере, а задачи вы давали с телефона, — пошаговая инструкция в ../SERVER.md (комплект скриптов лежит в server/). Это необязательно: appagent полностью работает на одном компьютере. Страница про телефон — Телефон и статьи.

Обновление

git pull        # в репозитории appagent
/reload-plugins # в открытых сессиях Claude Code

При обычной установке (ссылка) и при --marketplace Claude Code читает плагин прямо из каталога plugin/, больше ничего делать не нужно. Команда claude plugin update orch@veyro ответит, что обновлять нечего, — это нормально.

Репозиторий переехал в другой каталог: повторите bash scripts/install.sh с теми же опциями уже из нового места.

Удаление

bash scripts/uninstall.sh --dry-run   # сначала посмотреть
bash scripts/uninstall.sh

Снимает ссылки ~/.claude/skills/orch и ~/.local/bin/orch. Дополнительные опции: --statusline (вернуть прежнюю строку состояния из копии), --marketplace (если ставили через маркетплейс), --explore-haiku (убрать созданный файл).

Не удаляются: ~/.claude/orch/ (события, кэш доски) и .orchestrator/ в ваших проектах — их можно удалить вручную.

Дальше: Быстрый старт.