Notezbeta
Voltar ao blog

Como fazer anotações no terminal

terminalDenis Povarov

Se você passa o dia no terminal, abrir um app gráfico de notas só para anotar uma ideia é uma troca de contexto que você paga duas vezes: uma para chegar lá e outra para recuperar o foco na volta. Anotar direto na linha de comando elimina os dois custos. Este post cobre as principais abordagens, de arquivos de texto sem nenhuma dependência a ferramentas de CLI dedicadas, e quando cada uma faz sentido.

Por que o terminal é um bom lugar para notas

Três características fazem do shell um lugar muito bom para capturar:

  • Você já está lá. No meio de um debug, de um deploy, de um code review — o prompt está em foco, esperando.

  • A saída é texto. Mensagens de erro, falhas de teste e a saída de comandos vão por pipe direto para uma nota, sem print de tela nem redigitação.

  • Funciona em qualquer lugar. Via SSH, dentro do tmux, numa máquina de CI — onde roda um shell, roda o seu jeito de capturar.

O ponto fraco comum das anotações no terminal está na outra ponta: achar as notas depois. Arquivos de texto se acumulam; encontrar a linha certa três meses depois é a parte difícil. Tenha esse custo em mente ao escolher uma abordagem.

Abordagem 1: um arquivo de texto em que você só acrescenta linhas

O sistema mais simples que funciona:

Bash 
echo "$(date +%F) - use SIGTERM not SIGKILL in the entrypoint" >> ~/notes.md

Coloque isso numa função de shell e vira um hábito de duas teclas:

Bash 
note() { echo "$(date +%F) $*" >> ~/notes.md; }

Para achar uma nota, grep -i keyword ~/notes.md. Isso não custa nada, sincroniza com o que já sincroniza a sua pasta pessoal e nunca quebra.

Os limites aparecem com o volume: um único arquivo não tem estrutura, o grep só encontra palavras exatas, e nada vai com você para uma segunda máquina a menos que você mesmo configure a sincronização.

Abordagem 2: notas no seu editor, abertas pelo shell

vim ~/notes/$(date +%F).md ou um pequeno script que abre a nota do dia dá a você um editor de verdade e um arquivo por dia. As ferramentas dessa família (scripts de nota diária, nb, CLIs de diário) acrescentam só a estrutura necessária — arquivos com data, às vezes tags — e continuam locais e fáceis de usar em scripts.

Isso funciona bem quando as notas têm mais de uma linha. O custo é que abrir um editor deixa de ser uma captura de dois segundos; vira uma pequena tarefa por si só, e via SSH a configuração do seu editor pode não estar lá.

Abordagem 3: uma CLI de captura ligada a um cofre sincronizado

A terceira abordagem separa a captura do armazenamento: uma CLI pequena cujo único trabalho é pegar o texto do seu shell e colocá-lo num sistema de notas que cuida da busca, da sincronização e da organização em outro lugar.

É o modelo que a Notez CLI usa. Ela é um binário de 3 MB para macOS, Linux e Windows; depois de um notez login, feito uma única vez, capturar é assim:

Bash 
notez "the flaky test is timezone-dependent — freeze the clock"
echo "worth keeping" | notez
notez --title "Postmortem notes" "timeline starts 14:02 UTC"

As notas caem num espaço de trabalho que você também abre num app web, então achá-las não depende do grep: a busca funciona por significado (buscar "flaky tests" encontra a nota sobre o fuso horário), e as capturas depois ganham tags, links para outras notas ou viram textos maiores num editor completo. Uma URL é reconhecida sozinha e vira um link salvo, e a saída --json deixa a CLI pronta para scripts e git hooks.

Aqui o custo se inverte em relação aos arquivos de texto: você ganha busca, sincronização e estrutura, e em troca suas notas ficam num serviço, não num único arquivo local. Se isso importa para você, confira se há uma saída — o Notez, por exemplo, exporta um espaço de trabalho inteiro como um .zip de arquivos Markdown com os anexos, um critério razoável para cobrar de qualquer ferramenta.

Padrões que funcionam em qualquer sistema

Seja qual for a abordagem, alguns hábitos fazem as notas do terminal servirem de verdade depois:

Use pipe, não redigite

O argumento mais forte para capturar no terminal é que o material já está em texto na sua frente:

Bash 
./run-tests.sh 2>&1 | tail -20 | notez --title "auth test failure"

Uma nota com a saída de erro real vale por dez que só a resumem.

Anote as soluções, não só os problemas

A nota mais valiosa no cofre de um desenvolvedor é "foi isso que resolveu". Quando algo finalmente funcionar, escreva a causa numa linha. Lá na frente, você vai buscar a mensagem de erro e encontrar a resposta.

Data automática, título só quando precisar

Deixe a ferramenta registrar quando a nota foi criada. Títulos são opcionais em capturas rápidas — uma nota que levou dois segundos para escrever já vale a pena mesmo sem título, e a busca por significado não precisa de título para encontrá-la.

Uma caixa de entrada só

Mande todas as capturas rápidas para um lugar só e faça a triagem depois (ou nunca). No momento em que você se obriga a escolher um destino na hora de capturar, volta o atrito que você queria eliminar.

Como escolher entre as abordagens

  • Arquivo de texto: você quer zero dependências e suas notas são memória de trabalho de vida curta.

  • Editor + arquivos com data: suas notas são mais longas e você trabalha numa máquina só.

  • CLI de captura + cofre sincronizado: você captura com frequência, de várias máquinas, e achar a nota importa tanto quanto capturá-la.

As abordagens também se combinam. Muita gente mantém um arquivo de rascunho para o que é passageiro e um cofre sincronizado para tudo o que vale a pena achar de novo. A única regra de verdade é deixar a captura barata o bastante para você realmente capturar — um sistema de notas que você usa todo dia vale mais que um elaborado que você não usa.

Continue lendo