Visão geral
O Dropstone CLI é uma ferramenta de codificação agêntica que roda no seu terminal. Peça para ele ler código, executar comandos, planejar mudanças e editar arquivos, tudo a partir do seu shell.
O Dropstone é o caminho mais rápido para codificação agêntica se você vive no terminal. Esta página faz você instalar, entrar e chegar à sua primeira conversa.
Pré-requisitos
- Um emulador de terminal moderno. Qualquer um serve; testamos com WezTerm, Alacritty, Ghostty e Kitty.
- Uma conta Dropstone. Cadastre-se em dropstone.io para usar a linha de modelos integrada (Fast, Pro, Heavy).
Instalação
Homebrew (recomendado):
brew tap blankline-org/dropstone-cli
brew install dropstone
Ou o script de instalação:
curl -fsSL https://dropstone.io/install | bash
Ambos os métodos colocam um único binário dropstone no seu PATH. Sem Node, sem dependências de runtime.
Verifique a instalação:
dropstone --version
Entrar
Entre em qualquer diretório de projeto e inicie o Dropstone:
cd /caminho/para/seu/projeto
dropstone
No primeiro uso, você será solicitado a entrar. Duas opções:
- Continuar no navegador (recomendado). Abre dropstone.io/login, faz o login e devolve o token ao CLI automaticamente. Usa PKCE para que o token nunca apareça na barra de URL do seu navegador.
- Colar um token. Para sessões SSH ou headless. Obtenha um token em dropstone.io/account e cole-o.
Execute /login dentro do Dropstone para trocar de conta mais tarde.
Escolha um modelo
O Dropstone oferece três níveis de modelo. Todos são hospedados em infraestrutura nos EUA e ajustados para codificação.
| Nível | Melhor para |
|---|---|
| Fast | Edições rápidas, scaffolding, refatorações de arquivo único. O nível padrão. |
| Pro | Refatorações de múltiplos arquivos, mudanças transversais, raciocínio mais amplo. |
| Heavy | Decisões de arquitetura, migrações grandes, depuração ambígua ou com muita pesquisa. |
Troque de nível durante uma sessão com /effort low, /effort medium, /effort high ou /effort xhigh. Ctrl+T alterna entre eles. Veja Modelos para mais.
Inicialize um projeto
Dentro da raiz de um projeto, execute:
/init
O Dropstone escaneia a estrutura do seu projeto e cria um arquivo AGENTS.md na raiz do repositório. Faça commit dele no git: é aqui que você codifica as convenções do projeto, comandos de build e pegadinhas que o Dropstone deve conhecer em cada prompt.
Veja Regras (AGENTS.md) para o formato completo.
Primeira conversa
Você está pronto. Faça perguntas, solicite mudanças ou planeje funcionalidades.
Pergunte sobre o código
Como a autenticação é tratada em @src/auth/session.ts?
Use @ para pesquisar arquivos com busca difusa e fixá-los no prompt.
Planeje antes de construir
Pressione Tab para alternar para o Modo Plano. No Modo Plano, o Dropstone não pode editar arquivos; ele apenas descreve o que faria.
Adicione uma coluna "deleted_at" à tabela de notas. Depois crie uma tela que
liste notas excluídas recentemente com botões de restaurar e excluir permanentemente.
Itere no plano. Quando estiver satisfeito, pressione Tab novamente para voltar ao Modo Build e diga para ele executar.
Edições diretas
Para mudanças pequenas, pule o plano:
Adicione autenticação a /settings da mesma forma que é tratada em /notes.
Desfazer e refazer
/undo
/redo
/undo reverte o ciclo de edição anterior e reexibe seu prompt para que você possa ajustá-lo. Execute várias vezes para voltar ainda mais. /redo reproduz uma etapa desfeita.
Uso e limites
Digite /usage para ver seu uso semanal, nível do plano e contagem regressiva de reinício. Digite /upgrade para abrir a página de preços se quiser mais espaço.