Обзор
Dropstone CLI — это агентный инструмент для программирования, который работает в вашем терминале. Попросите его читать код, выполнять команды, планировать изменения и редактировать файлы — всё прямо из вашей оболочки.
Dropstone — это самый быстрый путь к агентному программированию, если вы живёте в терминале. Эта страница поможет вам установить его, войти в систему и начать первый разговор.
Предварительные требования
- Современный эмулятор терминала. Подойдёт любой; мы тестируем WezTerm, Alacritty, Ghostty и Kitty.
- Учётная запись Dropstone. Зарегистрируйтесь на dropstone.io, чтобы использовать встроенный набор моделей (Fast, Pro, Heavy).
Установка
Homebrew (рекомендуется):
brew tap blankline-org/dropstone-cli
brew install dropstone
Или установочный скрипт:
curl -fsSL https://dropstone.io/install | bash
Оба способа помещают один бинарный файл dropstone в ваш PATH. Никакого Node, никаких зависимостей времени выполнения.
Проверьте установку:
dropstone --version
Вход в систему
Перейдите в каталог любого проекта и запустите Dropstone:
cd /path/to/your/project
dropstone
При первом запуске вам будет предложено войти в систему. Два варианта:
- Продолжить в браузере (рекомендуется). Открывает dropstone.io/login, выполняет вход и автоматически передаёт токен обратно в CLI. Используется PKCE, поэтому токен никогда не появляется в адресной строке вашего браузера.
- Вставить токен. Для SSH-сессий или сессий без графического интерфейса. Получите токен на dropstone.io/account и вставьте его.
Выполните /login внутри Dropstone, чтобы позже переключить учётную запись.
Выбор модели
Dropstone поставляется с тремя уровнями моделей. Все три размещены на инфраструктуре в США и настроены для программирования.
| Уровень | Лучше всего подходит для |
|---|---|
| Fast | Быстрые правки, создание каркасов, рефакторинг одного файла. Уровень по умолчанию. |
| Pro | Рефакторинг нескольких файлов, сквозные изменения, более широкие рассуждения. |
| Heavy | Архитектурные решения, крупные миграции, неоднозначная или исследовательская отладка. |
Переключайте уровни во время сессии с помощью /effort low, /effort medium, /effort high или /effort xhigh. Ctrl+T циклически переключает их. Подробнее см. в разделе Модели.
Инициализация проекта
В корне проекта выполните:
/init
Dropstone сканирует структуру вашего проекта и создаёт файл AGENTS.md в корне репозитория. Закоммитьте его в git: здесь вы кодируете соглашения проекта, команды сборки и подводные камни, которые Dropstone должен знать при каждом запросе.
Полный формат см. в разделе Правила (AGENTS.md).
Первый разговор
Вы готовы. Задавайте вопросы, запрашивайте изменения или планируйте функции.
Вопросы о коде
How is authentication handled in @src/auth/session.ts?
Используйте @ для нечёткого поиска файлов и закрепления их в запросе.
Планирование перед созданием
Нажмите Tab, чтобы переключиться в режим плана. В режиме плана Dropstone не может редактировать файлы; он только описывает, что бы он сделал.
Add a "deleted_at" column to the notes table. Then build a screen that
lists recently deleted notes with restore and permanent-delete buttons.
Дорабатывайте план. Когда вы довольны, нажмите Tab ещё раз, чтобы вернуться в режим сборки, и скажите ему действовать.
Прямые правки
Для небольших изменений пропустите план:
Add auth to /settings the same way it is handled in /notes.
Отмена и повтор
/undo
/redo
/undo отменяет предыдущий цикл правок и повторно отображает ваш запрос, чтобы вы могли его изменить. Выполняйте его несколько раз, чтобы откатиться дальше. /redo повторяет отменённый шаг.
Использование и лимиты
Введите /usage, чтобы увидеть еженедельное использование, уровень плана и обратный отсчёт до сброса. Введите /upgrade, чтобы открыть страницу с ценами, если вам нужно больше ресурсов.