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

Установите 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 вместо колбэков

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

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

Ревью кода

просмотри мои staged изменения и укажи на все рискованное

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

обнови инструкции по установке в 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