Documentação

Instalação

O jeito mais rápido, em qualquer distribuição:

curl -fsSL https://quickdesk.click/install.sh | bash

Ele escolhe o .deb, .rpm ou AppImage para o seu sistema, confere o SHA-256 e instala (ler o script). Ou pegue um pacote na página de download e instale o arquivo baixado com:

• Ubuntu, Debian, Mint, Pop!_OS: sudo apt install ~/Downloads/QuickDesk_<version>_amd64.deb
• Fedora, openSUSE: sudo dnf install ~/Downloads/QuickDesk-<version>-1.x86_64.rpm
• Qualquer outra: torne o AppImage executável e abra. Ele precisa do FUSE 2 (libfuse2; no Ubuntu 24.04, libfuse2t64).

O QuickDesk precisa de um sistema x86_64 dos últimos anos (glibc 2.34 ou mais recente). Funciona melhor no GNOME, tanto no Wayland quanto no X11.

Windows 10 e 11 (64 bits): no PowerShell, execute irm https://quickdesk.click/install.ps1 | iex, ou baixe o instalador na página de download. Ele instala só para o seu usuário, sem permissão de administrador. O instalador ainda não é assinado, então o Windows pode dizer que protegeu seu PC: escolha Mais informações → Executar assim mesmo. No Windows os atalhos são Win Alt N / V / P, o QuickDesk fica na bandeja do sistema e a colagem automática não precisa de configuração. Lá a aba Runtimes funciona com mise, rustup e uv (veja Versões de linguagens).

Na primeira vez, uma tela de boas-vindas mostra os atalhos e oferece duas opções: iniciar ao entrar na sessão (necessário para que o histórico da área de transferência e o anel de IA funcionem sempre) e colagem instantânea (veja Colagem automática). Depois disso, o QuickDesk fica na barra superior.

macOS

Ainda em desenvolvimento. A versão para Mac funciona, mas é nova: ainda não foi tudo testado em todos os Macs, e a colagem automática e os atalhos continuam sendo aprimorados. Por favor, conte para a gente o que não funcionar.

O QuickDesk funciona no macOS 11 ou mais recente no Apple Silicon (M1 ou mais recente). No Terminal, execute curl -fsSL https://quickdesk.click/install.sh | bash: ele coloca o QuickDesk.app em Aplicativos e o abre. Ou baixe o .dmg na página de download e arraste o QuickDesk para Aplicativos.

Abrir pela primeira vez. O QuickDesk ainda não é notarizado pela Apple, então, se o .dmg foi baixado pelo navegador, o macOS interrompe a primeira abertura com o aviso de que “a Apple não pôde verificar se ele está livre de malware”. Não há nada de errado com o app; faça uma destas duas coisas uma vez (se você instalou com o comando, nenhum aviso aparece):

1. Abra o QuickDesk em Aplicativos e feche o aviso do macOS. Depois abra Ajustes do Sistema → Privacidade e Segurança, role até Segurança, clique em Abrir Mesmo Assim ao lado de “O “QuickDesk” foi bloqueado para proteger o seu Mac”, confirme com sua senha ou Touch ID e clique em Abrir. No macOS 14 ou anterior, também funciona clicar com Control no QuickDesk → Abrir → Abrir.
2. Ou execute xattr -dr com.apple.quarantine /Applications/QuickDesk.app no Terminal e abra o QuickDesk normalmente.

A página de download mostra os mesmos passos.

• O QuickDesk fica na barra de menus, sem ícone no Dock. As janelas pop-up abrem no Espaço em que você está, inclusive por cima de um app em tela cheia.
• Os atalhos são ⌃ ⌥ N / V / P (Control + Opção): ⌘⌥V e ⌘⌥N pertencem ao Finder.
• A colagem automática pressiona ⌘V no app que você estava usando, e o macOS só permite isso depois que você adicionar o QuickDesk em Ajustes do Sistema → Privacidade e Segurança → Acessibilidade. O macOS pergunta na primeira vez que você escolhe um item; até lá o item é copiado e você pressiona ⌘V. Settings → Auto-paste mostra se está permitido.
• Versões recentes do macOS podem perguntar se o QuickDesk pode ler o que outros apps copiam. Escolha Permitir, ou o histórico da área de transferência ficará vazio.
• Uso do Claude: no Mac, o Claude Code guarda o login no Chaveiro. A aba AI oferece lê-lo de lá; o macOS então pergunta uma vez (escolha Sempre Permitir). Como nos outros sistemas, o login só é lido e só é enviado para api.anthropic.com.
• Como o app tem assinatura ad hoc, o macOS pode pedir de novo as permissões de Acessibilidade e do Chaveiro depois de uma atualização. Se a colagem automática parar de funcionar, remova o QuickDesk da lista de Acessibilidade e adicione de novo.
• A aba Runtimes funciona como no Linux, com o seu shell de login (zsh: ~/.zshrc). Cópias instaladas pelo Homebrew aparecem, mas não são alteradas.

Desinstalar: saia do QuickDesk pela barra de menus e mova-o de Aplicativos para a Lixeira. Seus dados ficam em ~/Library/Application Support/click.quickdesk até você apagar essa pasta.

Atalhos

Pressionar de novo um atalho com a janela dele aberta fecha a janela. Mude qualquer um em Settings → Hotkeys; o QuickDesk avisa quando uma combinação já está em uso.

No GNOME os atalhos são adicionados em Configurações → Teclado → Atalhos personalizados e removidos quando o QuickDesk fecha, então também funcionam no Wayland. Em outros ambientes, associe quickdesk toggle notes, quickdesk toggle clipboard, quickdesk toggle ports ou quickdesk toggle quick-note a teclas nas configurações de teclado do seu ambiente.

Por que Super + Alt? Métodos de entrada vietnamitas, como Unikey e Bamboo, engolem Super + Shift + letra enquanto você digita em um campo de texto; as combinações com Alt continuam funcionando.

Notas

As notas são Markdown com um editor rico: títulos, negrito e itálico, listas, listas de tarefas, citações e blocos de código. Ctrl N cria uma nota nova, Ctrl S salva, Ctrl F pesquisa. A pesquisa ignora acentos, então tieng viet encontra “tiếng Việt”.

Fixe uma nota com a estrela para mantê-la no topo. Apagar pede confirmação e pode ser desfeito por alguns segundos.

Sincronizar notas entre computadores

As notas sincronizam pelo QuickDesk Cloud. Não há conta nem e-mail: um computador recebe um código de sincronização e seus outros computadores entram com ele. Só as notas sincronizam; o histórico da área de transferência e as configurações ficam em cada computador.

Configurar

1. No primeiro computador: Settings → Sync → Turn on sync, e escolha uma frase secreta (pelo menos 8 caracteres).
2. O QuickDesk mostra seu código de sincronização (QD1-…) e uma chave de recuperação. Guarde a chave de recuperação em um lugar seguro; ela só aparece uma vez.
3. Em cada um dos outros computadores: Settings → Sync → I have a sync code, e digite o código e a mesma frase secreta (ou a chave de recuperação).

Você pode ver o código de novo a qualquer momento com Show sync code em Settings → Sync.

Quando sincroniza

• Alguns segundos depois de você editar uma nota, e quando você abre uma janela do QuickDesk.
• Fora isso, o QuickDesk procura mudanças a cada minuto enquanto uma janela está aberta, e a cada 5 minutos enquanto está na bandeja. Cada verificação é uma única requisição pequena; as notas só trafegam quando algo mudou.
• Sync now verifica na hora. Mudanças feitas offline são enviadas quando você volta a ficar online.
• Se uma nota mudou em dois computadores ao mesmo tempo, as duas versões são mantidas: a mais recente fica e a outra vira uma cópia ao lado. Uma edição vence uma exclusão.

Privacidade e chaves

• As notas são criptografadas no seu computador antes do envio (XChaCha20-Poly1305, chave derivada da sua frase secreta com Argon2id). O QuickDesk Cloud só guarda texto cifrado sob um identificador de conta aleatório e não consegue ler suas notas.
• São necessárias as duas coisas: o código de sincronização (para chegar aos dados) e a frase secreta (para decifrá-los). Trate o código como uma senha: só com ele, alguém poderia apagar suas notas sincronizadas.
• Esqueceu a frase secreta? Digite a chave de recuperação. Sem nenhuma das duas, a cópia no QuickDesk Cloud não pode ser aberta, mas as notas em cada computador não são afetadas.
• Se o QuickDesk pedir Unlock sync (por exemplo, depois de redefinir o chaveiro do sistema), digite a frase secreta de novo.

Desativar

Turn off sync… para de sincronizar em um computador e mantém as notas dele. Marque Also delete my notes from QuickDesk Cloud para apagar a cópia sincronizada para todos os computadores.

Limites por código de sincronização: 256 MB e 20.000 objetos armazenados, muito mais do que notas precisam.

Histórico da área de transferência

Tudo o que você copia é guardado: texto, imagens (capturas de tela) e arquivos copiados no seu gerenciador de arquivos. Abra a janela com Super Alt V, digite para pesquisar, filtre por texto, imagens ou arquivos e pressione Enter para colar no app que você estava usando. Ctrl Enter só copia, Ctrl P fixa, Delete apaga.

• O histórico fica neste computador e nunca é sincronizado.
• O que os gerenciadores de senhas marcam como secreto é ignorado. Antes de copiar algo sensível, pause o salvamento por 15 minutos, uma hora ou até reativar (na aba Clipboard ou no menu da bandeja).
• O QuickDesk guarda os 1.000 itens mais recentes; os fixados, para sempre. Texto de até 1 MB, imagens de até 10 MB cada e 200 MB no total.
• Clear… na aba Clipboard apaga tudo, menos os itens fixados.

Colagem automática

Quando você escolhe um item, o QuickDesk volta para o app que você estava usando e pressiona Shift Insert, que também funciona em terminais. Escolha como em Settings → Auto-paste:

• Desktop portal (padrão): o GNOME pede permissão uma vez e mostra um indicador de controle remoto enquanto cola.
• Instant (virtual keyboard): sem avisos nem indicador. Ao ativar, pede sua senha de administrador uma vez para permitir que programas executados por você criem um teclado virtual (a mesma permissão que o Steam usa para controles).

Desative a colagem automática na aba Clipboard para apenas copiar, e então pressione Ctrl V você mesmo.

Portas

Super Alt P mostra cada porta TCP escutando (IPv4 e IPv6) com o processo, a linha de comando completa e o usuário, atualizada a cada 2 segundos. Filtre por porta, PID, processo ou nome de contêiner.

• Open abre http://localhost:<port> no seu navegador; Copy PID e Copy cmd copiam esses dados.
• Kill pergunta antes, depois encerra o processo com educação e só oferece forçar se ele não terminar.
• Portas publicadas pelo Docker mostram o contêiner e a imagem, e Stop para o contêiner em vez de matar o docker-proxy.
• Processos de outros usuários (serviços do sistema) aparecem ocultos; inspecioná-los exige root.

Versões de linguagens (Runtimes)

A aba Runtimes gerencia as versões das linguagens de programação deste computador (Node.js, Python, Rust, Go, Java, Ruby, Deno, Bun, PHP). Ela mostra a versão que um terminal novo executa e de onde vem. O QuickDesk pergunta ao seu shell de login, então isso é o que você obtém depois do ~/.bashrc ou ~/.zshrc, não o que a área de trabalho vê.

• As linguagens instaladas com nvm (Node.js), rustup (Rust), uv (Python) ou mise (Go, Java, Ruby, Deno, Bun, PHP e as demais) podem ser alteradas: Install version… escolhe entre as versões que a ferramenta oferece (o rustup aceita um canal ou uma versão digitada), Make default define o que os terminais novos usam, Uninstall remove uma e libera o espaço. A padrão não pode ser removida; escolha outra padrão antes.
• As instalações rodam em segundo plano com uma barra de progresso e podem ser canceladas. Só uma mudança roda por vez. A lista de versões mostra por padrão a versão mais recente de cada série; troque para LTS ou todas, ou digite para filtrar.
• Quando sai uma versão mais nova de uma série instalada (Node 22.24.1 para 22.23.3, Python 3.13.9 para 3.13.7), a versão mostra ↑ 22.24.1: um clique instala e, se a antiga era a padrão, torna a nova a padrão. A antiga fica até você desinstalá-la. Os canais do Rust são atualizados no lugar: stable mostra ↑ 1.93.0 quando o rustup tem um stable mais novo, e o clique executa rustup update stable.
• Apply right away in open terminals (no topo da aba) faz as mudanças chegarem aos terminais já abertos, a partir do próximo prompt: o QuickDesk adiciona uma linha ao seu arquivo de shell que carrega um pequeno hook do prompt (~/.config/quickdesk/shell/hook.sh). O hook faz o shell procurar os comandos de novo depois que o QuickDesk muda uma versão, e faz o Node seguir o .nvmrc mais próximo quando você entra com cd em um projeto, ou senão a padrão que você escolher (um nvm use manual vale até você mudar de pasta ou de padrão). Sem ele, as mudanças do Rust ainda valem na hora, as do Python e do mise chegam aos terminais novos (ou a um aberto depois de hash -r) e as do nvm só aos terminais novos.
• Set for a project… escreve o arquivo próprio da ferramenta na pasta que você escolher: .nvmrc, rust-toolchain.toml, .python-version ou mise.toml (o mise mantém as outras ferramentas que já estiverem lá).
• Uma linguagem sem gerenciador de versões (por exemplo, Go instalado com apt) oferece Install mise…: o QuickDesk baixa o mise mais recente de github.com/jdx/mise, confere com as somas SHA-256 da versão e o coloca em ~/.local/bin. Depois que você tornar uma versão padrão, Fix PATH… oferece a linha que ativa o mise no seu shell.
• Se os terminais novos fossem executar uma cópia diferente da padrão (por exemplo, o python3 do sistema vem primeiro no PATH), o cartão explica por quê e Fix PATH… mostra exatamente as linhas que adicionaria. Só quando você aceita, o QuickDesk as adiciona como um bloco marcado no fim do seu arquivo de shell, com um backup ao lado; o bloco pode ser removido no mesmo lugar.
• Os ajustes de PATH e o hook do prompt são escritos para bash (~/.bashrc) e zsh (~/.zshrc); o fish ainda não é suportado.
• As linguagens que ainda não estão no computador aparecem em Add a language: escolha uma para instalar o mise, se preciso, e depois uma versão.
• Windows: o QuickDesk pergunta ao PowerShell o que um terminal novo executa e trabalha com mise (instalado em %LOCALAPPDATA%\mise\bin), rustup e uv; o nvm-windows e o fnm aparecem, mas não são alterados, e o python.exe de espaço reservado da Microsoft Store é ignorado. Fix PATH… coloca as pastas da ferramenta (para o mise, os shims) no início do PATH da sua conta, o de Configurações → Variáveis de ambiente, sem permissão de administrador; o valor anterior é salvo em ~\.config\quickdesk\path e o mesmo painel remove as pastas de novo. Os terminais novos passam a usá-lo; a partir daí, mudanças de padrão valem na hora. No Windows o “Apply right away” não é necessário e não aparece.
• Cópias instaladas pelo sistema (apt, dnf) nunca são alteradas nem removidas; o QuickDesk nunca executa sudo. Linguagens gerenciadas por ferramentas que ele não suporta (fnm, volta, pyenv, SDKMAN…) aparecem só para leitura.

Uso de IA

Um anel na barra superior mostra quanto você já usou dos seus limites de IA, em verde, âmbar ou vermelho. O menu dele mostra a ferramenta que você acompanha, com uma barra para cada limite e quando ele reinicia; a aba AI mostra todas as ferramentas.

• Claude Code: o QuickDesk lê o login que o Claude Code já salvou neste computador e pergunta à Anthropic sobre o seu uso, no máximo a cada 5 minutos. O token só é lido: nunca é salvo, renovado nem enviado a lugar nenhum além da Anthropic.
• Codex: lido dos logs de sessão que o Codex guarda em ~/.codex.
• Gemini (Antigravity): não informa uma porcentagem, então o QuickDesk mostra, a partir dos logs dele, quando você esgotou a cota pela última vez.

Escolha qual ferramenta e qual limite acompanhar em Track, ou esconda o anel na aba AI.

Atualizações

O QuickDesk procura uma versão nova 30 segundos depois de iniciar e depois a cada 6 horas. Quando sai uma, um aviso na janela principal e um item no topo do menu da bandeja informam, com What’s New. Nada é instalado até você clicar em Update Now.

Cada atualização é verificada com a chave de assinatura do QuickDesk antes de ser instalada. Um .deb ou .rpm pede sua senha de administrador; um AppImage se substitui sozinho. Depois o QuickDesk reinicia e mostra o que mudou. Desative as verificações automáticas, ou verifique manualmente, em Settings → Updates.

Desinstalar

1. Desative Start QuickDesk when I log in em Settings e saia pela bandeja.
2. Remova o pacote: sudo apt remove quick-desk (Debian/Ubuntu) ou sudo dnf remove QuickDesk (Fedora), ou apague o AppImage.
3. Seus dados ficam em ~/.local/share/click.quickdesk até você apagar essa pasta.

Windows: Configurações → Aplicativos → Aplicativos instalados → QuickDesk → Desinstalar. Seus dados ficam em %APPDATA%\click.quickdesk até você apagar essa pasta.

Remover o pacote também retira a permissão de colagem instantânea, se você a ativou.

Solução de problemas

• Um atalho não faz nada: veja se há conflito em Configurações → Teclado → Atalhos personalizados, ou escolha outra combinação em Settings → Hotkeys.
• A colagem automática não digita nada: confira se o app em que você estava ainda tem o foco; mude o método em Settings → Auto-paste. O item sempre é copiado, então Ctrl V funciona.
• Logs: ~/.local/share/click.quickdesk/logs/. Anexe-os quando relatar um problema.