CLI

Opções e comandos do Dropstone CLI.

O Dropstone CLI por padrão inicia uma sessão interativa quando executado sem argumentos.

dropstone

Mas também aceita comandos conforme documentado nesta página. Isso permite que você interaja com o Dropstone programaticamente.

dropstone run "Explique como closures funcionam em JavaScript"

tui

Inicie uma sessão interativa do Dropstone. Este é o padrão quando você executa dropstone sem subcomando; dropstone tui é a forma explícita.

dropstone [project]

Flags

Flag	Short	Descrição
	`-c`	Continuar a última sessão
	`-s`	ID da sessão para continuar
		Bifurcar a sessão ao continuar (use com `--continue` ou `--session`)
		Prompt a ser usado
	`-m`	Modelo a ser usado (`dropstone/dropstone-fast`, `dropstone/dropstone-pro` ou `dropstone/dropstone-heavy`)
		Agente a ser usado
		Porta para escutar
		Nome do host para escutar
		Habilitar descoberta mDNS
		Nome de domínio mDNS personalizado
		Origem(ns) adicional(is) do navegador para permitir CORS

Comandos

O Dropstone CLI também possui os seguintes comandos.

agent

Gerencie agentes para o Dropstone.

dropstone agent [command]

create

Crie um novo agente com configuração personalizada.

dropstone agent create

Este comando irá guiá-lo na criação de um novo agente com um prompt de sistema personalizado e configuração de permissões. Qualquer coisa que você não permitir será negada no frontmatter do agente gerado.

Flags

Flag	Short	Descrição
		Diretório para gravar o arquivo do agente (padrão: global ou `.dropstone/agent` com base no prompt)
		O que o agente deve fazer
		Modo do agente: `all`, `primary` ou `subagent`
		Lista separada por vírgulas de permissões a permitir (padrão: todas). Disponíveis: `bash`, `read`, `edit`, `glob`, `grep`, `webfetch`, `task`, `todowrite`, `websearch`, `lsp`, `skill`. Qualquer coisa omitida é negada. Alias: `--tools`
	`-m`	Modelo a ser usado (`dropstone/dropstone-fast`, `dropstone/dropstone-pro` ou `dropstone/dropstone-heavy`)

Passar todos os --path, --description, --mode e --permissions executa o comando de forma não interativa.

list

Liste todos os agentes disponíveis.

dropstone agent list

attach

Anexe um terminal a um servidor backend do Dropstone já em execução iniciado via comandos serve ou web.

dropstone attach [url]

Isso permite que você aponte uma sessão interativa para um servidor Dropstone em execução em outra máquina. Por exemplo:

# Na máquina host, inicie o servidor
dropstone web --port 4096 --hostname 0.0.0.0

# Em outra máquina, anexe uma sessão a ele
dropstone attach http://10.20.30.40:4096

Flags

Flag	Short	Descrição
		Diretório de trabalho para iniciar a sessão
	`-c`	Continuar a última sessão
	`-s`	ID da sessão para continuar
		Bifurcar a sessão ao continuar (use com `--continue` ou `--session`)
	`-p`	Senha de autenticação básica (padrão: `DROPSTONE_SERVER_PASSWORD`)
	`-u`	Nome de usuário de autenticação básica (padrão: `DROPSTONE_SERVER_USERNAME` ou `dropstone`)

auth

Comando para gerenciar credenciais e login para provedores.

dropstone auth [command]

Use dropstone auth login para entrar no Dropstone. Suas credenciais são armazenadas em ~/.local/share/dropstone/auth.json.

dropstone auth login

O Dropstone lê as credenciais deste arquivo a cada inicialização.

Flags

Flag	Short	Descrição
	`-p`	ID ou nome do provedor para fazer login
	`-m`	Rótulo do método de login a usar, pulando a seleção de método

list

Lista todos os provedores autenticados conforme armazenados no arquivo de credenciais.

dropstone auth list

Ou a versão curta.

dropstone auth ls

logout

Desconecta você de um provedor, limpando-o do arquivo de credenciais.

dropstone auth logout

github

Gerencie o agente GitHub para automação de repositórios.

dropstone github [command]

install

Instale o agente GitHub no seu repositório.

dropstone github install

Isso configura o fluxo de trabalho necessário do GitHub Actions e o guia pelo processo de configuração. Saiba mais.

run

Execute o agente GitHub. Isso é normalmente usado no GitHub Actions.

dropstone github run

Flags

Flag	Descrição
	Evento simulado do GitHub para executar o agente
	Token de acesso pessoal do GitHub

mcp

Gerencie servidores Model Context Protocol.

dropstone mcp [command]

add

Adicione um servidor MCP à sua configuração.

dropstone mcp add

Este comando irá guiá-lo na adição de um servidor MCP local ou remoto.

list

Liste todos os servidores MCP configurados e seu status de conexão.

dropstone mcp list

Ou use a versão curta.

dropstone mcp ls

auth

Autentique-se com um servidor MCP habilitado para OAuth.

dropstone mcp auth [name]

Se você não fornecer um nome de servidor, será solicitado a selecionar entre os servidores disponíveis com capacidade OAuth.

Você também pode listar servidores com capacidade OAuth e seu status de autenticação.

dropstone mcp auth list

Ou use a versão curta.

dropstone mcp auth ls

logout

Remova as credenciais OAuth para um servidor MCP.

dropstone mcp logout [name]

debug

Depure problemas de conexão OAuth para um servidor MCP.

dropstone mcp debug <name>

models

Liste os níveis de modelo do Dropstone disponíveis para sua conta.

dropstone models

A saída está no formato dropstone/<tier>. O Dropstone oferece três níveis:

Model ID	Nível	Melhor para
`dropstone/dropstone-fast`	Fast	Uso diário padrão. Edições rápidas, scaffolding, depuração conversacional.
`dropstone/dropstone-pro`	Pro	Refatorações de vários arquivos, mudanças transversais, raciocínio mais amplo.
`dropstone/dropstone-heavy`	Heavy	Decisões de arquitetura, migrações grandes, depuração difícil.

Veja Modelos para o detalhamento completo e como definir um padrão.

Flags

Flag	Descrição
	Atualizar a lista de modelos em cache
	Incluir metadados (janela de contexto, capacidades)

run

Execute o dropstone em modo não interativo passando um prompt diretamente.

dropstone run [message..]

Isso é útil para scripts, automação ou quando você quer uma resposta rápida sem abrir uma sessão interativa. Por exemplo:

dropstone run Explique o uso de contexto em Go

Você também pode anexar a uma instância dropstone serve em execução para evitar tempos de inicialização a frio do servidor MCP a cada execução:

# Inicie um servidor headless em um terminal
dropstone serve

# Em outro terminal, execute comandos que se anexam a ele
dropstone run --attach http://localhost:4096 "Explique async/await em JavaScript"

Flags

Flag	Short	Descrição
		O comando a executar, use message para argumentos
	`-c`	Continuar a última sessão
	`-s`	ID da sessão para continuar
		Bifurcar a sessão ao continuar (use com `--continue` ou `--session`)
		Compartilhar a sessão
	`-m`	Modelo a ser usado (`dropstone/dropstone-fast`, `dropstone/dropstone-pro` ou `dropstone/dropstone-heavy`)
		Agente a ser usado
	`-f`	Arquivo(s) para anexar à mensagem
		Formato: padrão (formatado) ou json (eventos JSON brutos)
		Título para a sessão (usa prompt truncado se nenhum valor for fornecido)
		Anexar a um servidor dropstone em execução (ex.: http://localhost:4096)
	`-p`	Senha de autenticação básica (padrão: `DROPSTONE_SERVER_PASSWORD`)
	`-u`	Nome de usuário de autenticação básica (padrão: `DROPSTONE_SERVER_USERNAME` ou `dropstone`)
		Diretório para executar, ou caminho no servidor remoto ao anexar
		Porta para o servidor local (padrão: porta aleatória)
		Variante do modelo (esforço de raciocínio específico do provedor)
		Mostrar blocos de pensamento
		Aprovar automaticamente permissões que não são explicitamente negadas (perigoso!)

serve

Inicie um servidor Dropstone headless para acesso via API. Confira a documentação do servidor para a interface HTTP completa.

dropstone serve

Isso inicia um servidor HTTP headless que fornece acesso programático ao Dropstone, sem abrir uma sessão interativa. Defina DROPSTONE_SERVER_PASSWORD para habilitar autenticação básica HTTP (o nome de usuário padrão é dropstone).

Flags

Flag	Descrição
	Porta para escutar
	Nome do host para escutar
	Habilitar descoberta mDNS
	Nome de domínio mDNS personalizado
	Origem(ns) adicional(is) do navegador para permitir CORS

session

Gerencie sessões do Dropstone.

dropstone session [command]

list

Liste todas as sessões do Dropstone.

dropstone session list

Flags

Flag	Short	Descrição
	`-n`	Limitar às N sessões mais recentes
		Formato de saída: table ou json (table)

delete

Exclua uma sessão do Dropstone.

dropstone session delete <sessionID>

stats

Mostre estatísticas de uso de tokens e custo para suas sessões do Dropstone.

dropstone stats

Flags

Flag	Descrição
	Mostrar estatísticas dos últimos N dias (todo o tempo)
	Número de ferramentas a mostrar (todas)
	Mostrar detalhamento de uso do modelo (oculto por padrão). Passe um número para mostrar os N principais
	Filtrar por projeto (todos os projetos, string vazia: projeto atual)

export

Exporte dados de sessão como JSON.

dropstone export [sessionID]

Se você não fornecer um ID de sessão, será solicitado a selecionar entre as sessões disponíveis.

Flags

Flag	Descrição
	Redigir dados sensíveis de transcrição/arquivo

import

Importe dados de sessão de um arquivo JSON ou URL de compartilhamento do Dropstone.

dropstone import <file>

Você pode importar de um arquivo local ou de uma URL de compartilhamento do Dropstone.

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

web

Inicie um servidor Dropstone headless com uma interface web.

dropstone web

Isso inicia um servidor HTTP e abre um navegador web para acessar o Dropstone através de uma interface web. Defina DROPSTONE_SERVER_PASSWORD para habilitar autenticação básica HTTP (o nome de usuário padrão é dropstone).

Flags

Flag	Descrição
	Porta para escutar
	Nome do host para escutar
	Habilitar descoberta mDNS
	Nome de domínio mDNS personalizado
	Origem(ns) adicional(is) do navegador para permitir CORS

acp

Inicie um servidor ACP (Agent Client Protocol).

dropstone acp

Este comando inicia um servidor ACP que se comunica via stdin/stdout usando nd-JSON.

Flags

Flag	Descrição
	Diretório de trabalho
	Porta para escutar
	Nome do host para escutar
	Habilitar descoberta mDNS
	Nome de domínio mDNS personalizado
	Origem(ns) adicional(is) do navegador para permitir CORS

plugin

Instale um plugin e atualize sua configuração.

dropstone plugin <module>

Ou use o alias.

dropstone plug <module>

Flags

Flag	Short	Descrição
	`-g`	Instalar na configuração global
	`-f`	Substituir a versão existente do plugin

pr

Busque e faça checkout de um branch de PR do GitHub e depois execute o Dropstone.

dropstone pr <number>

db

Ferramentas de banco de dados.

dropstone db [query]

Flags

Flag	Descrição
	Formato de saída: `json` ou `tsv`

path

Imprima o caminho do banco de dados.

dropstone db path

debug

Ferramentas de depuração e solução de problemas.

dropstone debug [command]

uninstall

Desinstale o Dropstone e remova todos os arquivos relacionados.

dropstone uninstall

Flags

Flag	Short	Descrição
	`-c`	Manter arquivos de configuração
	`-d`	Manter dados de sessão e snapshots
		Mostrar o que seria removido sem remover
	`-f`	Pular prompts de confirmação

upgrade

Atualiza o Dropstone CLI para a versão mais recente ou uma versão específica. dropstone update é um alias e se comporta de forma idêntica.

dropstone upgrade [target]
# ou
dropstone update [target]

Para atualizar para a versão mais recente:

dropstone upgrade

Para instalar uma versão específica:

dropstone upgrade 1.0.5

No Windows, se o Dropstone estiver em execução, o instalador prepara o novo build como dropstone.exe.pending. A nova versão é ativada automaticamente na próxima inicialização: nenhuma movimentação manual de arquivos é necessária.

Flags

Flag	Short	Descrição
	`-m`	O método de instalação a usar: `curl`, `npm`, `pnpm`, `bun`, `brew`, `scoop`, `choco`

Flags Globais

O CLI dropstone aceita as seguintes flags globais.

Flag	Short	Descrição
	`-h`	Exibir ajuda
	`-v`	Imprimir número da versão
		Imprimir logs em stderr
		Nível de log (DEBUG, INFO, WARN, ERROR)
		Executar sem plugins externos

Variáveis de ambiente

O Dropstone lê as seguintes variáveis de ambiente na inicialização. Estas são as variáveis suportadas voltadas ao usuário; qualquer coisa não listada aqui é interna e pode mudar ou ser removida sem aviso.

Variável	Tipo	Descrição
`DROPSTONE_API_KEY`	string	Chave de API do Dropstone para uso headless / CI (pula o login no navegador)
`DROPSTONE_CONFIG`	string	Caminho para um arquivo de configuração `dropstone.json`
`DROPSTONE_TUI_CONFIG`	string	Caminho para um arquivo de configuração de sessão (`tui.json`)
`DROPSTONE_DISABLE_AUTOUPDATE`	boolean	Desabilitar verificações automáticas de atualização do CLI
`DROPSTONE_GIT_BASH_PATH`	string	Caminho para o Git Bash no Windows (usado como ferramenta de shell)
`DROPSTONE_SERVER_PASSWORD`	string	Habilitar autenticação básica HTTP em `dropstone serve` / `dropstone web`
`DROPSTONE_SERVER_USERNAME`	string	Substituir o nome de usuário da autenticação básica (padrão `dropstone`)

Core concepts

Interactive session

CLI

tui

Flags

Comandos

agent

create

Flags

list

attach

Flags

auth

login

Flags

list

logout

github

install

run

Flags

mcp

add

list

auth

logout

debug

models

Flags

run

Flags

serve

Flags

session

list

Flags

delete

stats

Flags

export

Flags

import

web

Flags

acp

Flags

plugin

Flags

pr

db

Flags

path

debug

uninstall

Flags

upgrade

Flags

Flags Globais

Variáveis de ambiente

Nesta página