Pular para o conteúdo

Tapa leitor de Markdown nativo

Tapa. Reader-first Markdown · Native · Agent-ready

A pasta que você abre é uma superfície que seus agentes de IA leem e editam por MCP: o arquivo é a API. Reader-first no desktop nativo, abre na hora. Grátis e open source, MIT.

O Tapa é reader-first. Aponte para uma pasta de Markdown e você lê: prosa renderizada e limpa, nada no caminho. A edição é sob demanda. Dois cliques no bloco exato e você cai num editor no ponto onde clicou; dois cliques de novo e volta a ler.

O que ele faz

01

Leitura em primeiro lugar

Abra uma pasta e leia Markdown renderizado. CommonMark e GFM completos.

02

Edição sob demanda

Dois cliques num bloco para editar exatamente ali (CodeMirror).

03

Árvore de arquivos

Sidebar com a pasta inteira, alterna com Cmd-B.

04

Busca difusa de arquivos

Cmd-K para pular entre arquivos pelo nome.

05

Busca no conteúdo

Cmd-Shift-F busca dentro dos arquivos, com os resultados vindo do Rust.

06

Recarga ao vivo

Mudanças no disco recarregam sozinhas, sem perder edições não salvas.

07

Tema nativo do sistema

Segue o claro/escuro do SO, com alternância manual.

Agentes (MCP)

O Tapa inclui um servidor MCP opcional, o tapa-mcp. Aponte qualquer cliente MCP (Claude Code, Codex, Cursor) para uma pasta e o agente ganha list, read e search sobre o seu Markdown, somente leitura por padrão.

claude mcp add tapa -- /path/to/tapa-mcp /path/to/your/vault

Adicione --write no fim para liberar escrita: append, e patch que edita um único bloco por ^id ou uma seção por título, com uma precondição if_match que recusa se o arquivo mudou por baixo. As escritas são atômicas (arquivo temporário e rename). E é reativo: subscribe empurra a mudança no instante em que o disco muda, sem ficar relendo num intervalo.

O tapa-mcp é um binário separado, não vem embutido: o leitor continua um leitor puro se você nunca compilar. A renderização do Markdown roda em JavaScript, não em Rust, e o projeto ainda é cedo.

Atalhos

⌘K
Busca difusa de arquivos
⌘⇧F
Busca no conteúdo
⌘B
Alternar a sidebar
⌘S
Salvar e voltar a ler
Dois cliques
Entrar / sair do modo edição

De onde vem o nome

Tapa, de Tapajós, o rio e a região do oeste do Pará de onde o Ary é. A região tem identidade própria, com um movimento histórico para criar um Estado do Tapajós.

E porque, como um tapa, ele é inesperadamente rápido: um golpe seco e certeiro.

Para onde vai

O caminho é sair de um leitor pequeno em direção a um editor aberto, plugável e nativo de IA. A referência na minha cabeça é o acabamento e a ambição de algo como o Granola, mas com a forma oposta: local-first em vez de nuvem, aberto em vez de fechado, um editor que você possui em vez de um serviço que você aluga.

O MCP é a primeira peça que sustenta isso: a prova de que o arquivo pode ser a superfície compartilhada. As costuras para plugins vêm depois. Não existe sistema de plugins ainda.

O roadmap é deliberadamente aberto, para manter a liberdade de mudar de ideia sobre o caminho. O que fica firme é a direção e a licença: continua MIT, e continua algo que seus agentes conseguem ler.

Baixar

v0.2.0 · grátis, MIT · macOS, Windows, Linux

O app ainda não é assinado, então o sistema avisa no primeiro abrir: no macOS use clique direito e Abrir; no Windows clique em Mais informações e Executar mesmo assim.

Todas as versões Código no GitHub (deixa uma estrela)

Receba os updates do Tapa

Construindo em público. Deixa seu email e eu aviso quando sair versão nova, junto com a newsletter sobre IA, automação e engenharia. Opcional: o download acima é livre.