AgentSync

AgentSync CLI и MCP

Установка, публикация конфигураций и работа с локальными снимками через командную строку.

Для чайников

Весь путь от нуля до рабочей конфигурации — по шагам. Каждый шаг ссылается на подробный раздел ниже.

  1. 1

    Установите CLI

    Скачайте и запустите установщик для своей системы. Команда появится в терминале.

    curl -fsSL https://zwarder.ru/api/install.sh | sh

    Подробности — в разделе Установка CLI.

  2. 2

    Войдите в аккаунт

    Без входа работают справка, версия и обновление программы. Почту можно указать сразу: agentsync login alice@example.com.

    agentsync login

    Подробности — в разделе Вход.

  3. 3

    Опубликуйте свою конфигурацию

    Отправьте настройку своего AI-агента на сервер, чтобы ею могли пользоваться другие. Grok в команде — пример имени.

    agentsync push Grok

    Подробности — в разделе Публикация.

  4. 4

    Делайте снимки перед изменениями

    Снимок — точка возврата. Создайте его перед любым рискованным действием.

    agentsync record Grok

    Подробности — в разделе Локальные снимки.

  5. 5

    Примените чужую публикацию

    Нашли интересную конфигурацию? Примените её по имени автора и агента. Author — пример имени автора.

    agentsync apply Author Grok

    Подробности — в разделе Применение.

  6. 6

    Установите нужные навыки

    Из любой публикации можно взять отдельные навыки и установить их в свой инструмент.

    agentsync skills Author Grok --version 4 --global --into cursor ru-text

    Подробности — в разделе Навыки.

Коротко: установили → вошли → опубликовали → сделали снимок → применили чужое → добавили навыки. Если что-то пошло не так — agentsync revert Grok вернёт последний снимок.

Установка CLI

CLI — отдельная программа для терминала. Установщик помещает её в ~/.agentsync и добавляет в PATH.

Перед запуском прочитайте установочный скрипт: он выполняет загруженный код на вашем компьютере.

Linux / macOS

curl -fsSL https://zwarder.ru/api/install.sh | sh

Windows · PowerShell

iwr https://zwarder.ru/api/install.ps1 -useb | iex

Откройте новый терминал после установки и проверьте доступность команды.

agentsync help

Обновление

agentsync update заменяет программу на сборку с того же адреса, что и установка. Копия в ~/.agentsync проверяет обновление сама, не чаще раза в сутки. AGENTSYNC_AUTO_UPDATE=0 выключает автоматическую проверку. agentsync update --check только показывает, есть ли другая сборка.

agentsync update
Исходные скрипты установки

Вход

Войдите перед публикацией. Укажите почту своего аккаунта; alice@example.com ниже — только пример.

agentsync login alice@example.com

Можно запустить agentsync login без почты. Сессия пишется в ~/.agentsync/session. Пароль на диск не записывается. Не публикуйте этот файл.

Публикация конфигурации

push отправляет переносимую конфигурацию выбранного AI-агента на сервер. Учётные данные в запрос не входят.

agentsync push Grok

В примерах используется Grok. Подставьте имя своего агента и проверьте файлы перед отправкой.

agentsync all публикует каждый найденный ИИ-агент. Папка подходит, если в ней сразу лежат навыки, правила, конфиг или AGENTS.md.

agentsync all

Локальные снимки

Сохранить текущее состояние

record сохраняет снимок в ~/.agentsync/store и на сервере. Публикацию эта команда не создаёт.

agentsync record Grok

Посмотреть сохранённые снимки

agentsync store Grok

Добавьте номер, чтобы посмотреть содержимое конкретного снимка.

agentsync store Grok 2

Вернуться к последнему снимку

agentsync revert Grok

Возврат изменяет текущие файлы конфигурации. Сначала сохраните важные изменения. Публикации на сервере не меняются.

Применение публикации

Передайте имя автора и AI-агента. Author — пример имени автора; замените его реальным.

agentsync apply Author Grok

apply заменяет текущую переносимую настройку файлами из публикации. Перед заменой текущая настройка записывается в снимок. Откат: agentsync revert Grok.

Установка отдельных навыков

skills копирует выбранные навыки из конкретной версии публикации в каталоги выбранных приёмников.

agentsync skills Author Grok --version 4 --global --into cursor ru-text
  • Author Grok — автор и агент.
  • --version 4 — номер опубликованной версии.
  • --global — глобальная установка; --project — установка для текущего проекта.
  • --into cursor — приёмник. Флаг повторяется для каждого приёмника.
  • ru-text — пример имени навыка; укажите имя из выбранной публикации.

Без --into и без --global или --project команда сначала спрашивает приёмников, затем место установки.

Справка по командам

Для подробностей передайте имя команды после help.

agentsync help push
agentsync help skills
Исходный проект AgentSync

MCP В разработке

Model Context Protocol — способ подключения инструментов к AI-клиентам. Готовой инструкции подключения на сайте пока нет.

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

Этот раздел зарезервирован для будущей документации MCP.