Документация

Быстрый старт: один общий Hub

Agent Hub управляет общими MCP, навыками и инструкциями Claude Code, Codex CLI и DeepSeek Harness. Начните с общего Hub: путь к проекту и Git-репозиторий не нужны. Память и передача контекста проекта подключаются отдельно по желанию.

Установите CLI один раз

Нужны Node.js 22.13 или новее, npm и хотя бы один настроенный клиент. Для памяти и файлов контекста проекта нужен Git. Скачайте и распакуйте исходники, затем выполните в их папке:

npm ci
npm run install:global
ahub --help

Кандидат 0.1.0-beta.1 распространяется как проверенные архивы исходников и пакета. Пакет остаётся закрытым для защиты от случайной публикации; npm install --global agent-hub из публичного реестра не предлагается как способ установки. Запустите npm run install:global из исходников: команда соберёт и установит самостоятельную копию с зафиксированными production-зависимостями. После этого ahub работает из любой папки; agent-hub — равнозначное имя. Установка tarball, контрольные суммы и условия публикации описаны в RELEASE.md. Оба способа могут скачивать зафиксированные зависимости из npm.

Исходники после установки можно удалить. Node и установленный пакет должны оставаться по стабильным путям: запускатели и hooks привязаны к установленной среде. Если оболочка не находит ahub, проверьте npm prefix --global и добавьте каталог исполняемых файлов в PATH: на macOS/Linux это <prefix>/bin. При нехватке прав используйте доступный пользователю npm prefix или менеджер версий Node.

Для обновления снова выполните npm ci и npm run install:global из нужной ревизии, затем проверьте новый план quick. npm uninstall --global agent-hub удаляет исполняемые файлы CLI, но не данные Hub и клиентов. Если хотите восстановить оригиналы, выполните проверенный reset до удаления CLI.

Настройте общий Hub

Из любой папки:

ahub quick

Сначала показывается план. В интерактивном терминале затем запрашивается подтверждение именно этого плана. Отказ ничего не записывает. --dry-run, --json и неинтерактивный запуск только показывают preview. План включает обнаруженных включённых клиентов, сбор MCP и полных навыков, доставку существующих общих правил и индекса, конфликты и область клиентов. Текущий Git-проект не изучается; файлы, память и hooks проекта не создаются.

По умолчанию Hub находится в ~/.agent-hub. Это общее хранилище настроек и знаний, а не папка проекта. Другой путь задаётся через AGENT_HUB_HOME.

Quick и project connect спрашивают подтверждение, когда stdin и stdout — терминалы. Совместимый флаг --interactive остаётся доступен, но несовместим с apply, JSON и dry-run. В скрипте копируйте полную команду Apply this workflow из preview: она содержит --apply, --expect и --at. Не придумывайте ревизию и не убирайте параметры. В созданных командах намеренно зафиксированы пути Node и CLI; обычный ручной вызов использует ahub. После изменения входов нужен новый план.

После применения прочитайте результат этапов и перезапустите клиентов. Их собственные разрешения и доверие сохраняются. Проверьте настройки и, при необходимости, реальные подключения:

ahub status
ahub doctor

status различает совпадение настроек, сохранённые проверки MCP, установку hooks и наблюдавшуюся активность памяти. Отсутствующая или устаревшая проверка не считается подтверждением. Даже пустой завершённый checkpoint не доказывает появление полезных фактов. doctor запускает настоящие MCP или подключается к endpoints для получения списка инструментов. Инструменты не вызываются, выключенный backend не запускается.

Что меняет каждая команда

Общие правила берутся из instructions/AGENTS.md, индекс — из memory/MEMORY.md. Пустые источники ничего не доставляют. Личные глобальные инструкции клиентов не импортируются в общие правила автоматически.

Необязательно: подключите проект

После настройки общего Hub подключите проект, если нужна его память и передача контекста:

ahub project connect /path/to/project

Путь указывает на Git-проект, а не на Hub. Внутри проекта ahub project connect использует текущий checkout. В отличие от quick, команда проверяет Git и требует готовый Hub. Проверьте область и примените её собственный план.

Существующая проверенная привязка используется повторно либо создаётся стабильный локальный ID. Замена Git-идентичности требует явного rebind. Заметки и инструкции сохраняются. Импортируются только подходящие проекту Markdown-источники выбранных клиентов. Неясные источники и SQLite требуют отдельной проверки; оригиналы остаются на месте.

По умолчанию подключение включает политику памяти проекта и устанавливает lifecycle hooks. Обработчики в настройках клиентов переиспользуются между проектами, но активируются только для подходящих привязки и политики. Они не разрешают обучение на всех проектах. Перезапустите клиентов и обработайте их запросы доверия. Смысловое извлечение использует текущую модель, которая может не найти полезных фактов. Отдельный Memory MCP необязателен и настраивается для фиксированного проекта; команды настройки не устанавливают его автоматически.

# Select clients for the shared Hub
ahub quick --client claude-code,codex

# Explicit source preference for ambiguous new imports
ahub quick --prefer codex

# Connect a project without enabling new automation
ahub project connect /path/to/project --no-automation

# Enable project memory for selected clients only
ahub project connect /path/to/project --client codex

В терминале эти основные сценарии показывают план и спрашивают перед записью. Для одного preview используйте --dry-run. Неинтерактивные вызовы применяются точной командой своего плана. --no-automation пропускает новое включение, но не выключает существующую политику. Для выключения используйте проверенную memory auto disable. Старая форма quick --workspace направляет к project connect; --no-project для обычного quick не нужен.

Предпочитаете локальный интерфейс?

ahub ui

Set up shared Hub работает из любой папки, даже до создания Hub. План касается только глобальных инструментов, навыков и общих инструкций.

Для проекта запустите ahub ui в его Git-папке и выберите Connect project memory на Overview либо Connect project memory & handoff на Repos & tasks. Отдельный план показывает путь и настройку hooks. Заголовок позволяет выбрать проверенный зарегистрированный проект, стартовую папку или общие знания. Произвольные пути из браузера не принимаются. Переключение сбрасывает планы настройки, контента и памяти. Preview одноразовый и истекает через пять минут. Локальный UI пока англоязычный.

Конфликты, повторные запуски и границы автоматизации

Ни одна команда настройки не подразумевает разрешение на overwrite, replacement или rebind. Существующие описания Hub остаются основными. Без --prefer неоднозначные новые MCP не импортируются, а разные копии навыков блокируют сбор. Поздние правки клиента не сливаются с Hub незаметно.

Для точного сбора начните с ahub import mcp --dry-run либо ahub import skills --dry-run. Оба импорта по умолчанию показывают план и применяются только с его точной ревизией --expect. Неявного победителя среди клиентов нет. В UI импорт тоже начинается с preview.

В карточке конфликтующего MCP или навыка выберите Use this client in Hub либо Use Hub in this client. Эти примеры CLI тоже показывают план одной записи:

ahub import mcp:demo --source codex --overwrite
ahub sync --client codex --only=demo --replace=demo
ahub import skills:demo --source codex --overwrite
ahub sync --area skills --client codex --only=demo --replace=demo

--only сохраняет остальные записи и их владение. Клиенты могут разделять одну физическую папку навыков: план перечисляет всех затронутых клиентов, а отключённые продолжают защищаться.

Заблокированная область или клиент не меняются; независимые этапы могут завершиться. При оставшихся проблемах результат — needs-review, код выхода CLI — 1. Проверяйте MCP через sync --client <id> --dry-run, навыки через import skills --dry-run / sync --area skills --dry-run, конфликты памяти через memory auto conflict.

Повторяйте quick для новых общих элементов и доставки Hub, а project connect — для настройки проекта. Неизменённые этапы не создают новых content-копий; каждый применённый сценарий сохраняет отдельный закрытый снимок запуска. Службы ОС не устанавливаются: MCP и навыки меняются по явному плану, включённые hooks памяти работают на событиях клиента. Для нативных заметок отдельно доступен watcher в активном терминале.

Восстановите состояние или начните заново

Это поэтапные сценарии, а не одна транзакция. Зависимые планы перестраиваются после предыдущих этапов; поздний сбой может оставить завершённые изменения. Каждый записывающий этап сохраняет проверки, блокировку и восстановление. Предварительный план области не является заранее вычисленным списком всех зависимых правок.

Большинство этапов выводят отдельные команды восстановления. Откатывайте зависимые операции в обратном порядке и проверяйте каждый план: поздние правки блокируют старые копии. Импорт MCP покрывается первым baseline, а не отдельным backup.

ahub reset --dry-run

Применяйте только выданную команду восстановления. Reset архивирует текущие данные и возвращает первый baseline, который может быть старше этого запуска. Для одного запуска используйте ahub undo. Для отключения проекта — ahub project disconnect <id>: знания и заметки сохранятся. Новый Hub можно вернуть к отсутствию, внешние пути — к исходным данным. О внешних правках и архивах читайте в восстановлении.

Для ручной проверки всех сценариев и изолированных сбоев используйте рабочее руководство.

Приостановите проект или отмените запуск настройки

ahub project disconnect <project-id>
ahub undo
ahub undo <run-id>

Undo и disconnect показывают план и спрашивают подтверждение в терминале. Явные dry run, JSON и pipe не пишут; применение требует выданной ревизии. Disconnect охватывает все checkout выбранного ID, выключает политику и удаляет ожидающие токены. Знания, привязки источников и файлы контекста сохраняются. Общие обработчики hooks остаются для других проектов. При повторном подключении Git-идентичность проверяется до использования сохранённых знаний.

Undo возвращает состояние перед записанным quick/project connect, в том числе частично завершённым. Позднейшие изменения Hub и затронутых внешних путей блокируют его. Текущие данные архивируются, независимый первый baseline остаётся. Снимки вне Hub содержат личные настройки и занимают место. Прерывание процесса до завершения метаданных требует ручной проверки или обычного preview reset.

Справка без перегрузки

ahub показывает шесть основных групп и два входа: quick или ui. ahub --advanced --help открывает специальные операции, ahub --advanced quick --help — технические параметры для созданных команд скриптов. Скрытые из краткой справки команды продолжают работать. Справочник объясняет пользователя и назначение каждой команды. Запускатели и callbacks клиентов отделены от обычной настройки.