Dropstone Docs

Sessão interativa

Como trabalhar dentro de uma sessão Dropstone. Referências de arquivos, escapes de shell, comandos de barra e integração com editor.

Dropstone é executado como uma sessão interativa no seu terminal. Cada sessão está vinculada ao diretório de onde você a iniciou, mantém o histórico de conversas e permanece aberta até você sair. Esta página cobre como conduzir uma sessão: como referenciar arquivos, executar comandos de shell, usar comandos de barra e conectar um editor externo.

Iniciar uma sessão

Execute dropstone dentro de um projeto:

dropstone

Ou aponte para um diretório específico:

dropstone /path/to/project

Quando Dropstone estiver ativo, digite qualquer prompt em linguagem natural:

Give me a quick summary of the codebase.

Referências de arquivos

Referencie arquivos em suas mensagens com @. Isso faz uma busca difusa no diretório de trabalho atual.

How is auth handled in @src/api/index.ts?

O conteúdo do arquivo é adicionado automaticamente à conversa, para que o agente possa lê-lo sem precisar fazer grep primeiro.

Comandos de shell

Comece uma mensagem com ! para executar um comando de shell. A saída é adicionada à conversa como um resultado de ferramenta para que o agente possa reagir a ela.

!ls -la

!git diff

Comandos de barra

Digite / seguido de um nome de comando para executar uma ação rápida. A maioria tem um atalho de teclado usando ctrl+x como a tecla líder (configurável via Keybindings).

/help

compact

Compacta a sessão atual. O contexto mais antigo é resumido para que o trabalho mais recente tenha espaço. Alias: /summarize.

Keybind: ctrl+x c

details

Alterna se os detalhes de execução da ferramenta são mostrados inline.

editor

Abre seu editor externo para compor uma mensagem mais longa. Usa o editor definido em EDITOR. Veja Editor setup.

Keybind: ctrl+x e

effort

Ajusta a profundidade de raciocínio do modelo ativo. Abre um seletor com quatro níveis: low, medium, high, xhigh. Maior esforço produz raciocínio mais profundo ao custo de mais créditos e latência ligeiramente maior. Alias: /thinking.

exit

Sair do Dropstone. Aliases: /quit, /q.

Keybind: ctrl+x q

export

Exporta a conversa atual para Markdown e a abre no seu editor (usa EDITOR).

Keybind: ctrl+x x

help

Mostra o diálogo de ajuda com todos os comandos de barra e keybinds.

init

Configuração guiada para criar ou atualizar AGENTS.md. Veja Rules (AGENTS.md).

models

Lista os modelos disponíveis para esta sessão.

Keybind: ctrl+x m

new

Inicia uma nova sessão no diretório atual. Alias: /clear.

Keybind: ctrl+x n

redo

Refaz uma mensagem desfeita anteriormente. Disponível apenas após /undo. As alterações de arquivo são restauradas como parte do redo.

Requer Git:

Undo e redo usam Git para gerenciar snapshots de estado de arquivo, então seu projeto deve ser um repositório Git.

Keybind: ctrl+x r

sessions

Lista e alterna entre sessões. Aliases: /resume, /continue.

Keybind: ctrl+x l

undo

Desfaz a última mensagem na conversa. Remove a mensagem do usuário mais recente, todas as respostas subsequentes e quaisquer alterações de arquivo feitas nessas rodadas.

Requer Git:

Undo usa Git para reverter alterações de arquivo, então seu projeto deve ser um repositório Git.

Keybind: ctrl+x u

upgrade

Abre a página de preços do Dropstone para atualizar seu plano. Use isso quando precisar de mais créditos semanais ou acesso a camadas premium (Dropstone Pro, Dropstone Heavy).

Atualização de plano vs atualização de CLI:

/upgrade é a atualização de plano. Para atualizar o binário Dropstone CLI em si, execute dropstone update do seu shell.

usage

Mostra o consumo de créditos da semana atual, nome do plano, limite semanal e quando os créditos serão redefinidos.

Configuração do editor

Os comandos /editor e /export iniciam o editor na sua variável de ambiente EDITOR.

# Terminal editors
export EDITOR=nano
export EDITOR=vim

# GUI editors (VS Code, Cursor, VSCodium, Windsurf, Zed, etc.)
# require --wait so the editor process blocks until closed
export EDITOR="code --wait"

Para tornar isso permanente, adicione-o ao seu perfil de shell (~/.bashrc, ~/.zshrc, e assim por diante).

Opções populares:

  • code para Visual Studio Code
  • cursor para Cursor
  • windsurf para Windsurf
  • nvim para Neovim
  • vim para Vim
  • nano para Nano
  • subl para Sublime Text
  • notepad para Windows Notepad

A flag --wait:

Editores GUI como VS Code retornam imediatamente por padrão, o que pularia sua mensagem. A flag --wait faz o processo do editor bloquear até você fechar o arquivo, para que Dropstone possa ler o que você escreveu.

Personalização

Algumas preferências no nível de sessão vivem na paleta de comandos (Ctrl+P). Procure o que você quer mudar; a configuração é lembrada entre sessões.

  • Hide username: remove seu nome de usuário das mensagens de chat
  • Diff style: escolha entre adaptativo (padrão) e diffs empilhados em coluna única
  • Mouse capture: alterna se o terminal trata a seleção do mouse em si, ou Dropstone faz

Para tudo mais (keybinds, formatadores, formato de arquivo de configuração), veja as páginas dedicadas: Keybindings, Formatters, Configuration.

Privacidade e retenção de dados

Seus prompts, código e transcrições de conversas nunca são usados para treinar modelos e não são retidos além da vida útil da sua sessão. Dropstone usa cache de prompt com escopo de sessão para reduzir custo e latência, da mesma forma que Anthropic e OpenAI fazem: o conteúdo em cache é isolado para sua própria conta, expira automaticamente e nunca é reutilizado para nenhum outro usuário ou enviado para treinamento de modelo.

Esses controles são aplicados e revisados pela Blankline, empresa-mãe do Dropstone. O time de conformidade da Blankline audita o tratamento de dados do Dropstone regularmente e retém autoridade de revogação sobre o acesso de produção de qualquer indivíduo ou sistema que viole a política.

Veja a página Trust para a postura completa, incluindo divulgações de subprocessadores e o limite de segurança de tempo de execução.

Ctrl+I