Краткое руководство

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

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

Перед началом работы

Вам понадобится:

Терминал или командная строка
Проект на диске, на который можно указать Dropstone (любой язык, любого размера)
Учетная запись Dropstone, которую можно создать на dropstone.io

Шаг 1: Установите Dropstone

Выберите способ установки для вашей платформы.

Homebrew (рекомендуется):

brew tap blankline-org/dropstone-cli
brew install dropstone

Или установочный скрипт:

curl -fsSL https://dropstone.io/install | bash

Оба способа устанавливают один бинарный файл dropstone в ваш PATH. Никакого Node, никаких зависимостей времени выполнения.

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

dropstone --version

Вы должны увидеть номер версии (текущий релиз — 1.0.8). Бинарный файл проверяет наличие обновлений при запуске и устанавливает их, так что вы остаетесь в курсе без повторного запуска установщика. Если вы установили через Homebrew, используйте brew upgrade dropstone — Homebrew владеет этим бинарным файлом, и Dropstone не будет его трогать.

Шаг 2: Войдите в систему

Перейдите в любой каталог проекта и запустите Dropstone:

cd /path/to/your/project
dropstone

При первом запуске вам будет предложено войти в систему. Два варианта:

Продолжить в браузере (рекомендуется). Открывает dropstone.io/login, выполняет вход и автоматически передает токен обратно в CLI. Использует PKCE, поэтому токен никогда не появляется в адресной строке браузера.
Вставить токен. Для SSH-сессий или сессий без графического интерфейса. Получите токен на dropstone.io/account и вставьте его.

Ваши учетные данные сохраняются на диске после первого входа. Чтобы позже переключить учетную запись, выполните /login внутри Dropstone.

Шаг 3: Начните первую сессию

Теперь вы видите главный экран Dropstone. Обратите внимание на три вещи:

Ваш текущий уровень модели показан в правом верхнем углу (по умолчанию: Dropstone Fast)
Поле ввода внизу — это место, где вы печатаете
Слэш-команды начинаются с /. Попробуйте /help, чтобы увидеть их все

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

Шаг 4: Задайте первый вопрос

Позвольте Dropstone изучить проект за вас. Попробуйте один из этих запросов:

что делает этот проект?

какие основные точки входа?

объясни структуру папок

Dropstone будет читать файлы по мере необходимости и отвечать со ссылками на фактический код. Вам не нужно вставлять файлы или писать контекст вручную.

Вы также можете спросить Dropstone о самом себе:

что ты можешь делать в этом проекте?

какие команды тебе разрешено выполнять?

Шаг 5: Внесите первое изменение в код

Теперь опишите небольшое изменение. Для нового проекта попробуйте что-то низкорисковое:

добавь README с описанием проекта в один абзац

Для существующего проекта:

добавь проверку входных данных в функцию, которая создает пользователя

Dropstone будет:

Находить соответствующий файл
Показывать предлагаемое изменение в виде diff
Запрашивать ваше одобрение перед записью
Проверять результат (проверка типов, тесты, линтеры, если доступны)

Разрешения

Dropstone запрашивает одобрение при первом изменении файла или выполнении команды оболочки. Одобрите один раз, и та же операция в той же сессии будет выполняться без повторного запроса. Используйте /permissions, чтобы просмотреть или отозвать выданные разрешения.

Шаг 6: Работа с git

Dropstone рассматривает git как инструмент первого класса:

какие файлы я изменил?

закоммить мои изменения с описательным сообщением

создай ветку feature/health-endpoint и переключись на нее

покажи последние пять коммитов

помоги разрешить конфликт слияния в src/auth.ts

Для рабочих процессов уровня PR (открытие pull request, генерация описаний PR, публикация комментариев к ревью) см. интеграцию с GitHub.

Шаг 7: Исправьте ошибку или добавьте функцию

Опишите, что вы хотите, простым языком. Dropstone найдет код, поймет контекст, реализует изменение и проверит его.

есть ошибка: пустые поисковые запросы возвращают все результаты — исправь это

добавь эндпоинт /healthz на API-сервер, который возвращает информацию о сборке

форма входа падает, когда email отсутствует — разберись, почему, и исправь

Если задача затрагивает несколько файлов, Dropstone составит короткий план и выполнит его шаг за шагом. Вы можете нажать Esc в любой момент, чтобы прервать и направить процесс.

Шаг 8: Попробуйте другие типовые рабочие процессы

Несколько паттернов, в которых Dropstone особенно хорош:

Рефакторинг

отрефактори модуль аутентификации, чтобы использовать async/await вместо колбэков

Написание тестов

напиши модульные тесты для функций калькулятора

Ревью кода

просмотри мои подготовленные изменения и укажи на все рискованное

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

обнови инструкции по установке в README, включив путь через WSL

Tip

Общайтесь с Dropstone как с коллегой. Описывайте, чего хотите достичь, а не точные шаги для этого. Агент лучше всего планирует, когда вы оставляете выбор реализации ему.

Основные команды

Несколько команд, которые вы действительно будете использовать:

Команда	Что делает	Пример
`dropstone`	Запускает интерактивную сессию в текущем каталоге	`dropstone`
`dropstone run "задача"`	Выполняет разовую задачу и завершает работу	`dropstone run "объясни auth.ts"`
`dropstone -c`	Продолжает последнюю сессию в этом каталоге	`dropstone -c`
`dropstone --session ID`	Возобновляет конкретную сессию по идентификатору	`dropstone --session 7f3a...`
`/help`	Показывает все слэш-команды	внутри сессии
`/effort`	Переключает уровень модели для этой сессии	`/effort high`
`/clear`	Очищает текущий разговор	внутри сессии
`/login`	Переключает учетные записи	внутри сессии
`exit` или `Ctrl+D`	Выход из Dropstone

Полный справочник — на страницах CLI и слэш-команды.

Советы для новых пользователей

Что дальше

Справочник CLI

Каждый флаг, каждая подкоманда, каждая опция. Страница, которую вы добавите в закладки.

Слэш-команды

Все слэш-команды в одном месте. Пригодится после недели использования.

Научите Dropstone вашему репозиторию (AGENTS.md)

Положите файл в корень репозитория, который расскажет Dropstone о ваших соглашениях, командах сборки и подводных камнях.

Подключите свои инструменты (MCP)

Подключите базы данных, внутренние API, системы тикетов или что угодно, что говорит на Model Context Protocol.

Модели и провайдеры

Подробнее о Fast 1.6, Pro 1.6 и Heavy 1.6, а также о том, как задать значение по умолчанию в конфигурации.

Разрешения

Точно контролируйте, что Dropstone может читать, записывать и выполнять в ваших проектах.

Получение помощи

Внутри Dropstone введите /help или задайте вопрос на естественном языке («как переключить модели?»)
Просмотрите остальную документацию на docs.dropstone.io
Сообщите об ошибке или запросите функцию на dropstone.io/contact

Overview

Pricing