Bem-vindo ao Dropstone
O Dropstone é uma ferramenta de codificação agêntica que vive no seu terminal. Ele lê seu código, faz edições coordenadas entre arquivos, executa comandos e explica seu raciocínio enquanto trabalha.
Você descreve o que quer, e o Dropstone lê o código relevante, planeja a mudança, edita arquivos, executa comandos e explica o que fez. Ele trabalha em projetos reais, não em trechos de exemplo, e permanece fundamentado no código que você já tem.
Esta página dá a você a visão geral do produto. O Início Rápido mostra como instalá-lo e enviar sua primeira mudança.
Instale em segundos
Homebrew (recomendado):
brew tap blankline-org/dropstone-cli
brew install dropstone
Ou o script de instalação:
curl -fsSL https://dropstone.io/install | bash
Depois, entre em qualquer projeto:
cd /caminho/para/seu/projeto
dropstone
Verifique a instalação com dropstone --version. No primeiro uso, você será solicitado a fazer login; os detalhes completos de login estão na página Início Rápido.
O que você pode fazer
Entender um código
Criar funcionalidades e corrigir bugs
Executar, testar e verificar
Criar commits e pull requests
Conecte suas ferramentas com MCP
Personalize com regras e habilidades
AGENTS.md na raiz do repositório para ensinar suas convenções ao Dropstone. Empacote fluxos de trabalho reutilizáveis como habilidades.Componha com o shell
O Dropstone é um cidadão Unix. A sessão interativa é a superfície padrão, mas toda capacidade está disponível em uma invocação única, o que o torna utilizável em scripts de CI, hooks de pre-commit e seus próprios fluxos de trabalho.
# Uma única execução: faça uma pergunta e saia
dropstone run "Explique como o middleware de autenticação funciona"
# Envie um arquivo via pipe
dropstone run "Encontre problemas de segurança" < src/auth.ts
# Use em um pipeline de shell
git diff main | dropstone run "Escreva uma descrição de PR para este diff"
# Use no CI sem um TTY
dropstone run --json "Gere notas de versão a partir dos últimos 20 commits"
Como funciona
O Dropstone roda como um único binário no seu terminal. Nada para configurar, nenhum runtime para instalar — você o inicia dentro de um projeto e ele opera nos arquivos do seu diretório de trabalho. Se preferir tê-lo ao lado do seu código como um painel, também existe o Dropstone para VS Code.
Cada turno segue o mesmo ciclo:
Você descreve a tarefa em linguagem simples
Sem sintaxe especial. "Adicione um endpoint /healthz que retorne informações de build" é suficiente.
O Dropstone reúne contexto
Ele lê arquivos, busca por símbolos e inspeciona a estrutura até ter informações suficientes para agir.
Ele propõe e executa um plano
As edições são mostradas como diffs. Comandos de shell pedem permissão, a menos que você os tenha colocado na lista de permitidos.
Ele verifica o resultado
Verificações de tipo, testes e lints rodam automaticamente quando existem. Falhas voltam para o plano.
Toda a interação permanece no seu terminal. Seu código nunca é enviado a lugar nenhum, exceto para a inferência do próprio Dropstone, que é operada sob uma política de não retenção e não treinamento. Veja a página Trust para detalhes.
Use o Dropstone em qualquer lugar
| Eu quero… | Melhor opção |
|---|---|
| Iniciar uma sessão de codificação interativa | Execute dropstone no diretório do seu projeto |
| Fazer uma pergunta pontual sem uma sessão | dropstone run "..." ou envie um arquivo via pipe com < |
| Retomar a última sessão | dropstone --continue (ou dropstone -c) |
| Integrar uma ferramenta personalizada ou API interna | Servidores MCP |
| Ensinar as convenções do seu repositório ao Dropstone | Coloque um AGENTS.md na raiz do repositório |
| Empacotar um fluxo de trabalho reutilizável | Habilidades e Plugins |
| Usar o Dropstone em CI ou pre-commit | dropstone run com --json e o modelo de permissões |
| Escolher o nível de modelo certo para a tarefa | Modelos (Fast / Pro / Heavy) |
| Executar dentro de um sandbox ou shell restrito | Permissões |
Construído em torno de três níveis de modelo
Você escolhe o modelo que se adequa ao trabalho. Todos os três são hospedados em infraestrutura nos EUA e ajustados para codificação.
Dropstone Fast
Dropstone Pro
/effort high.Dropstone Heavy
/effort xhigh.Dica:
Você não precisa pensar na seleção de modelo antecipadamente. Comece no Fast e use /effort de dentro do Dropstone para subir de nível quando uma tarefa precisar de mais profundidade.
Para onde ir em seguida
Comece a usar
O Início Rápido cobre instalação, login e sua primeira tarefa.
Escolha um nível de modelo
Modelos aprofunda em Fast, Pro e Heavy, e quando usar cada um.
Configure ao seu gosto
Configuração cobre configurações globais e por projeto; Permissões e Atalhos de teclado cobrem o resto.
Veja o que há de novo
O Changelog lista cada versão com as mudanças visíveis ao usuário.
Depois de configurado, a referência da CLI e o guia de comandos de barra são as duas páginas às quais você voltará com mais frequência.
Construindo um agente ou aplicativo de LLM que precisa ler estes documentos? Aponte-o para /llms.txt para um índice do site, ou /llms-full.txt para o corpus completo em um único arquivo.