Início Rápido
Instale o Dropstone, faça login e envie sua primeira alteração em menos de cinco minutos. Este guia leva você do zero a um loop de agente funcional.
Ao final deste guia, você terá o Dropstone instalado, conectado e produzindo edições reais em um projeto de sua escolha.
Antes de começar
Você precisa de:
- Um terminal ou prompt de comando
- Um projeto no disco para apontar o Dropstone (qualquer linguagem, qualquer tamanho)
- Uma conta Dropstone, que você pode criar em dropstone.io
Passo 1: Instale o Dropstone
Escolha o caminho de instalação para sua plataforma.
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 instalam um único binário dropstone no seu PATH. Sem Node, sem dependências de runtime.
Verifique a instalação:
dropstone --version
Você deve ver um número de versão (a versão atual é 1.0.8). O binário se atualiza automaticamente em segundo plano, então você fica sempre atualizado sem precisar executar o instalador novamente.
Passo 2: Faça login
Entre em qualquer diretório de projeto e inicie o Dropstone:
cd /caminho/para/seu/projeto
dropstone
Na primeira execução, você será solicitado a fazer login. 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 navegador.
- Colar um token. Para sessões SSH ou headless. Obtenha um token em dropstone.io/account e cole-o.
Suas credenciais são armazenadas no disco após o primeiro login. Para trocar de conta mais tarde, execute /login dentro do Dropstone.
Passo 3: Inicie sua primeira sessão
Você agora está olhando para a tela inicial do Dropstone. Três coisas para notar:
- Seu nível de modelo atual é exibido no canto superior direito (padrão: Dropstone Fast)
- A caixa de entrada na parte inferior é onde você digita
- Comandos de barra começam com
/. Tente/helppara ver todos
Digite qualquer prompt em linguagem natural para iniciar uma sessão. Não há sintaxe especial para aprender.
Passo 4: Faça sua primeira pergunta
Deixe o Dropstone explorar o projeto por você. Tente um destes:
o que este projeto faz?
quais são os principais pontos de entrada?
explique a estrutura de pastas
O Dropstone lerá arquivos sob demanda e responderá com citações ao código real. Você não precisa colar arquivos ou escrever contexto manualmente.
Você também pode perguntar sobre o próprio Dropstone:
o que você pode fazer neste projeto?
quais comandos você tem permissão para executar?
Passo 5: Faça sua primeira alteração de código
Agora descreva uma pequena alteração. Para um projeto novo, tente algo de baixo risco:
adicione um README com uma descrição de projeto em um parágrafo
Para um projeto existente:
adicione validação de entrada à função que cria um usuário
O Dropstone irá:
- Encontrar o arquivo relevante
- Mostrar a alteração proposta como um diff
- Pedir sua aprovação antes de escrever
- Verificar o resultado (type checks, testes, lints se disponíveis)
Permissões:
O Dropstone pede aprovação na primeira vez que deseja editar um arquivo ou executar um comando de shell. Aprove uma vez, e a mesma operação na mesma sessão será executada sem novas solicitações. Use /permissions para visualizar ou revogar o que você permitiu.
Passo 6: Trabalhe com git
O Dropstone trata o git como uma ferramenta de primeira classe:
quais arquivos eu alterei?
faça commit das minhas alterações com uma mensagem descritiva
crie uma branch chamada feature/health-endpoint e mude para ela
mostre os últimos cinco commits
ajude-me a resolver o conflito de merge em src/auth.ts
Para fluxos de trabalho em nível de PR (abrir pull requests, gerar descrições de PR, postar comentários de revisão), veja Integração com GitHub.
Passo 7: Corrija um bug ou adicione um recurso
Descreva o que você quer em linguagem simples. O Dropstone localizará o código, entenderá o contexto, implementará a alteração e a verificará.
há um bug em que consultas de pesquisa vazias retornam todos os resultados - corrija-o
adicione um endpoint /healthz ao servidor da API que retorna informações de build
o formulário de login trava quando o email está ausente - descubra o motivo e corrija
Se a tarefa abranger vários arquivos, o Dropstone escreverá um plano curto e o executará passo a passo. Você pode pressionar Esc a qualquer momento para interromper e redirecionar.
Passo 8: Experimente outros fluxos de trabalho comuns
Alguns padrões em que o Dropstone é bom:
Refatoração
refatore o módulo de autenticação para usar async/await em vez de callbacks
Escrever testes
escreva testes unitários para as funções da calculadora
Revisão de código
revise minhas alterações em stage e sinalize qualquer coisa arriscada
Documentação
atualize as instruções de instalação do README para incluir o caminho do WSL
Dica:
Fale com o Dropstone como se fosse um colega de equipe. Descreva o que você quer alcançar, não os passos exatos para chegar lá. O agente é melhor em planejar quando você deixa as escolhas de implementação para ele.
Comandos essenciais
Os poucos comandos que você realmente usará:
| Comando | O que faz | Exemplo |
|---|---|---|
dropstone | Inicia uma sessão interativa no diretório atual | dropstone |
dropstone run "tarefa" | Executa uma tarefa única e sai | dropstone run "explique auth.ts" |
dropstone -c | Continua a última sessão neste diretório | dropstone -c |
dropstone --session ID | Retoma uma sessão específica pelo id | dropstone --session 7f3a... |
/help | Mostra todos os comandos de barra | dentro de uma sessão |
/effort | Alterna o nível de modelo para esta sessão | /effort high |
/clear | Limpa a conversa atual | dentro de uma sessão |
/login | Troca de conta | dentro de uma sessão |
exit ou Ctrl+D | Sai do Dropstone |
A referência completa está nas páginas CLI e comandos de barra.
Dicas profissionais para novos usuários
O que vem a seguir
Obtendo ajuda
- Dentro do Dropstone, digite
/helpou pergunte em linguagem simples ("como troco de modelo?") - Navegue pelo restante da documentação em docs.dropstone.io
- Registre um problema ou solicitação de recurso em dropstone.io/contact