Downloads e instalação
Instale o Dropstone CLI no macOS, Linux ou Windows. Todos os métodos de instalação, como verificar e como atualizar ou remover.
O Dropstone CLI é um único binário dropstone no seu PATH. Sem Node, sem dependências de runtime, sem assistente de instalação. Esta página é a referência para todas as formas de obtê-lo e todas as formas de removê-lo.
Para uma primeira execução guiada, comece com o Quickstart.
Requisitos
| macOS | Homebrew, ou curl |
| Linux | curl. Debian, Ubuntu, Fedora, RHEL, Alpine e Arch são todos suportados |
| Windows | PowerShell ou CMD. WSL2 recomendado |
Não há aplicativo desktop nem plugin de IDE. O Dropstone roda no seu terminal e opera nos arquivos do seu diretório de trabalho.
Windows: vale a pena usar WSL
O binário nativo do Windows funciona para uso diário. O WSL2 oferece a mesma experiência de shell que macOS e Linux, e evita os problemas de caminho e fim de linha que surgem ao executar um agente entre dois sistemas de arquivos. Veja Windows e WSL.
Instalar
macOS
Homebrew:
brew tap blankline-org/dropstone-cli
brew install dropstone
Ou o script de instalação:
curl -fsSL https://dropstone.io/install | bash
Linux
curl -fsSL https://dropstone.io/install | bash
Suporte a gerenciadores de pacotes (apt, dnf, apk) está no roadmap.
Windows
PowerShell:
irm https://dropstone.io/install.ps1 | iex
Pelo CMD:
curl -fsSL https://dropstone.io/install.cmd -o install.cmd && install.cmd
Verificar a instalação
dropstone --version
Para verificar se você está na versão atual, compare com download.dropstone.io/latest.txt.
Atualizar
O binário verifica e baixa atualizações ao iniciar, então você fica na versão mais recente sem fazer nada.
A exceção é o Homebrew. O Homebrew é dono desse binário, então o Dropstone não o atualizará — atualize você mesmo:
# Homebrew
brew upgrade dropstone
# Qualquer outro método de instalação, se você quiser atualizar agora em vez de esperar
# a próxima verificação na inicialização
dropstone update
A atualização automática é configurável em dropstone.json:
{
"autoupdate": true
}
Defina como false para desativar as atualizações completamente, ou como "notify" para ser avisado quando uma nova versão existir sem instalá-la. Veja Configuração.
Desinstalar
dropstone uninstall
Isso remove o Dropstone e seus arquivos relacionados. No Homebrew:
brew uninstall dropstone
O que o instalador toca
O Dropstone mantém seu estado em dois diretórios, e nada mais:
| O quê | macOS / Linux | Windows |
|---|---|---|
| Credenciais e sessões | ~/.local/share/dropstone/ | %USERPROFILE%\.local\share\dropstone |
| Cache | ~/.cache/dropstone/ | %USERPROFILE%\.cache\dropstone |
dropstone uninstall limpa ambos. Para removê-los manualmente — ou para forçar um login limpo sem reinstalar — veja o Guia de solução de problemas.
Se a instalação falhar
As causas usuais são falta de Homebrew, um tap desatualizado, ou executar um comando CMD dentro do PowerShell. Problemas comuns aborda cada um com a correção exata.
Relacionados
- Quickstart — da instalação à primeira edição
- Problemas comuns — instalações com falha, autenticação e atualizações
- Windows e WSL — a configuração do Windows que vale a pena usar
- Configuração —
dropstone.jsone a opçãoautoupdate