Tino — curador local-first de novidades de IA

Tino é um segundo-leitor discreto. Ele roda 100% na sua máquina, dentro do seu Claude Code, lê o seu vault Obsidian, monitora as fontes de IA que você configurou, e escreve de volta no próprio vault um punhado de novidades ranqueadas — cada uma com uma justificativa do porquê importa para você, hoje.

Não é um feed. Não é uma newsletter. Não é um SaaS. É um pequeno curador pessoal — com o tino (o discernimento) necessário para cortar ruído.

Tino /ˈtʃinu/ · do latim acumen. Faculdade de perceber o que é relevante; bom senso; discernimento.

Por que Tino existe

O mercado de IA hoje produz mais novidade relevante por dia do que qualquer pessoa consegue ler. E a resposta convencional — mais feeds, mais Twitter, mais newsletters — piora o problema: você consome mais, decide pior, e se sente culpado por não estar "em dia".

Tino inverte a equação. Ele reduz consumo, não aumenta. Lê tudo no seu lugar, filtra 95% fora, e te entrega um resumo curto e acionável com três perguntas respondidas para cada item:

O que é? (uma frase)
Por que importa PARA MIM? (ligado ao que está no seu vault — projetos ativos, stack, foco do momento)
O que fazer com isso? (foca hoje · considera · ignora por ora)

E tudo vai para dentro do seu Obsidian. Nada fica na nuvem. Nada sai da sua máquina.

Critérios que o Tino atende

O Tino foi construído contra uma barra clara de sucesso do usuário final. Cada item abaixo tem teste E2E automatizado em tests/e2e/ — rode npm run test:e2e para ver.

✓ Reduz consumo, não aumenta. No máximo 5 novidades no bloco "focar hoje". O resto fica agrupado ou descartado com tranquilidade.
✓ Dá permissão de ignorar. A seção "ignorar por ora" é explícita, desculpabilizante, e vem junto da contagem total para você ver o filtro operando.
✓ Cobre o terreno que importa. O pipeline roda contra múltiplas fontes (blogs oficiais, changelogs, papers, comunidade) — não só o Twitter barulhento.
✓ Explica por que algo importa para VOCÊ. Cada card expande num bloco "Por que importa para você" com citação de um arquivo real do seu vault. Nada de resumo genérico.
✓ Deixa você salvar o que importa. Favoritar um item o marca no vault e libera o comando /tino:deep-dive, que enriquece o material com tutoriais, casos de uso e sinal da comunidade.
✓ Parece biblioteca, não feed. Fundo escuro calmo, tipografia editorial (Newsreader), zero shake/bounce/badge de notificação. Desenhado para não te puxar pelo colarinho.

Dois critérios de projeto, também testados:

✓ Clonável em 3 comandos. git clone → npm install → npx playwright install chromium e tudo roda. Sem conta, sem chave, sem serviço externo obrigatório.
✓ Pipeline determinístico auditável. O modo --mock é uma heurística pura, sem LLM — você pode rodar offline, auditar linha a linha e reproduzir resultados exatos.

O que vem dentro (inventário)

O Tino entrega 4 capacidades em camadas. Use a tabela como mapa — cada item tem seção dedicada abaixo.

🗞️ Curador de novidades (MVP)

Tipo	Item	Pra que serve
Comando	`/tino:setup <vault>`	Cria estrutura `Tino/` no seu vault Obsidian + `_perfil.md` extraído
Comando	`/tino:refresh`	Coleta 30+ fontes RSS + ranqueia + escreve em `Tino/novidades/`
Comando	`/tino:profile-sync`	Re-extrai perfil quando você muda de foco
Comando	`/tino:deep-dive <id>`	Aprofunda novidade favoritada (tutorial + casos + sentimento)
Subagent	`profile-extractor`	Sintetiza perfil a partir do vault
Subagent	`ranker`	Ranqueia novidades contra o perfil
Subagent	`deep-diver`	Pesquisa profunda em favoritos
Frontend	`dashboard.html`	Single-file que lê o vault via File System Access API

🔬 Pesquisa pré-desenvolvimento (skill auto-trigger)

Tipo	Item	Pra que serve
Skill	`tino-pre-dev-research`	Recebe ideia vaga ("quero criar X"), pesquisa real na web (anti-hallucination), produz 10 docs `.md` em EN prontos pra alimentar planning AIs

🎓 Modo vibecoder — setup assistido (Onda 1)

Tipo	Item	Pra que serve
Comando	`/tino:vibe-onboard <vault>`	Wizard end-to-end (5 min): triagem → recomendação → instalação
Comando	`/tino:vibe-setup <vault>`	Só triagem (12 perguntas → `_perfil-vibecoder.md` validado)
Comando	`/tino:vibe-stack <vault>`	Só recomendação (curado + aitmpl.com → `_recomendacao.md`)
Comando	`/tino:vibe-install <vault>`	Só instalação (CLAUDE.md + settings.json patch + `_install.sh`)
Subagent	`vibecoder-interviewer`	Conduz triagem
Subagent	`vibecoder-recommender`	Combina curated-stack + aitmpl.com
Subagent	`vibecoder-installer`	Aplica configuração com salvaguardas

🛡️ Hooks runtime (Onda 2)

Tipo	Item	Pra que serve
Hook `UserPromptSubmit`	`anti-preguiçoso`	Detecta prompts curtos/vagos/error-paste — sugere reformulação
Hook `UserPromptSubmit`	`anti-burro`	Detecta loops "tenta de novo" + repetição literal — força pausa

Os 2 hooks rodam em 70-100ms (heurística pura, zero Claude API call no hot path) e respeitam o campo intervencao_hooks do seu perfil (silenciosa/ativa/agressiva).

Modo vibecoder (Onda 1)

O Tino agora também é um assistente de configuração do Claude Code pra quem está começando a programar com IA. Roda um wizard de 5 minutos que:

Faz triagem sobre você (papel, experiência, plano Claude, projeto, tolerância a risco)
Recomenda skills/agents/MCPs/plugins/hooks adequados ao seu perfil — mistura curadoria do time Tino com o catálogo público do aitmpl.com
Aplica a configuração: gera CLAUDE.md customizado, opcionalmente patch de ~/.claude/settings.json, e um install.sh executável

/tino:vibe-onboard ~/seu-vault-obsidian

Comandos individuais (escape hatches):

/tino:vibe-setup <vault> — só triagem (gera Tino/_perfil-vibecoder.md)
/tino:vibe-stack <vault> — só recomendação (gera Tino/_recomendacao.md)
/tino:vibe-install <vault> — só instalação (gera CLAUDE.md + install.sh + opcional settings.json)

Tudo respeita o modo_autonomia que você escolheu na triagem (perguntativo / balanceado / autonomo). Settings global SEMPRE pede confirmação explícita, mesmo em modo autônomo.

Hooks runtime (Onda 2)

Depois do setup, dois hooks ficam ativos no seu Claude Code global e te avisam quando você comete os erros mais típicos do vibe coder iniciante. Heurística pura no hot path — 70-100ms por hook (sem Claude API call), sem latência percebida.

`anti-preguiçoso`

Detecta prompts que costumam virar bola-de-neve:

Prompt < 30 chars sem ser pergunta clara (ex: "faz isso")
Palavra vaga isolada (isso, aquilo, esse troço, tipo assim, né)
Error paste sem pergunta (3+ linhas com stack trace mas sem ? nem instrução)

Whitelist evita falsos positivos: ok, sim, prossiga, continue, cancela, comandos /..., perguntas com "como"/"qual"/"quando".

`anti-burro`

Detecta o padrão clássico de loop sem nova informação:

"tenta de novo", "refaz", "de novo", "tenta outra vez" sem novo contexto
Mesmo prompt enviado 2+ vezes em sequência
Mesmo fragmento de erro repetido em prompts anteriores

State persiste em {vault}/.tino-cache/prompt-history.jsonl (jsonl, rotacionado automaticamente em 1000 entries).

Modos de intervenção

Comportamento controlado pelo campo intervencao_hooks do Tino/_perfil-vibecoder.md:

Modo	O que faz	Quando usar
`silenciosa`	Apenas registra em `.tino-cache/hook-log.jsonl`. Sem aviso visual.	Quer telemetria sem fricção
`ativa`	Renderiza box ANSI no stderr quando flagged. Não bloqueia.	Default sugerido — útil sem ser chato
`agressiva`	Box + bloqueia o prompt (exit 2). Força você a reformular.	Quando quer disciplina forte

Exemplo de output (modo ativa, prompt vago)

╭─ 🤔 Tino [anti-preguiçoso] ─────────────────────────────╮
│                                                         │
│  Detectei sinais de prompt preguiçoso:                 │
│  • prompt vago sem referente — diga o que você quer    │
│                                                         │
│  Sugestão: descreva objetivo + resultado esperado      │
│  + o que já tentou.                                    │
│                                                         │
│  Modo: ativa                                            │
╰─────────────────────────────────────────────────────────╯

Suporte NO_COLOR e TERM=dumb pra terminais legacy. Veja docs/hooks-vibecoder.md pra detalhes de instalação manual, debug e como desativar.

Pré-requisitos

Você vai precisar de um ambiente modesto:

Requisito	Versão mínima	Por quê
Claude Code	última	É o runtime dos comandos `/tino:*` (skills + agents)
Node.js	20+	Scripts CLI em ESM puro (node --test nativo)
Python 3	3.8+	Serve o `dashboard.html` estático em localhost
Chrome / Edge / Arc / Brave	qualquer recente	O dashboard usa a File System Access API (Chromium-only) para ler e escrever no vault
Um vault Obsidian	qualquer	Pode ser novo ou existente. Precisa só de uma pasta de markdowns.

Não é obrigatório ter o Obsidian instalado. O Tino escreve markdown puro — qualquer editor serve. O Obsidian vira útil quando você quer navegar, linkar notas e usar a rede do seu segundo cérebro.

Instalação

Quatro passos. Menos de dois minutos.

# 1. Clone o repo (pode ser em qualquer lugar)
git clone https://github.com/melgarafael/tino-ai.git
cd tino-ai

# 2. Deps do Node
npm install

# 3. Instala o Tino globalmente no seu Claude Code + PATH
bash install.sh

# 4. (opcional) Chromium para os testes E2E
npx playwright install chromium

O que o install.sh faz:

Salva o caminho do repo em ~/.tino/config.sh como TINO_HOME
Symlinka bin/tino → ~/.local/bin/tino (CLI global)
Symlinka os 4 slash commands → ~/.claude/commands/tino-*.md (funcionam em qualquer projeto do Claude Code, não só dentro do repo)
Symlinka os 3 agents → ~/.claude/agents/
Symlinka as skills tino-* → ~/.claude/skills/ (carregadas automaticamente quando o gatilho casa)
Tudo reversível via uninstall.sh — repo e vaults ficam intactos

Depois disso, tanto o CLI tino quanto os /tino:* funcionam de qualquer diretório. Você pode apagar o repo da memória mental — só precisa saber do comando.

Requisitos de PATH: se ~/.local/bin ainda não está no teu $PATH, o install script avisa. Adicione ao seu shell rc:

export PATH="$HOME/.local/bin:$PATH"

Dependências instaladas:

Produção: fast-xml-parser (RSS/Atom) e yaml (config). É isso.
Dev: @playwright/test (E2E). É isso também.

Sem framework web, sem bundler, sem transpilador. Node puro + HTML estático.

Primeiro uso

O fluxo canônico tem quatro momentos. Todos rodam do terminal, dentro do diretório do projeto.

1. Rode o setup no Claude Code

Dentro do seu Claude Code, na pasta do Tino, execute:

/tino:setup /caminho/absoluto/do/seu/vault

O que o /tino:setup faz:

Escaneia o vault recursivamente e lista as 30 notas com maior sinal (densidade de conteúdo × recência × backlinks).
Invoca o subagent profile-extractor (ou um fallback heurístico determinístico) para sintetizar um _perfil.md a partir daquelas notas.
Cria a pasta {vault}/Tino/ com:
- _perfil.md (identidade profissional · foco ativo · evita)
- _config.md (fontes monitoradas · frequência sugerida)
- novidades/ (vazio, por ora)
- favoritos/ (vazio)

Ao terminar, abre os dois arquivos de configuração pra você revisar.

2. Revise seu perfil

Abra {vault}/Tino/_perfil.md. Vai parecer algo assim:

---
nome: Rafael
atualizado: 2026-04-21
foco_ativo: [Claude Agent SDK, Managed Agents, Context engineering]
identidade: [SaaS B2B, Founder, CTO, Next.js, Supabase]
evita: [Geração de vídeo por IA, Hype de AGI]
processadas: 0
favoritadas: 0
thumb_up: 0
thumb_down: 0
acerto: 0
---

## Identidade
Founder e CTO do Tomik CRM. Construo SaaS B2B para equipes comerciais enxutas...

## Foco ativo
- Claude Agent SDK — construindo o Tino como projeto clonável
- Managed Agents — orquestração multi-agente oficial

## Evita
- Geração de vídeo por IA
- Debates filosóficos sobre consciência de LLMs

Edite à vontade. Este é o coração do Tino — é a partir daqui que o ranker decide o que foca e o que ignora. Menos é mais. Seja específico. "Claude Agent SDK" é melhor que "AI frameworks".

3. Rode o primeiro refresh

/tino:refresh

O que acontece:

scripts/fetch-all.mjs busca as fontes em config/sources.default.yaml (ou as do seu _config.md) e normaliza os itens em JSON no cache local (.tino-cache/).
scripts/rank.mjs --mock rankeia cada item contra seu _perfil.md, dando nota 0–10 e um veredito (Foca · Considera · Acompanha · Ignore).
Escreve um .md por novidade em {vault}/Tino/novidades/ com frontmatter estruturado e justificativa personalizada.

O modo --mock é determinístico — ele não chama LLM algum. É uma heurística baseada em sobreposição de vocabulário (foco ativo × item) + tipo da fonte + ajustes. Dá um baseline honesto sem custo.

4. Abra o dashboard e conecte o vault

npm run serve
# abre http://localhost:5173/dashboard.html no seu Chrome/Edge/Arc/Brave

No primeiro acesso você está em modo demo — vê dados de exemplo. Clique em Conectar vault no topo, navegue até a pasta do seu vault, autorize leitura e escrita.

A partir daí o dashboard lê ao vivo a pasta {vault}/Tino/novidades/. Toda vez que você roda /tino:refresh, um F5 no dashboard traz as novidades atualizadas — nenhum build, nenhum deploy, nenhum servidor.

Comandos disponíveis

O Tino expõe quatro comandos via Claude Code (skills carregadas de .claude/commands/).

`/tino:setup`

Inicializa o Tino em um vault. Escaneia, sintetiza perfil, cria a estrutura de pastas.

/tino:setup /Users/voce/Documents/vault

Só precisa rodar uma vez por vault. Se você quiser resetar, apague {vault}/Tino/ e rode de novo.

`/tino:refresh`

Ciclo canônico: coleta → rankeia → escreve. É o comando que você vai rodar regularmente — 1 a 2× por dia, mais ou menos.

/tino:refresh

Usa por padrão modo --mock (heurístico, sem LLM). Para usar o ranker real Claude quando disponível, passe --real (requer subscription e tem custo de token).

`/tino:profile-sync`

Regenera o _perfil.md re-escaneando o vault, preservando contadores de uso (processadas, favoritadas, thumbs). Útil quando você muda de foco — novo projeto, nova stack, novo tema de estudo — e quer que o ranker acompanhe.

/tino:profile-sync

Sempre cria backup do perfil antigo em _perfil.backup-<timestamp>.md.

`/tino:deep-dive`

Aprofunda uma novidade já favoritada. Chama o subagent deep-diver que combina WebSearch + o conteúdo original para produzir:

Tutorial de uso (passo-a-passo, exemplos de código quando aplicável)
Casos de sucesso da comunidade
Termômetro do sentimento (o que estão falando, links)

/tino:deep-dive anthropic-agent-sdk-1-0

Escreve o resultado em {vault}/Tino/favoritos/<slug>.md. Só roda em favoritos para proteger seu budget — aprofundar 50 novidades por dia sairia caro.

Comandos do modo vibecoder (Onda 1)

Quatro comandos que turbinam usuários iniciantes do Claude Code. Detalhes completos na seção Modo vibecoder (Onda 1).

`/tino:vibe-onboard <vault>`

Wizard end-to-end (~5 min). Conduz triagem → recomendação → instalação em sequência com confirmação entre etapas. Porta padrão pro júnior — não precisa decidir qual subcomando rodar.

/tino:vibe-onboard /Users/voce/Documents/vault

`/tino:vibe-setup <vault> [--re-run]`

Só a triagem (escape hatch). 12 perguntas conduzidas pelo agent vibecoder-interviewer, valida resposta a resposta contra JSON Schema, escreve Tino/_perfil-vibecoder.md. Use --re-run pra sobrescrever sem perguntar.

`/tino:vibe-stack <vault>`

Só a recomendação (escape hatch). Lê o perfil, combina config/curated-stack.yaml (curadoria do time Tino) com extras dinâmicos do aitmpl.com, filtra o que você já tem instalado, evita conflitos via incompatible[]. Escreve Tino/_recomendacao.md legível antes do install.

`/tino:vibe-install <vault> [--project-root <dir>]`

Só a instalação (escape hatch). Gera {project-root}/CLAUDE.md customizado pro seu perfil + Tino/_install.sh executável + opcionalmente patcheia ~/.claude/settings.json com permissions e hooks. Settings global SEMPRE pede confirmação explícita (mesmo em modo autônomo) + backup automático.

Skills (auto-trigger)

Além dos slash commands explícitos, o Tino expõe skills carregadas automaticamente pelo Claude Code quando o gatilho casa com o que você está pedindo. Skills não precisam ser invocadas com / — basta descrever o que você quer.

`tino-pre-dev-research`

Especialista em pesquisa pré-desenvolvimento. Recebe um pedido vago de software ("quero criar uma skill que edita vídeo automaticamente com Remotion"), faz uma entrevista direcionada baseada em arquétipo, pesquisa fontes reais na web (forums, GitHub, post-mortems, eng blogs) com regra anti-hallucination dura, e produz 10 documentos .md em {vault}/Tino/research/pre-development/<slug>/ que servem de input universal para planning AIs.

Quando dispara:

"quero criar uma skill / um agente / um app que faça X"
"preciso pesquisar antes de começar Y"
"qual a melhor stack para Z"
"ajuda a planejar um projeto novo"

Como funciona (resumido):

Triagem por arquétipo — classifica o projeto em um dos 8 tipos (skill/agent, SaaS web, CLI, mobile, library, data pipeline, automação interna, content creation)
Entrevista direcionada — perguntas específicas do arquétipo + escolha de profundidade (quick / standard / deep)
Pesquisa web real — sub-agentes paralelos por dimensão, com regra anti-hallucination dura (zero fonte inventada)
Síntese — 10 documentos .md com citações, scoring de confiança, conflitos explícitos

Output: {vault}/Tino/research/pre-development/<slug>/ com 10 docs:

00-brief.md              # Captura da entrevista
01-landscape.md          # Soluções existentes
02-stacks.md             # Stacks candidatas com tradeoffs
03-architecture.md       # Padrões arquiteturais
04-workflows.md          # Como times reais trabalham
05-pitfalls.md           # Erros comuns e post-mortems
06-community-pulse.md    # O que a comunidade recomenda HOJE
07-references.md         # Bibliografia com tier de credibilidade
08-decision-frame.md     # Tradeoffs em aberto
09-handoff.md            # Brief universal pronto para planning AI

Integração: o 09-handoff.md é desenhado como input universal para planning AIs — funciona com /octo:prd, /idea-to-execution, AIOS master e /octo:plan sem retrabalho.

Idioma: você fala com a skill em PT-BR; ela escreve os 10 docs em EN (planning AIs performam melhor em EN). Conversação sempre PT-BR.

Profundidade: quick (3min/dimensão) · standard (6min) · deep (12min).

Agents (subagentes)

Subagents são especialistas convocados pelos comandos. Você não os invoca diretamente — eles são despachados via Task tool conforme contexto. Vivem em .claude/agents/.

Subagents do MVP (curador)

Agent	Quando dispara	O que faz
`profile-extractor`	`/tino:setup`	Escaneia vault, sintetiza `_perfil.md` (identidade + foco + evita)
`ranker`	`/tino:refresh`	Ranqueia novidades contra perfil — produz nota 0-10 + veredito + justificativa com citação do vault
`deep-diver`	`/tino:deep-dive`	Pesquisa web profunda em favoritos: tutorial, casos, sentimento da comunidade

Subagents do modo vibecoder (Onda 1)

Agent	Quando dispara	O que faz
`vibecoder-interviewer`	`/tino:vibe-setup`	Conduz triagem (12 perguntas, uma por vez), valida resposta a resposta, escreve `_perfil-vibecoder.md`
`vibecoder-recommender`	`/tino:vibe-stack`	Roda pipeline `resolve(perfil, curated) + extras aitmpl + render`, grava `_recomendacao.md` com graceful degrade se aitmpl indisponível
`vibecoder-installer`	`/tino:vibe-install`	Gera CLAUDE.md, `_install.sh` (chmod +x), calcula diff de settings.json (sempre confirma) e executa install conforme `modo_autonomia`

Hooks runtime (Onda 2)

Hooks são scripts que rodam automaticamente em eventos do Claude Code (registrados em ~/.claude/settings.json). O Tino entrega 2 hooks UserPromptSubmit que ficam ativos em toda sessão Claude depois do /tino:vibe-install.

Hook	Arquivo	Detecta	Latência típica
`anti-preguiçoso`	`hooks/anti-preguicoso.mjs`	Prompt curto sem contexto, palavra vaga isolada, error paste sem pergunta	70-100ms
`anti-burro`	`hooks/anti-burro.mjs`	"tenta de novo" sem novo contexto, prompt repetido literalmente, fragmento de erro reusado	70-100ms

Como ativar: rode /tino:vibe-install (Onda 1) com perfil que tenha intervencao_hooks definido. O install gera o bloco hooks no seu ~/.claude/settings.json apontando pra $TINO_HOME/hooks/anti-{preguicoso,burro}.mjs.

Como desativar: edite _perfil-vibecoder.md mudando intervencao_hooks pra silenciosa (vira só log, sem aviso visual). OU remova o bloco hooks do settings.json (backup automático foi criado pelo install).

Detalhes completos (debug, install manual, formato do log) em docs/hooks-vibecoder.md.

Estrutura do projeto

tino-ai/
├── .claude/
│   ├── agents/             # 6 subagents
│   │   ├── profile-extractor.md, ranker.md, deep-diver.md          # MVP
│   │   └── vibecoder-{interviewer,recommender,installer}.md         # Onda 1
│   ├── commands/           # 8 slash commands
│   │   ├── tino-{setup,refresh,profile-sync,deep-dive}.md           # MVP
│   │   └── tino-vibe-{onboard,setup,stack,install}.md               # Onda 1
│   └── skills/             # Auto-trigger
│       └── tino-pre-dev-research/
├── hooks/                  # 2 hooks UserPromptSubmit (Onda 2) + libs core
│   ├── anti-preguicoso.mjs   # Entry executável
│   ├── anti-burro.mjs        # Entry executável
│   └── lib/
│       ├── hook-context.mjs    # parseStdin + loadPerfil + readStdin
│       ├── visual-output.mjs   # ANSI box + NO_COLOR fallback
│       ├── prompt-history.mjs  # jsonl append/readLastN/rotate
│       └── prompt-analyzer.mjs # heurísticas puras (analyzeLazy + analyzeStuck)
├── config/
│   ├── sources.default.yaml          # 30+ fontes RSS/Atom (MVP)
│   ├── curated-stack.yaml            # Stack vibecoder curado (Onda 0/1)
│   ├── schemas/
│   │   ├── perfil-vibecoder.schema.json     # JSON Schema do perfil (Onda 0)
│   │   └── recomendacao.schema.json         # JSON Schema do recomendacao (Onda 1)
│   └── prompts/                      # Prompts dos subagents do MVP
├── lib/                    # Módulos puros (12 arquivos)
│   ├── fetch.mjs, rss-parser.mjs, frontmatter.mjs, vault-scanner.mjs   # MVP
│   ├── rank-mock.mjs, adjustments.mjs                                   # MVP
│   ├── aitmpl-client.mjs, curated-stack.mjs                             # Onda 0
│   ├── stack-resolver.mjs, recomendacao-render.mjs                      # Onda 1
│   ├── perfil-vibecoder-writer.mjs, recommender-pipeline.mjs            # Onda 1
│   ├── claude-md-template.mjs, settings-patch.mjs, install-sh-render.mjs # Onda 1
│   └── tino-home.mjs                                                    # Onda 2
├── scripts/                # Entradas CLI do MVP
│   ├── setup.mjs, refresh.mjs, profile-sync.mjs, deep-dive.mjs
│   ├── fetch-all.mjs, rank.mjs
├── tests/                  # 147 unit + integration tests (node --test)
│   ├── *.test.mjs            # 63 MVP + 24 Onda 0 + 30 Onda 1 + 30 Onda 2
│   ├── fixtures/             # RSS + perfil + recomendacao + aitmpl mock + curated mock
│   └── e2e/                  # 7 specs Playwright (critérios do usuário, MVP)
├── docs/
│   ├── perfil-vibecoder.md          # Doc humana do schema do perfil
│   ├── recomendacao-vibecoder.md    # Doc humana do schema do recomendacao
│   ├── hooks-vibecoder.md           # Uso/debug/desativar dos hooks
│   ├── superpowers/specs/           # Design docs por onda
│   ├── superpowers/plans/           # Implementation plans executáveis
│   └── stories/epics/               # Epic files (epic-executor)
├── tino-vault-sample/      # Vault de demo
├── dashboard.html          # Dashboard single-file (52KB)
├── playwright.config.mjs   # E2E (porta 5174)
└── package.json            # Scripts: test · test:foundation · test:setup · test:hooks · test:e2e · test:all · serve

Todos os scripts e libs são ESM puro ("type": "module"). Nada de CommonJS, nada de TypeScript, nada de build. node scripts/X.mjs roda direto.

Fontes customizadas

O Tino vem com ~30 fontes default em config/sources.default.yaml cobrindo:

Labs e empresas: Anthropic, OpenAI, Google DeepMind, Meta AI, Mistral, Cohere, Hugging Face
Infra e dev-tools: Vercel Changelog, Supabase, LangChain, LlamaIndex
Papers: arXiv cs.CL, Papers With Code
Comunidade: Hacker News (keyword: AI/LLM), subreddits curados
Newsletters editoriais: Ben's Bites, Import AI, The Rundown

Para customizar, edite {seu-vault}/Tino/_config.md — ele tem uma seção ## Fontes em YAML inline:

## Fontes

- id: anthropic-blog
  name: Anthropic Blog
  type: rss
  url: https://www.anthropic.com/news/rss.xml
  active: true
  weight: 1.0
- id: minha-fonte-custom
  name: Blog do meu parceiro
  type: atom
  url: https://exemplo.com/feed.atom
  active: true
  weight: 1.2   # pondera acima do default

O weight é multiplicado na nota final — use para amplificar fontes que você confia mais e reduzir as ruidosas. Para desativar temporariamente, active: false.

Como funciona o ranking

Tino tem dois modos de ranker, ambos funcionam no mesmo contrato de entrada e saída:

Modo mock (default)

Heurística pura em lib/rank-mock.mjs. Dado um item (título + resumo + tipo + fonte) e um perfil (foco_ativo + identidade + evita), calcula nota 0–10 com base em:

Sobreposição de vocabulário entre item e foco_ativo do perfil (peso dominante)
Bônus de tipo (release > paper > news > community)
Bônus de fonte (peso do _config.md)
Penalidade de evita — se o título bate com termo anti-filtro
Ajustes do feedback loop — thumbs-down previos em tags similares puxam a nota pra baixo

É determinístico: mesmo perfil + mesmo item = mesma nota, sempre. Útil pra reproduzir bugs, pra auditar decisões, pra rodar offline.

Modo real (Claude) — `tino rank:claude`

Pra justificativas concretas em vez de formulaicas, use o ranker via Claude headless:

# Todos os items do vault
tino rank:claude --vault "$VAULT"

# Só items com nota >= 9 (mais rápido/barato)
tino rank:claude --vault "$VAULT" --only-foca

# Dry-run antes de reescrever
tino rank:claude --vault "$VAULT" --dry-run

Faz batch de 15 items por call via claude -p headless, usando config/prompts/rank-novelty.md. Cada novidade recebe:

Justificativa concreta citando qual termo do _perfil.md ativou
Conexão explícita com projeto/interesse do perfil (ex: "Managed Agents casa direto com o Tino local-first")
Ação sugerida (migrar código, agendar leitura, descartar)
Zero boilerplate tipo "baseado em heurística"

Cost aproximado: $0.02–$0.05 por batch de 15 items com cache quente (~$0.20–$0.30 pra 70 items).

Fluxo recomendado: rode tino refresh --mock rápido pra popular novidades/, depois tino rank:claude pra refinar. Mock descobre, Claude decide e explica.

A flag --mock no scripts/rank.mjs chaveia entre os dois. Os comandos /tino:refresh expõem a opção.

Feedback loop

Você ensina o Tino clicando nos botões Certeiro ou Errou em cada card expandido do dashboard.

O que isso faz:

Dashboard escreve (via File System Access API) no arquivo {vault}/Tino/_ajustes.md uma seção ## Certeiros ou ## Errados listando o id + título.
Incrementa o contador thumb_up ou thumb_down no frontmatter.
Se você marca como "Errou" muitos itens com um tipo comum (ex: múltiplos itens com tag ios-development), o ignore_tags cresce automaticamente.
Na próxima rodada de /tino:refresh, o ranker lê o _ajustes.md e aplica penalidade a itens similares aos thumbs_down recentes e zera a nota de itens com tag em ignore_tags.

Resultado: o Tino erra menos ao longo das semanas. É uma malha fechada simples — sem ML, sem embeddings, sem servidor.

Dica: marque Certeiro de vez em quando também. Sem sinal positivo, o sistema super-penaliza e fica tímido demais.

Arquitetura: local-first + zero infra

Tino foi desenhado em oposição explícita ao modelo SaaS do mainstream. Decisões-chave:

Sem backend. O dashboard é um único arquivo HTML estático que lê o vault via File System Access API. O "banco" é a pasta de markdowns.
Sem build step. Nada de Vite, Next, webpack, esbuild. python3 -m http.server é o deploy.
Sem conta, sem chave. Você pode rodar o Tino offline. Só sai da sua máquina os HTTP GETs para as fontes RSS que você mesmo configurou.
Sem estado central. Dois usuários rodando Tino contra o mesmo vault-compartilhado têm resultados idênticos (desde que rodem o mesmo cache). Zero sincronia.
Código auditável. ~2500 linhas de JS puro. Sem dependências misteriosas. Você pode ler tudo em uma tarde.

Trade-offs conscientes:

Não escala pra time. Se 3 pessoas querem notificações comuns, o Tino não resolve. Intencional.
Não é tempo-real. Você roda /tino:refresh — ele não te acorda. Por design: notificação é drogade do engajamento.
Dashboard depende de browser Chromium. Firefox não tem File System Access API ainda. Se quiser suporte Firefox, abra uma issue.

Rodando os testes

O projeto tem duas suítes:

# 1. Unit + integration (63 testes, ~1.5s)
npm test

# 2. End-to-end via Playwright (7 critérios do usuário, ~6s)
npm run test:e2e

# 3. Tudo junto
npm run test:all

Os testes E2E são a espinha da validação do projeto. Cada critério de sucesso do usuário (redução de consumo, permissão de ignorar, cobertura, justificativa, favoritar, design calmo) tem um spec dedicado em tests/e2e/. Se você quebrar um comportamento visível, um teste cai.

O config do Playwright (playwright.config.mjs) sobe automaticamente um python3 -m http.server na porta 5174 apontando para a raiz do repo. Você não precisa iniciar nada manualmente.

Privacidade

O que sai da sua máquina:

Requisições HTTP GET para os feeds RSS/Atom em config/sources.default.yaml ou no seu _config.md. Nada além do User-Agent default do Node.
Requisições para Google Fonts (Newsreader + Inter), feitas pelo browser ao carregar o dashboard.html. Se isso incomoda, baixe as fontes localmente e edite o <link> no HTML.
Se, e somente se, você usar modo --real do ranker ou o /tino:deep-dive: o Claude Code faz chamadas à API da Anthropic com o conteúdo dos itens + seu perfil. É aí que você decide conscientemente compartilhar.

O que nunca sai:

Qualquer arquivo do seu vault fora os cabeçalhos curtos passados ao ranker (e mesmo isso só no modo --real).
Telemetria, analytics, pings. Não existe.
Contadores, estatísticas, IDs de usuário. Não existe backend para onde mandar.

Rode npm test e npm run test:e2e com a rede desligada e tudo passa — exceto os testes que batem em feeds externos (que usam fixtures locais).

Contribuindo

PRs são bem-vindos. Fluxo sugerido:

Abra uma issue primeiro se for algo não-trivial — quero discutir o desenho antes de você investir tempo.
Fork + branch (feat/minha-ideia ou fix/bug-no-ranker).
Escreva teste (unit em tests/ ou E2E em tests/e2e/) que falha antes e passa depois.
Mantenha o estilo: ESM puro, funções pequenas, nomes em português no código de domínio e em inglês no utilitário.
Rode npm run test:all antes de abrir o PR.
PR pequeno > PR grande. Se sua mudança toca mais de 5 arquivos, considere dividir.

Áreas onde ajuda é especialmente bem-vinda:

Mais fontes curadas em config/sources.default.yaml (com weight justificado no PR).
Ranker real para providers além da Anthropic (OpenAI, Gemini, local via Ollama).
Suporte a Firefox (polyfill da File System Access API ou fallback via drag-drop).
Tradução do README e comandos para inglês (o Tino nasceu em pt-BR mas pode ganhar o mundo).

Licença

MIT. Use, forque, venda, modifique — só mantenha o copyright e não me culpe se der ruim.

Agradecimentos

Construído em cima do trabalho de muita gente:

Anthropic — por ter aberto o Claude Code o suficiente pra essa ideia ser viável.
Obsidian — por ter provado que markdown + links é o melhor sistema de notas já inventado.
Playwright — pela experiência de escrever testes E2E sem chorar.
Comunidade local-first — Ink & Switch, Martin Kleppmann, Linus Lee, Maggie Appleton — pelos papers e ensaios que ancoraram a estética do projeto.

Se o Tino te serve, me conta (rafael@maudibrasil.com.br). Se não serve, me conta também — é como o feedback loop funciona.

ter tino é ter discernimento.

Name		Name	Last commit message	Last commit date
.claude		.claude
.playwright-mcp		.playwright-mcp
Tino		Tino
bin		bin
config		config
docs		docs
hooks		hooks
lib		lib
scripts		scripts
tests		tests
tino-vault-sample		tino-vault-sample
.gitignore		.gitignore
README.md		README.md
dashboard.html		dashboard.html
install.sh		install.sh
package-lock.json		package-lock.json
package.json		package.json
playwright.config.mjs		playwright.config.mjs
tutorial.html		tutorial.html
uninstall.sh		uninstall.sh

Latest commit

History

Folders and files

Repository files navigation

Tino — curador local-first de novidades de IA

Por que Tino existe

Critérios que o Tino atende

O que vem dentro (inventário)

🗞️ Curador de novidades (MVP)

🔬 Pesquisa pré-desenvolvimento (skill auto-trigger)

🎓 Modo vibecoder — setup assistido (Onda 1)

🛡️ Hooks runtime (Onda 2)

Modo vibecoder (Onda 1)

Hooks runtime (Onda 2)

anti-preguiçoso

anti-burro

Modos de intervenção

Exemplo de output (modo ativa, prompt vago)

Pré-requisitos

Instalação

Primeiro uso

1. Rode o setup no Claude Code

2. Revise seu perfil

3. Rode o primeiro refresh

4. Abra o dashboard e conecte o vault

Comandos disponíveis

/tino:setup

/tino:refresh

/tino:profile-sync

/tino:deep-dive

Comandos do modo vibecoder (Onda 1)

/tino:vibe-onboard <vault>

/tino:vibe-setup <vault> [--re-run]

/tino:vibe-stack <vault>

/tino:vibe-install <vault> [--project-root <dir>]

Skills (auto-trigger)

tino-pre-dev-research

Agents (subagentes)

Subagents do MVP (curador)

Subagents do modo vibecoder (Onda 1)

Hooks runtime (Onda 2)

Estrutura do projeto

Fontes customizadas

Como funciona o ranking

Modo mock (default)

Modo real (Claude) — tino rank:claude

Feedback loop

Arquitetura: local-first + zero infra

Rodando os testes

Privacidade

Contribuindo

Licença

Agradecimentos

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

`anti-preguiçoso`

`anti-burro`

`/tino:setup`

`/tino:refresh`

`/tino:profile-sync`

`/tino:deep-dive`

`/tino:vibe-onboard <vault>`

`/tino:vibe-setup <vault> [--re-run]`

`/tino:vibe-stack <vault>`

`/tino:vibe-install <vault> [--project-root <dir>]`

`tino-pre-dev-research`

Modo real (Claude) — `tino rank:claude`