CLI

Параметры и команды Dropstone CLI.

По умолчанию Dropstone CLI запускает интерактивную сессию при запуске без аргументов.

dropstone

Но он также принимает команды, как описано на этой странице. Это позволяет взаимодействовать с Dropstone программно.

dropstone run "Explain how closures work in JavaScript"

tui

Запускает интерактивную сессию Dropstone. Это поведение по умолчанию при запуске dropstone без подкоманды; dropstone tui — это явная форма.

dropstone [project]

Флаги

Флаг	Короткий	Описание
	`-c`	Продолжить последнюю сессию
	`-s`	ID сессии для продолжения
		Создать ответвление сессии при продолжении (используйте с `--continue` или `--session`)
		Используемый промпт
	`-m`	Используемая модель (`dropstone/dropstone-fast`, `dropstone/dropstone-pro` или `dropstone/dropstone-heavy`)
		Используемый агент
		Порт для прослушивания
		Имя хоста для прослушивания
		Включить обнаружение mDNS
		Пользовательское доменное имя mDNS
		Дополнительные источники браузера для разрешения CORS

Команды

Dropstone CLI также имеет следующие команды.

agent

Управление агентами для Dropstone.

dropstone agent [command]

create

Создать нового агента с пользовательской конфигурацией.

dropstone agent create

Эта команда проведет вас через создание нового агента с пользовательским системным промптом и конфигурацией разрешений. Все, что вы не разрешите, будет запрещено во frontmatter созданного агента.

Флаги

Флаг	Короткий	Описание
		Каталог для записи файла агента (по умолчанию глобальный или `.dropstone/agent` в зависимости от промпта)
		Что должен делать агент
		Режим агента: `all`, `primary` или `subagent`
		Список разрешений через запятую (по умолчанию: все). Доступно: `bash`, `read`, `edit`, `glob`, `grep`, `webfetch`, `task`, `todowrite`, `websearch`, `lsp`, `skill`. Все, что не указано, запрещено. Псевдоним: `--tools`
	`-m`	Используемая модель (`dropstone/dropstone-fast`, `dropstone/dropstone-pro` или `dropstone/dropstone-heavy`)

Передача всех --path, --description, --mode и --permissions запускает команду в неинтерактивном режиме.

list

Список всех доступных агентов.

dropstone agent list

attach

Подключить терминал к уже запущенному серверу Dropstone, запущенному через команды serve или web.

dropstone attach [url]

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

# На хост-машине запустите сервер
dropstone web --port 4096 --hostname 0.0.0.0

# На другой машине подключите сессию к нему
dropstone attach http://10.20.30.40:4096

Флаги

Флаг	Короткий	Описание
		Рабочий каталог для запуска сессии
	`-c`	Продолжить последнюю сессию
	`-s`	ID сессии для продолжения
		Создать ответвление сессии при продолжении (используйте с `--continue` или `--session`)
	`-p`	Пароль базовой аутентификации (по умолчанию `DROPSTONE_SERVER_PASSWORD`)
	`-u`	Имя пользователя базовой аутентификации (по умолчанию `DROPSTONE_SERVER_USERNAME` или `dropstone`)

auth

Команда для управления учетными данными и входом для провайдеров.

dropstone auth [command]

Используйте dropstone auth login для входа в Dropstone. Ваши учетные данные хранятся в ~/.local/share/dropstone/auth.json.

dropstone auth login

Dropstone читает учетные данные из этого файла при каждом запуске.

Флаги

Флаг	Короткий	Описание
	`-p`	ID или имя провайдера для входа
	`-m`	Метка метода входа для использования, пропуская выбор метода

list

Список всех аутентифицированных провайдеров, хранящихся в файле учетных данных.

dropstone auth list

Или короткая версия.

dropstone auth ls

logout

Выход из провайдера путем удаления его из файла учетных данных.

dropstone auth logout

github

Управление GitHub-агентом для автоматизации репозитория.

dropstone github [command]

install

Установить GitHub-агента в ваш репозиторий.

dropstone github install

Это настраивает необходимый workflow GitHub Actions и проведет вас через процесс конфигурации. Узнать больше.

run

Запустить GitHub-агента. Обычно используется в GitHub Actions.

dropstone github run

Флаги

Флаг	Описание
	Мок-событие GitHub для запуска агента
	Персональный токен доступа GitHub

mcp

Управление серверами Model Context Protocol.

dropstone mcp [command]

add

Добавить MCP-сервер в вашу конфигурацию.

dropstone mcp add

Эта команда проведет вас через добавление локального или удаленного MCP-сервера.

list

Список всех настроенных MCP-серверов и их статус подключения.

dropstone mcp list

Или используйте короткую версию.

dropstone mcp ls

auth

Аутентификация с MCP-сервером, поддерживающим OAuth.

dropstone mcp auth [name]

Если вы не укажете имя сервера, вам будет предложено выбрать из доступных серверов с поддержкой OAuth.

Вы также можете вывести список серверов с поддержкой OAuth и их статус аутентификации.

dropstone mcp auth list

Или используйте короткую версию.

dropstone mcp auth ls

logout

Удалить учетные данные OAuth для MCP-сервера.

dropstone mcp logout [name]

debug

Отладка проблем подключения OAuth для MCP-сервера.

dropstone mcp debug <name>

models

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

dropstone models

Вывод в формате dropstone/<tier>. Dropstone поставляется с тремя уровнями:

ID модели	Уровень	Лучше всего для
`dropstone/dropstone-fast`	Fast	Ежедневный драйвер по умолчанию. Быстрые правки, каркасы, отладка в диалоге.
`dropstone/dropstone-pro`	Pro	Рефакторинг нескольких файлов, сквозные изменения, более широкие рассуждения.
`dropstone/dropstone-heavy`	Heavy	Архитектурные решения, крупные миграции, сложная отладка.

См. Модели для полного описания и настройки модели по умолчанию.

Флаги

Флаг	Описание
	Обновить кэшированный список моделей
	Включить метаданные (контекстное окно, возможности)

run

Запустить dropstone в неинтерактивном режиме, передав промпт напрямую.

dropstone run [message..]

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

dropstone run Explain the use of context in Go

Вы также можете подключиться к запущенному экземпляру dropstone serve, чтобы избежать холодного запуска MCP-серверов при каждом запуске:

# Запустите headless-сервер в одном терминале
dropstone serve

# В другом терминале запустите команды, которые подключаются к нему
dropstone run --attach http://localhost:4096 "Explain async/await in JavaScript"

Флаги

Флаг	Короткий	Описание
		Команда для запуска, используйте сообщение для аргументов
	`-c`	Продолжить последнюю сессию
	`-s`	ID сессии для продолжения
		Создать ответвление сессии при продолжении (используйте с `--continue` или `--session`)
		Поделиться сессией
	`-m`	Используемая модель (`dropstone/dropstone-fast`, `dropstone/dropstone-pro` или `dropstone/dropstone-heavy`)
		Используемый агент
	`-f`	Файл(ы) для прикрепления к сообщению
		Формат: default (форматированный) или json (сырые JSON-события)
		Название сессии (используется усеченный промпт, если значение не указано)
		Подключиться к запущенному серверу dropstone (например, http://localhost:4096)
	`-p`	Пароль базовой аутентификации (по умолчанию `DROPSTONE_SERVER_PASSWORD`)
	`-u`	Имя пользователя базовой аутентификации (по умолчанию `DROPSTONE_SERVER_USERNAME` или `dropstone`)
		Каталог для запуска, или путь на удаленном сервере при подключении
		Порт для локального сервера (по умолчанию случайный порт)
		Вариант модели (усилия рассуждения, специфичные для провайдера)
		Показать блоки размышлений
		Автоматически одобрять разрешения, которые явно не запрещены (опасно!)

serve

Запустить headless-сервер Dropstone для доступа через API. Ознакомьтесь с документацией сервера для полного HTTP-интерфейса.

dropstone serve

Это запускает headless HTTP-сервер, который предоставляет программный доступ к Dropstone без открытия интерактивной сессии. Установите DROPSTONE_SERVER_PASSWORD, чтобы включить базовую HTTP-аутентификацию (имя пользователя по умолчанию — dropstone).

Флаги

Флаг	Описание
	Порт для прослушивания
	Имя хоста для прослушивания
	Включить обнаружение mDNS
	Пользовательское доменное имя mDNS
	Дополнительные источники браузера для разрешения CORS

session

Управление сессиями Dropstone.

dropstone session [command]

list

Список всех сессий Dropstone.

dropstone session list

Флаги

Флаг	Короткий	Описание
	`-n`	Ограничить N последними сессиями
		Формат вывода: table или json (table)

delete

Удалить сессию Dropstone.

dropstone session delete <sessionID>

stats

Показать статистику использования токенов и затрат для ваших сессий Dropstone.

dropstone stats

Флаги

Флаг	Описание
	Показать статистику за последние N дней (все время)
	Количество инструментов для отображения (все)
	Показать разбивку использования моделей (скрыто по умолчанию). Передайте число для показа топ-N
	Фильтр по проекту (все проекты, пустая строка: текущий проект)

export

Экспорт данных сессии в формате JSON.

dropstone export [sessionID]

Если вы не укажете ID сессии, вам будет предложено выбрать из доступных сессий.

Флаги

Флаг	Описание
	Скрыть конфиденциальные данные транскрипта/файлов

import

Импорт данных сессии из JSON-файла или URL-адреса общего доступа Dropstone.

dropstone import <file>

Вы можете импортировать из локального файла или URL-адреса общего доступа Dropstone.

dropstone import session.json
dropstone import https://dropstone.io/s/abc123

web

Запустить headless-сервер Dropstone с веб-интерфейсом.

dropstone web

Это запускает HTTP-сервер и открывает веб-браузер для доступа к Dropstone через веб-интерфейс. Установите DROPSTONE_SERVER_PASSWORD, чтобы включить базовую HTTP-аутентификацию (имя пользователя по умолчанию — dropstone).

Флаги

Флаг	Описание
	Порт для прослушивания
	Имя хоста для прослушивания
	Включить обнаружение mDNS
	Пользовательское доменное имя mDNS
	Дополнительные источники браузера для разрешения CORS

acp

Запустить сервер ACP (Agent Client Protocol).

dropstone acp

Эта команда запускает сервер ACP, который общается через stdin/stdout с использованием nd-JSON.

Флаги

Флаг	Описание
	Рабочий каталог
	Порт для прослушивания
	Имя хоста для прослушивания
	Включить обнаружение mDNS
	Пользовательское доменное имя mDNS
	Дополнительные источники браузера для разрешения CORS

plugin

Установить плагин и обновить вашу конфигурацию.

dropstone plugin <module>

Или используйте псевдоним.

dropstone plug <module>

Флаги

Флаг	Короткий	Описание
	`-g`	Установить в глобальную конфигурацию
	`-f`	Заменить существующую версию плагина

pr

Получить и переключиться на ветку GitHub PR, затем запустить Dropstone.

dropstone pr <number>

db

Инструменты базы данных.

dropstone db [query]

Флаги

Флаг	Описание
	Формат вывода: `json` или `tsv`

path

Вывести путь к базе данных.

dropstone db path

debug

Инструменты отладки и устранения неполадок.

dropstone debug [command]

uninstall

Удалить Dropstone и все связанные файлы.

dropstone uninstall

Флаги

Флаг	Короткий	Описание
	`-c`	Сохранить файлы конфигурации
	`-d`	Сохранить данные сессий и снимки
		Показать, что будет удалено, без удаления
	`-f`	Пропустить запросы подтверждения

upgrade

Обновляет Dropstone CLI до последней версии или конкретной версии. dropstone update — это псевдоним и ведет себя идентично.

dropstone upgrade [target]
# или
dropstone update [target]

Для обновления до последней версии:

dropstone upgrade

Для установки конкретной версии:

dropstone upgrade 1.0.5

На Windows, если Dropstone в данный момент запущен, установщик подготавливает новую сборку как dropstone.exe.pending. Новая версия активируется автоматически при следующем запуске: ручное перемещение файлов не требуется.

Флаги

Флаг	Короткий	Описание
	`-m`	Метод установки: `curl`, `npm`, `pnpm`, `bun`, `brew`, `scoop`, `choco`

Глобальные флаги

CLI dropstone принимает следующие глобальные флаги.

Флаг	Короткий	Описание
	`-h`	Показать справку
	`-v`	Вывести номер версии
		Вывести логи в stderr
		Уровень логирования (DEBUG, INFO, WARN, ERROR)
		Запуск без внешних плагинов

Переменные окружения

Dropstone читает следующие переменные окружения при запуске. Это поддерживаемые пользовательские переменные; все, что не указано здесь, является внутренним и может быть изменено или удалено без уведомления.

Переменная	Тип	Описание
`DROPSTONE_API_KEY`	string	API-ключ Dropstone для headless / CI использования (пропускает вход через браузер)
`DROPSTONE_CONFIG`	string	Путь к файлу конфигурации `dropstone.json`
`DROPSTONE_TUI_CONFIG`	string	Путь к файлу конфигурации сессии (`tui.json`)
`DROPSTONE_DISABLE_AUTOUPDATE`	boolean	Отключить автоматические проверки обновлений CLI
`DROPSTONE_GIT_BASH_PATH`	string	Путь к Git Bash на Windows (используется как инструмент оболочки)
`DROPSTONE_SERVER_PASSWORD`	string	Включить базовую HTTP-аутентификацию на `dropstone serve` / `dropstone web`
`DROPSTONE_SERVER_USERNAME`	string	Переопределить имя пользователя базовой аутентификации (по умолчанию `dropstone`)

Core concepts

Interactive session

CLI

tui

Флаги

Команды

agent

create

Флаги

list

attach

Флаги

auth

login

Флаги

list

logout

github

install

run

Флаги

mcp

add

list

auth

logout

debug

models

Флаги

run

Флаги

serve

Флаги

session

list

Флаги

delete

stats

Флаги

export

Флаги

import

web

Флаги

acp

Флаги

plugin

Флаги

pr

db

Флаги

path

debug

uninstall

Флаги

upgrade

Флаги

Глобальные флаги

Переменные окружения

На этой странице