Собрать →
Импорт: клиенты → Hub. Соберите описания MCP, полные наборы файлов навыков или выбранные знания из Markdown. Секреты MCP остаются в локальном .env.
При импорте настройки клиентов не меняются.Локально. Прозрачно. Под вашим контролем.
Ваши агенты.
Общие инструменты.
Один Hub.
Общий локальный Hub для Claude Code, Codex CLI и DeepSeek Harness. Сначала соберите MCP, навыки и общие инструкции. Подключайте память и контекст отдельных проектов, когда они понадобятся.
01 / разобраться02 / проверить03 / применить
ВАША ЛОКАЛЬНАЯ СРЕДАСХЕМА 01
✳Claude Code~/.claude.json
⌘Codex CLI~/.codex/config.toml
d.DeepSeek Harnessвыбранный профиль DSH
Agent Hubинструменты, контекст и память
ЛОКАЛЬНО
описания инструментовссылки на секретывосстановление
Запустите ahub quick из любой папки. Путь к проекту не нужен.
СЕЙЧАС В ФОКУСЕИнструменты + контекст + памятьClaude CodeCodex CLIDeepSeek HarnessЧто уже работает ↗
01 / ОБЩАЯ КАРТИНА
Настройте один раз.
Понимайте каждый шаг.
По умолчанию общий Hub находится в ~/.agent-hub. Он управляет инструментами, навыками и общими инструкциями клиентов. Проект — отдельный Git-репозиторий; его память подключается по желанию.
Сравнить →
Перед применением проверьте добавления, замены, конфликты, выбранный проект и затронутые пути. План покажет доставку настроек или импорт памяти.
Quick объединяет сбор и доставку. Отдельные операции доступны в расширенной справке.Применить ↗
Доставка: Hub → клиенты. Подтверждённый актуальный план записывает изменения и резервные копии. MCP использует общий запускатель, навыки — ссылки, инструкции — управляемые блоки.
После применения перезапустите затронутых клиентов. Память и hooks проекта подключаются отдельным планом project connect.Впервые слышите о MCP? Начните здесь.
MCP — протокол подключения ИИ-клиентов к внешним инструментам и данным, например поиску по документации или задачам. MCP-сервер предоставляет эти возможности, а Claude, Codex или DSH использует их. Hub управляет настройками подключения и запуском. Модели, диалоги и внешние сервисы остаются отдельными.
02 / ПАМЯТЬ МЕЖДУ КЛИЕНТАМИ
Знания сохраняются
при смене клиента.
Claude, Codex и DSH могут читать одинаковые факты проекта из Hub через MCP или CLI. Общие знания — отдельная явно включаемая область. Нативные заметки остаются по исходным путям.
Найдите существующее
Обнаружьте папки памяти клиентов и сведения об их проектах. Проверьте выбранный импорт: факты внутри MEMORY.md учитываются, чистая локальная навигация пропускается. Для неясного источника проект выбирается явно.
Читайте актуальную коллекцию
Клиенты обращаются к одним записям Hub. Изменение через Hub видно другому клиенту при следующем чтении. Знания в уже открытом контексте диалога не обновляются незаметно.
Сохраняйте знания после задачи
Включённый lifecycle hook просит активного агента создать один подтверждённый checkpoint либо пустое подтверждение. Используется текущий агент; возможно дополнительное продолжение модели. Запись зависит от разрешений клиента.
Что происходит автоматически?
- При установленных hooks и включённой политике проекта SessionStart импортирует нативные изменения и передаёт ограниченный индекс проекта.
- Stop снова импортирует нативные изменения, затем запрашивает один смысловой checkpoint. Одноразовый токен сессии защищает от повторяющихся циклов извлечения.
- Необязательный watcher в активном терминале импортирует изменения файлов между сессиями. Фоновая служба ОС не устанавливается.
Что всё ещё требует проверенного плана?
- Для общих MCP, навыков и инструкций используйте ahub quick. Память проекта подключается отдельно.
- Ahub project connect показывает план памяти, файлов контекста и hooks проекта. Отдельная memory onboard --follow только прикрепляет источники; memory auto enable устанавливает hooks.
- Ручные записи памяти и разрешение конфликтов используют preview/apply. Несовместимые изменения источника или Hub остаются видимыми конфликтами.
Поддерживаемые источники и ограничения
Поиск и импорт Markdown доступны. Нативные SQLite-хранилища обнаруживаются, но не импортируются. Структурированный обмен графовой памятью и импорт архивных диалогов пока отсутствуют. Hub не зеркалирует записи обратно во все нативные хранилища. Пользу выбранных моделью фактов нужно оценить в рабочем испытании: тесты протокола её не доказывают.
03 / ПРОВЕРЬТЕ ПЕРЕД ПРИМЕНЕНИЕМ
Никаких скрытых шагов.
Посмотрите результат.
Переключайте примеры, чтобы увидеть, как Hub объясняет разные ситуации.
Интерактивная иллюстрация с вымышленными данными. Сайт не запускает команды и не получает доступ к вашему компьютеру.
$
Симуляция · реальные файлы не меняются
04 / ПЕРВЫЙ ЗАПУСК
Один сценарий.
Работающий Hub.
Установите CLI один раз и запустите ahub quick из любой папки. Для общего Hub не нужен Git-проект или workspace. Память проекта — отдельный необязательный шаг. Нужны Node.js ≥22.13, npm и настроенный клиент; целевые платформы — macOS и Linux.
Исходники на GitHubБета-кандидат 0.1.0-beta.1 · исходники 871894b. Публичного релиза в npm пока нет.
Релизы, пакеты и контрольные суммы →Установите ahub один раз
Откройте терминал в распакованной папке agent-hub.
npm ci
npm run install:globalПроверьте план общего Hub
Запустите из любой папки. Путь и предварительный init не нужны.
ahub quickПодтвердите план и используйте клиентов
Подтвердите проверенный план в терминале, затем посмотрите результат. Для скриптов неинтерактивный preview выводит точную команду применения.
ahub status
ahub doctorПредпочитаете интерфейс?
Общий Hub можно настроить из любой папки.
ahub uiПодключите память нужного проекта
Сделайте это после настройки общего Hub. Путь указывает на Git-проект, а не на папку Hub.
ahub project connect /path/to/projectОтмените запуск настройки
Проверьте состояние до запуска и подтвердите откат в терминале. Для скриптов и явного preview сохраняются отдельные параметры.
ahub undo05 / НАЗНАЧЕНИЕ КОМАНД
Что делает команда.
Что вы получите.
Начните с основных команд. Отдельно доступны расширенные операции и интеграции клиентов. Для каждой команды указаны назначение, пользователь и последствия.
Большинству пользователей достаточно quick и ui. Память проекта подключается по желанию. Status показывает настройки, doctor проверяет реальные подключения.
06 / НА ВАШЕМ ДИСКЕ
Ваши настройки.
Обычные файлы.
Hub находится в ~/.agent-hub. Задайте AGENT_HUB_HOME, чтобы выбрать другую папку. Пути клиентов и профиль DSH тоже настраиваются.
В реестре хранится ссылка вида ${DOCS_API_TOKEN}. Само значение находится в локальном .env и подставляется при запуске MCP.
Как выглядит запуск после синхронизации?
Вместо скопированных токенов клиент хранит вызов Node → Hub CLI → mcp run name и AGENT_HUB_HOME. Запускатель читает реестр и .env. STDIO-серверы запускаются напрямую, HTTP/SSE — через транспортный мост. Hub и CLI должны оставаться по настроенным путям. Память использует отдельный процесс memory serve, привязанный к проекту и работающий с тем же локальным хранилищем. Изменения нативных заметок попадают в Hub при событии клиента, ручном импорте или сканировании watcher.
~/.agent-hub/ ЛОКАЛЬНАЯ ФАЙЛОВАЯ СИСТЕМА
hub.yamlклиенты, пути и настройкиmcp/servers.yamlобщие описания MCP
.envсекреты · права 0600
state/владение, копии, диагностикаskills/ · memory/навыки, знания и привязки источников
~/.agent-hub.recovery/baseline и архивы · вне Hub
Данные восстановления могут содержать секреты. Права доступа ограничены, но файлы не зашифрованы. Не загружайте эту папку в Git или на сайт.
07 / ОБРАТНЫЙ ПУТЬ
Можно вернуться назад.
Выберите куда.
Сначала показывается план. Применение требует явного подтверждения и проверки актуальности. Undo отменяет запуск настройки; ниже — расширенные варианты восстановления.
ОДНА ОПЕРАЦИЯ НАЗАД ↶
restore
Отмените конкретную управляемую операцию синхронизации, контента или памяти по её backup ID.
node dist/cli.js restore <backup-id> --dry-run- Восстановите соответствующие файлы, индекс памяти и привязки источников этой операции.
- Более поздние правки могут заблокировать старую резервную копию.
- После применения перезапустите затронутых клиентов.
ПЕРВОЕ СОХРАНЁННОЕ СОСТОЯНИЕ ↺
reset
Верните Hub и сохранённые настройки клиентов к исходному baseline.
node dist/cli.js reset --dry-run- При применении текущее состояние сначала архивируется.
- Если Hub изначально не существовал, его папка снова будет отсутствовать.
- Если Hub уже существовал, восстановится сохранённый снимок.
Состояние «до первого запуска» можно вернуть, только если оно было действительно сохранено.
Baseline создаётся перед первой управляемой записью. Если Hub существовал до появления восстановления, его неизвестное прошлое восстановить нельзя. Без baseline reset откажется продолжать; preview не создаёт исходное состояние задним числом.
Внешние изменения, блокировки и прерванный reset
Ручные изменения файла клиента или его прав блокируют reset. Предпросмотр с --archive-changes предлагает архивировать текущий файл, а затем полностью восстановить исходный. Это не слияние. Перенаправленная символьная ссылка остаётся причиной блокировки.
Hub использует внешнюю блокировку операций и журнал восстановления для прерванных записей. --recover-lock работает только при доказанно завершившемся процессе-владельце; активные и неизвестные владельцы защищены. Ошибка ввода-вывода запускает попытку компенсирующего отката. Если и она не удалась, сохранённые архивы нужны для ручного восстановления.
Не запускайте reset одновременно с активными клиентами или другими версиями Hub. Общей транзакции с гарантией при отключении питания нет. Полное сохранение ACL, xattrs, идентичности hardlink и произвольных специальных файлов не обещается. Reset не удаляет CLI, не очищает npm cache и не отменяет внешние API-операции.
Откат управляемой памяти и полный reset отзывают ожидающие разрешения на checkpoint. Восстановленные старые токены нельзя использовать повторно; новый запрос пользователя может создать новый checkpoint. Импорт памяти не переписывает исходные нативные заметки.
08 / ТЕКУЩИЕ ВОЗМОЖНОСТИ
Ясно о настоящем.
Честно о будущем.
Agent Hub развивается. Эта страница описывает конкретный снимок исходников, а не список пожеланий.
| Область | Сейчас | Граница реализации |
|---|---|---|
| MCP | Доступно | Импорт, общий запускатель, синхронизация, диагностика, резервные копии и восстановление. |
| Навыки | Доступно | Просмотр, добавление, удаление, импорт из клиентов и доставка ссылок на оригиналы с резервными копиями. Доступны обнаружение и просмотр SKILL.md. |
| Общие инструкции | Доступно | Доставка общих правил и индекса через управляемые блоки с сохранением личного текста. |
| Память по областям | Доступно | Общие и проектные Markdown-записи через CLI, локальный UI и Memory MCP с привязкой к проекту; защищённые записи и восстановление. |
| Импорт существующей памяти | Доступно | Поиск Markdown-источников, проверка проекта и импорт выбранных знаний, включая факты внутри MEMORY.md. SQLite обнаруживается, но не импортируется. |
| Автоматизация проекта | Доступно | Включённые lifecycle hooks, защита конфликтов источников, один смысловой checkpoint на ход пользователя и необязательный watcher в активном терминале. Фоновая служба не устанавливается. |
| Внешняя графовая память | В планах | Структурированный обмен графами и их живое зеркалирование не реализованы. Импорт архивных диалогов также пока отсутствует. |
| Репозитории и задачи | Доступно | Просмотр текущего проекта и проверяемая настройка init-repo. Существующие заметки о задачах сохраняются; запуска агентов нет. |
| Сессии | В планах | Индекс сессий, поиск и перенос истории пока не реализованы. |
| Дополнительные команды CLI | Заглушки | mcp add/rm остаются явными заглушками и скрыты из справки. |
09 / ЕЩЁ НЕСКОЛЬКО ОТВЕТОВ
Разберёмся
в деталях.
Понятные объяснения для начинающих. Границы возможностей и поведение при сбоях — для опытных пользователей.
Как быстрее всего получить готовый Hub?
В распакованных исходниках выполните npm ci и npm run install:global. Затем из любой папки запустите ahub quick или откройте ahub ui. В терминале проверьте план и подтвердите его; перезапустите затронутых клиентов. Память проекта подключается отдельным project connect. Учить команды импорта, синхронизации и hooks для начала не требуется.
Для создания Hub нужен workspace?
Нет. Ahub quick настраивает общий Hub без проекта или Git-репозитория. Обычно Hub находится в ~/.agent-hub. Папка проекта нужна только отдельному ahub project connect: он ограничивает знания проектом и готовит файлы передачи контекста. Это не путь к хранилищу Hub.
Это замена Claude, Codex или DSH?
Нет. Продолжайте пользоваться своими клиентами. Hub управляет MCP-настройками и показывает различия. Он не предоставляет модель, подписку или перенос диалогов.
Этот сайт и есть локальный интерфейс?
Сайт — руководство с вымышленной демонстрацией. Он не читает ваши файлы. Команда ui запускает отдельное локальное приложение с настоящими данными и операциями на вашем компьютере.
Что будет с моими ручными настройками?
Синхронизация сохраняет посторонние MCP-записи, прочие настройки и политики инструментов Codex. Различающиеся описания требуют решения. Удаление из реестра убирает только неизменённую клиентскую запись, которой ранее управлял Hub. Проверьте весь план. Операции навыков сохраняют посторонние элементы и копии заменяемых эквивалентных файлов. Общий контекст меняет только свой блок; подготовка проекта сохраняет заметки.
Почему doctor успешен, а инструмент всё ещё не работает?
Успешный MCP handshake означает, что прошли инициализация и получение списка инструментов. Doctor не вызывает tools/call. Внешний сервис, права для конкретной операции или данные всё ещё могут быть недоступны. Необязательные проверки готовности различают некоторые из этих случаев, но не заменяют проверку реального API-действия.
Что мешает применить устаревший план?
Ревизия в --expect проверяет входные данные перед записью. После изменения файла нужен новый preview. В локальном UI планы также одноразовые и истекают через пять минут. Блокировки и атомарная замена отдельных файлов уменьшают гонки, но не образуют транзакцию всего компьютера.
Нужно отправлять секреты в облако?
Основная работа Hub локальная: реестр и .env находятся на вашем компьютере. Настроенные процессы MCP и endpoints обращаются к своим сервисам согласно вашим настройкам. Личные резервные копии и восстановление могут содержать незашифрованные секреты — не публикуйте их. Локальный UI не отдаёт исходный .env и защищает операции записи.
Можно выбрать свои папки и профили?
Да. Hub: AGENT_HUB_HOME. Claude: CLAUDE_CONFIG_DIR или AGENT_HUB_CLAUDE_CONFIG. Codex: CODEX_HOME. DSH: DSH_HOME и AGENT_HUB_DSH_PROFILE либо профиль в hub.yaml. Общие навыки: AGENT_HUB_SHARED_SKILLS. После изменения путей запустите status и новый preview.
Есть автоматическая синхронизация или облачная учётная запись?
После настройки проекта память может работать автоматически: импорт нативных заметок на SessionStart/Stop и один смысловой checkpoint через активного агента. Watcher в активном терминале может сканировать файлы между сессиями. Доставка MCP, навыков и инструкций всё ещё требует явного проверенного плана. Фоновая служба ОС и облачная синхронизация не устанавливаются.
Существующая память клиентов импортируется в Hub?
Да, для выбранных Markdown-источников. Memory discover показывает пути, формат и сведения о проекте; memory onboard предварительно показывает импорт заметок. Факты внутри MEMORY.md сохраняются, чистая локальная навигация пропускается, оригиналы не меняются. Неясная область требует явного выбора источника. Адаптеров импорта нативного SQLite и графовых хранилищ пока нет.
Что если Claude и DSH изменят один факт?
Hub хранит привязки источников и сравнивает ревизии записей. Неизменённая управляемая запись может обновиться. Несовпадающий дубликат из другого источника или вручную изменённая либо удалённая запись Hub попадает в очередь конфликтов. Сравните версии, проверьте план сохранения Hub или принятия входящего значения, затем примените его. История входящих версий сохраняется.
Нужна другая модель или база памяти?
Дополнительная модель для этой функции не запускается. Главным хранилищем служат Markdown-записи Hub; Memory MCP предоставляет тот же сервис. Stop hook просит агента текущего диалога выбрать подтверждённые полезные знания. Это может добавить продолжение модели и подчиняется разрешениям клиента. Контекст, уже утраченный агентом, так не восстанавливается.
Чем отслеживание источника отличается от включения hooks?
Отслеживание прикрепляет источник к включённой политике импорта проекта. Оно не устанавливает callbacks клиента. Уже установленные обработчики могут начать работать с этой политикой; иначе проверьте memory auto enable для каждого клиента или запустите watcher для импорта файлов. Одно подключение MCP не устанавливает lifecycle hooks и не гарантирует использование памяти агентом.
СЛЕДУЮЩИЙ ШАГ — ПРОСТО ПОСМОТРЕТЬ