Обзор
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).
Первый диалог
Вы готовы. Задавайте вопросы, запрашивайте изменения или планируйте функции.
Вопросы о коде
Как обрабатывается аутентификация в @src/auth/session.ts?
Используйте @ для нечёткого поиска файлов и закрепления их в запросе.
Планирование перед созданием
Нажмите Tab, чтобы переключиться в режим плана. В режиме плана Dropstone не может редактировать файлы; он только описывает, что бы он сделал.
Добавь колонку "deleted_at" в таблицу notes. Затем создай экран,
который показывает недавно удалённые заметки с кнопками восстановления
и окончательного удаления.
Дорабатывайте план. Когда вы довольны, снова нажмите Tab, чтобы вернуться в режим сборки, и скажите ему приступать.
Прямые правки
Для небольших изменений пропустите план:
Добавь аутентификацию в /settings так же, как она обрабатывается в /notes.
Отмена и повтор
/undo
/redo
/undo отменяет предыдущий цикл правок и снова показывает ваш запрос, чтобы вы могли его скорректировать. Выполняйте несколько раз, чтобы откатиться дальше. /redo повторяет отменённый шаг.
Использование и лимиты
Введите /usage, чтобы увидеть еженедельное использование, ваш тарифный план и обратный отсчёт до сброса. Введите /upgrade, чтобы открыть страницу с ценами, если вам нужно больше ресурсов.