CraftDesk CLI

Управление зависимостями для AI-возможностей — устанавливайте, управляйте и версионируйте навыки, агенты, команды, хуки и плагины для Claude Code.

Интерфейс командной строки для управления AI-инструментами разработки. По аналогии с npm для JavaScript или Bundler для Ruby, CraftDesk CLI предоставляет полноценное решение для управления пакетами AI-инструментов.

Что такое CraftDesk?

CraftDesk — менеджер пакетов для AI-возможностей, используемых в Claude Code и других AI-средах разработки. Позволяет:

• Устанавливать AI-навыки, агенты, команды, хуки, плагины и коллекции из git-репозиториев или реестров
• Коллекции — формировать и распространять группы связанных крафтов, работающих вместе
• Система плагинов — объединять несколько крафтов с автоматическим разрешением зависимостей
• Синхронизация между агентами — делиться навыками между несколькими AI-ассистентами (Claude, Cursor, Windsurf и др.)
• Фиксировать версии для воспроизводимых окружений в командах
• Управлять зависимостями с автоматической рекурсивной установкой
• Поддерживать монорепозитории с извлечением поддиректорий
• Автоматически конвертировать GitHub URL — вставляйте любой GitHub URL (tree/blob)
• Прямые ссылки на файлы — устанавливать отдельные файлы из репозиториев
• Интеграция с настройками — автоматическая регистрация в .claude/settings.json
• Поддержка MCP-серверов — настройка серверов Model Context Protocol через плагины

Аналогии:

• npm для Node.js → CraftDesk для AI-возможностей
• Bundler для Ruby → CraftDesk для инструментов Claude
• Cargo для Rust → CraftDesk для AI-агентов

Примечание: Сервер самостоятельно размещаемого реестра находится в разработке и скоро будет доступен — он обеспечит поддержку приватных реестров и централизованное распространение крафтов.

Быстрый старт

Установка CraftDesk

Проверка установки:

craftdesk --version
# x.y.z

Требования: Node.js >= 18.0.0, Git, npm или yarn

1. Инициализация нового проекта

mkdir my-ai-project
cd my-ai-project
craftdesk init

Создаётся файл craftdesk.json:

{
  "name": "my-ai-project",
  "version": "1.0.0",
  "type": "skill",
  "dependencies": {}
}

2. Добавление зависимостей

# Добавить отдельный файл навыка с GitHub (автоматически конвертирует веб-URL)
craftdesk add https://github.com/aviflombaum/rspec-rails-agents/blob/main/rspec-dry-agent.md

# Добавить из git-репозитория
craftdesk add git+https://github.com/aviflombaum/rspec-rails-agents.git

# Добавить из поддиректории монорепозитория
craftdesk add https://github.com/technicalpickles/pickled-claude-plugins/tree/main/plugins/working-in-monorepos/skills/working-in-monorepos

# Добавить с явным указанием типа
craftdesk add https://github.com/aviflombaum/rspec-rails-agents/blob/main/rspec-dry-agent.md --type agent

3. Установка всех зависимостей

Устанавливает все зависимости в директорию .claude/ и создаёт craftdesk.lock.

4. Просмотр установленных крафтов

Вывод:

Содержание

• Что такое CraftDesk?
• Быстрый старт
• Основные концепции
  • Крафты
  • Коллекции
• Система плагинов
• Справочник команд
  • init
  • install
  • add
  • remove
  • list
  • search
  • info
  • outdated
  • update
  • publish
• Встроенные/локальные навыки
  • embed
  • unembed
• Аутентификация
  • login
  • logout
  • whoami
• Источники зависимостей
• Поддержка монорепозиториев
• Справочник craftdesk.json
• craftdesk.lock
• Интеграция с CI/CD
• Устранение неполадок
• Разработка
• Документация

Основные концепции

Крафты

Крафт — любая AI-возможность:

• Skill (навык) — область знаний (например, ruby-on-rails, postgres-expert)
• Agent (агент) — автономный исполнитель задач (например, code-reviewer, test-runner)
• Command (команда) — слэш-команда (например, /deploy, /analyze)
• Hook (хук) — обработчик событий (например, pre-commit, post-install)
• Plugin (плагин) — набор нескольких крафтов с зависимостями и конфигурацией MCP-сервера
• Collection (коллекция) — курируемая группа связанных крафтов, работающих вместе (например, rails-enterprise-stack)

Конвертация форматов

Конвертируйте крафты CraftDesk в форматы других AI-редакторов для кросс-платформенного использования.

Поддерживаемые форматы:

• Cursor — современный формат .mdc в директории .cursor/rules/
• Cursor Legacy — формат .cursorrules в виде простого текста
• Continue.dev — файлы промптов и правил в .continue/prompts/ и .continue/rules/

Зачем конвертировать форматы?

• Использование любого AI-редактора — пишите один раз, разворачивайте в Cursor, Continue, Windsurf и др.
• Гибкость для команды — разработчики могут использовать предпочитаемые редакторы
• Максимальный охват — распространяйте крафты более широкой аудитории
• Отсутствие привязки — не зависите от единственной платформы

Базовое использование:

# Конвертировать крафт в формат Cursor
craftdesk convert ./my-craft --to cursor

# Конвертировать в формат Continue.dev
craftdesk convert ./my-craft --to continue