Добро пожаловать в Dropstone
Dropstone — это агентный инструмент для написания кода, который живет в вашем терминале. Он читает вашу кодовую базу, вносит согласованные правки в файлы, выполняет команды и объясняет свои рассуждения по ходу работы.
Вы описываете, что хотите получить, а Dropstone читает релевантный код, планирует изменение, редактирует файлы, выполняет команды и объясняет, что он сделал. Он работает с реальными проектами, а не с игрушечными примерами, и всегда опирается на код, который уже есть у вас.
Эта страница дает общее представление о продукте. Быстрый старт проведет вас через установку и первое изменение.
Установка за секунды
Homebrew (рекомендуется):
brew tap blankline-org/dropstone-cli
brew install dropstone
Или установочный скрипт:
curl -fsSL https://dropstone.io/install | bash
Затем перейдите в любой проект:
cd /path/to/your/project
dropstone
Проверьте установку с помощью dropstone --version. При первом запуске вам будет предложено войти в систему; подробности входа описаны на странице Быстрый старт.
Что вы можете делать
Понимать кодовую базу
Создавать функции и исправлять баги
Запускать, тестировать и проверять
Создавать коммиты и pull request'ы
Подключать свои инструменты через MCP
Настраивать с помощью правил и навыков
AGENTS.md в корень репозитория, чтобы обучить Dropstone вашим конвенциям. Упаковывайте переиспользуемые рабочие процессы как навыки.Работайте с шеллом
Dropstone — гражданин Unix. Интерактивная сессия — это интерфейс по умолчанию, но каждая возможность доступна и через разовый вызов, что делает его скриптуемым в CI, pre-commit хуках и ваших собственных рабочих процессах.
# Разовый вызов: задайте вопрос и выйдите
dropstone run "Explain how the auth middleware works"
# Передать файл через stdin
dropstone run "Find security issues" < src/auth.ts
# Использовать в конвейере шелла
git diff main | dropstone run "Write a PR description for this diff"
# Запускать из CI без TTY
dropstone run --json "Generate release notes from the last 20 commits"
Как это работает
Dropstone работает как один бинарный файл в вашем терминале. Ничего настраивать не нужно, рантайм устанавливать не требуется — вы запускаете его внутри проекта, и он работает с файлами в вашей рабочей директории. Если вы предпочитаете держать его рядом с кодом в виде панели, есть также Dropstone для VS Code.
Каждый шаг следует одному и тому же циклу:
Вы описываете задачу простым языком
Никакого специального синтаксиса. «Добавь эндпоинт /healthz, который возвращает информацию о сборке» — этого достаточно.
Dropstone собирает контекст
Он читает файлы, ищет символы и изучает структуру, пока не получит достаточно информации для действий.
Он предлагает и выполняет план
Правки показываются в виде диффов. Команды шелла запрашивают разрешение, если вы не добавили их в белый список.
Он проверяет результат
Проверки типов, тесты и линтеры запускаются автоматически, если они существуют. Ошибки возвращаются в план.
Все взаимодействие остается в вашем терминале. Ваш код никуда не отправляется, кроме собственного инференса Dropstone, который работает по политике без хранения и без обучения. Подробности — на странице Trust.
Используйте Dropstone везде
| Я хочу… | Лучший вариант |
|---|---|
| Начать интерактивную сессию кодинга | Запустите dropstone в директории вашего проекта |
| Задать разовый вопрос без сессии | dropstone run "..." или передайте файл через < |
| Возобновить последнюю сессию | dropstone --continue (или dropstone -c) |
| Подключить кастомный инструмент или внутренний API | MCP-серверы |
| Научить Dropstone конвенциям вашего репозитория | Положите AGENTS.md в корень репозитория |
| Упаковать переиспользуемый рабочий процесс | Навыки и Плагины |
| Использовать Dropstone в CI или pre-commit | dropstone run с --json и моделью разрешений |
| Выбрать правильный уровень модели для задачи | Модели (Fast / Pro / Heavy) |
| Работать в песочнице или ограниченном шелле | Разрешения |
Три уровня моделей в основе
Вы выбираете модель, которая подходит под задачу. Все три размещены на инфраструктуре в США и настроены для кодинга.
Dropstone Fast
Dropstone Pro
/effort high.Dropstone Heavy
/effort xhigh.Совет:
Вам не нужно думать о выборе модели заранее. Начните с Fast и используйте /effort внутри Dropstone, чтобы повысить уровень, когда задача требует большей глубины.
Куда двигаться дальше
Начните работу
Быстрый старт охватывает установку, вход в систему и вашу первую задачу.
Выберите уровень модели
Модели подробнее рассказывают о Fast, Pro и Heavy и о том, когда к какой обращаться.
Настройте под себя
Конфигурация охватывает глобальные и проектные настройки; Разрешения и Горячие клавиши — остальное.
Посмотрите, что нового
Журнал изменений перечисляет каждый релиз с видимыми пользователю изменениями.
После настройки справочник CLI и руководство по слэш-командам — это две страницы, к которым вы будете возвращаться чаще всего.
Строите агента или LLM-приложение, которому нужно читать эти документы? Укажите ему на /llms.txt для индекса сайта или на /llms-full.txt для полного корпуса в одном файле.