Jev no Obsidian ou em script por fora: qual caminho escolher?

Resposta rápida

Se você quer usar o Jev no Obsidian, existem dois caminhos: plugin da comunidade, que decide a nota aberta quando você dispara o comando, ou script por fora, que varre o vault em lote com a política no código. O plugin ganha em feedback imediato e revisão humana nota por nota (Auto Tagger, Jevault, Jev Lens). O script ganha em volume, limiares versionados e reprodutibilidade (jev-the-janitor). O Jev não gera texto: devolve Choice, Score e Noul com probabilidade, a US$ 0,042 por 1 milhão de tokens de entrada e saída gratuita. Atenção: novos cadastros estão pausados.

Fala aí, beleza? O Jev não escreve uma linha de texto pra você

Ele devolve valor tipado com probabilidade, pronto pro seu código consumir, e isso muda TUDO na hora de decidir onde chamar esse bicho

Hoje já existem plugins de Obsidian usando o Jev pra escolher tag, sugerir pasta e pontuar nota em tempo real, e também existe projeto de script que varre um vault Markdown inteiro votando em cada arquivo

Os dois caminhos funcionam, resolvem coisas diferentes e custam esforços diferentes

Bora comparar os dois de verdade, pra tu escolher por onde começar sem perder tempo 🙂

O que é o Jev e por que ele cabe nos dois caminhos

O Jev é o primeiro modelo System One da TypeSafe AI, lançado em 15 de setembro de 2026 em acesso antecipado

E "System One" aqui é o pulo do gato: ele não tem saída generativa

Nada de parágrafo, nada de markdown de resposta, nada de "claro! aqui está a sua tag"

Ele devolve valores tipados com probabilidades calibradas, pensados pra serem consumidos por código e não lidos por uma pessoa

Que valores? A API expõe três primitivas de pergunta:

  • Choice: escolhe entre opções, com probabilidade por opção (aceita até 255 opções)
  • Score: avalia contra níveis ordenados (de 2 a 10 níveis)
  • Noul: probabilidade de sim/não

Se você conhece a diferença entre chamar um LLM e chamar uma função que devolve float, é mais ou menos isso: aqui você não parseia texto, você lê número

E tem outro detalhe que importa pros dois caminhos: várias perguntas sobre o mesmo estado podem ir em uma única requisição e são avaliadas em paralelo, então adicionar perguntas quase não muda o tempo de resposta

Ou seja, perguntar "qual pasta?" e "isso tem segredo dentro?" e "parece duplicado?" de uma vez não é o triplo do custo de tempo

O preço também é bem fora do padrão que a gente tá acostumado: no jev-1.12 são US$ 0,042 por 1 milhão de tokens de entrada, e a saída sai US$ 0,00

Faz sentido: a saída é um punhado de números, não um texto

Por que essa forma de resposta serve tanto pro editor quanto pro script:

Pensa no que um plugin de Obsidian precisa fazer quando tu aperta um comando

Ele precisa de UMA decisão, rápida, com confiança anexada, pra te mostrar na tela e esperar tua aprovação

Agora pensa no que um script de limpeza precisa

Ele precisa da MESMA decisão, mas mil vezes, e precisa que o resultado seja comparável com um limiar fixo pra virar ação automática

Um modelo que devolve probabilidade calibrada atende os dois sem ginástica: no editor você mostra o número pro humano, no script você compara o número com um if

Tome cuidado com uma coisa antes de planejar qualquer um dos dois caminhos: depois de abrir o acesso sem lista de espera, a TypeSafe pausou temporariamente novos cadastros no Jev por excesso de demanda

O anúncio é de 22 de setembro de 2026, as contas já criadas continuam funcionando e a empresa diz estar trabalhando pra reabrir, sem data divulgada

Quando o acesso aberto foi anunciado (21/09/2026), a TypeSafe tinha removido a waitlist e oferecido US$ 5 de crédito gratuito pra quem criasse conta no console

Se tu já tem chave, beleza, segue o jogo

Se não tem, vale ler o resto pra já saber por onde entrar quando reabrir…

Plugin no Obsidian x script por fora: comparação lado a lado

Critério Plugin dentro do Obsidian Script por fora
Unidade de trabalho a nota aberta, na maioria dos casos o vault inteiro, nota por nota
Quem dispara você, num comando da paleta ou ícone na ribbon a execução do script, quando você quiser
Onde fica a política nas settings do plugin (ex: a pasta Inbox do Jevault) em arquivo de código versionado, dentro do repositório do projeto
Esforço de instalação menor: o Auto Tagger (Jev) está listado no diretório de plugins da comunidade; colar a chave e usar maior: clonar o projeto, configurar chave de ambiente e entender a política antes de rodar
Controle sobre limiares o que o autor do plugin expôs nas settings total, você edita o arquivo de política
Revisão humana embutida no fluxo: sugestão na tela, você aceita (no Jevault, mover exige confirmação explícita) por desenho do projeto: no jev-the-janitor a pilha de baixa confiança fica separada pra revisão
Custo por rodada proporcional ao que é enviado por nota, sempre a US$ 0,042 por 1 milhão de tokens de entrada mesma tarifa, multiplicada pelo número de notas da varredura
O que quebra mais fácil depender de tag/pasta existente ruim: o plugin escolhe entre o que já existe no vault limiar mal calibrado agindo em massa sem ninguém olhando
Reprodutibilidade baixa: a decisão é do momento, no clique alta: mesma política, mesmo código, roda de novo

Dos plugins citados aqui, o Auto Tagger (Jev) é o que está listado no diretório de plugins da comunidade do Obsidian

Os outros vivem em repositório do GitHub, então o caminho de instalação deles não é "abre a loja e clica"

E não existe plugin ou script oficial da TypeSafe pro Obsidian: tudo que tá nesse post é feito por terceiros

Quando o caminho dentro do Obsidian ganha

O plugin ganha quando a decisão precisa acontecer ENQUANTO você escreve

É decisão de fluxo, não de faxina

Uma tag na nota aberta, sob demanda:

O Auto Tagger (Jev) faz exatamente uma coisa e faz bem

Você dispara o comando Auto-tag current note na paleta ou clica no ícone de tag na ribbon

O plugin lê o título e o começo do corpo da nota, junta as tags mais usadas do vault e faz UMA única pergunta Choice ao Jev

A notificação te mostra a tag escolhida e a confiança do modelo

Repara no escopo do que sai da tua máquina: título, início do corpo e os nomes das tags candidatas

E só quando tu dispara

Pra quem tem paranoia com vault (eu entendo, sério), esse desenho de "nada sai sem comando" é o ponto mais forte do caminho via editor

Onde essa nota deveria morar?

O Jevault resolve outra dor clássica: nota nova no lugar errado

O fluxo é: abre a nota, roda Jevault: Classify current note na paleta, olha as sugestões de pasta ranqueadas e escolhe clicando ou pelo número exibido, de 1 a 9

E o detalhe que me faz gostar do desenho: selecionar NÃO move a nota

A ação precisa de confirmação explícita

Ou seja, o modelo sugere, tu decide, e o arquivo só anda quando tu confirma

Nas configurações dá pra definir a pasta Inbox (caminho relativo ao vault) pra excluir ela e as subpastas das sugestões, escolher quantas sugestões aparecem e listar pastas excluídas

Isso é MUITO útil: sem isso, a Inbox viraria destino sugerido pra tudo, e o plugin ficaria empurrando nota de volta pra caixa de entrada haha

Acompanhamento contínuo, sem apertar nada:

O Jev Lens (repositório JoseEchave/obsidian-jev-lens) é o mais "ambiente" dos três

Ele avalia continuamente a nota em edição contra as lentes que você mesmo definiu, e mostra um emoji de semáforo na aba da nota e a pontuação por lente na barra de status

É feedback passivo: tu escreve e o semáforo vai te dizendo como a nota tá indo naquelas dimensões que TU escolheu

Duas decisões de engenharia dele valem nota:

  • ele relê a nota de lentes em cada avaliação, então mudar tua rubrica tem efeito na hora
  • ele usa endereçamento por hash do conteúdo, então nota inalterada não é enviada duas vezes, e nunca envia nota abaixo do tamanho mínimo

Tradução: avaliação contínua sem torrar requisição a cada tecla

A configuração é direta: habilitar em Settings > Community plugins e depois, em Settings > Jev Lens, colar a chave de API da TypeSafe e apontar o caminho da nota de lentes

O que Auto Tagger, Jevault e Jev Lens têm em comum:

Feedback imediato, e a decisão continua na tua mão

Nenhum desses três reescreve teu texto, e mexer em arquivo depende de você: no Jevault, por exemplo, mover a nota só acontece depois da confirmação explícita

É o Jev fazendo o que ele faz: devolvendo um valor com confiança, e o humano na cadeira sendo o executor

Quando processar o vault por fora rende mais

Agora inverte o cenário

Tu tem 3 mil notas de 2019 numa pasta chamada inbox-old e não vai abrir uma por uma pra apertar comando

Aqui o plugin perde feio, porque a unidade de trabalho dele é "a nota aberta"

O caminho por fora ganha em três situações bem específicas:

  1. Volume: triagem de milhares de notas antigas de uma vez
  2. Política: quando a regra que transforma probabilidade em ação precisa morar num arquivo, versionada, revisável
  3. Reprodutibilidade: quando tu quer rodar a MESMA política de novo em três meses e comparar

O jev-the-janitor como referência concreta:

O jev-the-janitor é um "zelador" pra vaults Markdown com uma ideia bem clara de divisão de trabalho: o Jev vota em cada nota, o código do usuário arquiva, e a pilha de baixa confiança fica pra revisão humana

A modelagem das perguntas é a parte mais didática do projeto

Tem um Score com a rubrica drop / park / promote, e como o Jev devolve posição ponderada por probabilidade, um 1.25 significa "entre park e promote, puxando pra park"

Sacou? Não é um rótulo seco, é uma posição na régua

E tem Nouls (o sim/não probabilístico) pra características objetivas, cada um devolvendo um valor entre 0 e 1:

  • contains_secret
  • looks_like_duplicate
  • records_a_decision
  • is_actionable
  • safe_to_leave_in_git

Como essas perguntas podem ir na mesma requisição e serem avaliadas em paralelo, perguntar tudo isso de uma vez por nota é barato em tempo

E aqui vem o conselho de arquitetura que eu acho o mais valioso do projeto inteiro: os limiares que transformam votos em ações ficam em janitor/policy.py, e a orientação é mudar os limiares ALI, não nas perguntas

Ou seja: a pergunta descreve o mundo, a política decide o que fazer com essa descrição

Se tu começar a torcer a pergunta pra conseguir a ação que quer, tu perdeu a calibração e não sabe mais o que o modelo tá te dizendo

Essa separação entre "medir" e "agir" é a mesma discussão de quando vale treinar seu próprio classificador em vez de chamar um modelo de decisão: o que muda não é o rótulo, é onde a regra de negócio vive

E se eu quiser lote sem sair do Obsidian?

Existe meio de campo 🙂

O Smart Tagger (repositório xinye1017/obsidian-smart-tagger) usa o Jev e oferece marcação em lote de dentro do Obsidian mesmo: dá pra escolher o vault inteiro (que é o padrão) ou uma pasta específica, incluindo os arquivos Markdown das subpastas

A chave de API vai nas configurações do plugin, em campo mascarado, e o resultado é comparado com um limite de confiança configurável

Com isso tu pode revisar as recomendações antes ou aplicar só as tags elegíveis

É o caminho pra quem quer o ganho de volume sem montar ambiente de script

O que tu NÃO leva nesse caminho é a política versionada em arquivo

Sobre rodar o script em si:

Um aviso pra não te deixar na mão: eu não vou te passar comando de instalação nem de execução do jev-the-janitor aqui, porque esse detalhe eu não consegui confirmar na fonte

Prefiro te mandar ler o repositório do projeto a te ensinar uma flag errada que faz faxina no teu vault

Os rm -rf da vida a gente aprende a respeitar depois da primeira vez, né? 😛

O que vale dizer é que a chave de API do Jev é criada no console da TypeSafe, em console.typesafe.ai > API Keys, e usada em código pela variável de ambiente TYPESAFE_API_KEY

Esse é o mesmo padrão de "agente/processo rodando sem humano no loop" que aparece quando a gente discute rodar agente dentro de um script: a hora que ninguém tá olhando a tela, a política precisa estar escrita antes

Veredito: qual escolher para o seu vault

Vou ser direto, por perfil:

Você escreve muito e quer resultado hoje: vai de plugin

Começa pelo Auto Tagger (Jev) se tua dor é tag, ou pelo Jevault se tua dor é "onde essa nota mora"

O ganho de ter a decisão a um comando de distância, com confiança visível, é imediato e reversível

Você tem backlog grande ou quer política versionada: vai de script

Se o teu problema é 2 mil notas paradas, plugin nota-por-nota não é caminho, é tortura

E se tu precisa justificar por que a nota X foi arquivada, a política em arquivo é a única coisa que te dá essa resposta seis meses depois

Você quer os dois (e é o que eu acho mais sensato): plugin no fluxo diário, script em rodadas periódicas

O plugin cuida do que tu escreve HOJE, o script faz a faxina do passado de vez em quando

São problemas diferentes, ferramentas diferentes, e a tarifa é a mesma nos dois: US$ 0,042 por 1 milhão de tokens de entrada, saída gratuita

As ressalvas honestas:

Duas, e as duas importam:

Primeira: o Jev aceita texto em linguagem natural, mas o inglês é a principal língua de treino e é onde a acurácia é melhor hoje

Se teu vault é todo em português, leva isso em conta antes de confiar cegamente num limiar apertado

Segunda, e essa é chata: os novos cadastros na TypeSafe estão pausados desde o anúncio de 22/09/2026, sem data de reabertura divulgada

Quem não tem conta pode ficar esperando, e nenhum dos dois caminhos sai do chão sem chave

Próximo passo

Se tu já tem chave criada no console, o caminho mais curto é: escolhe UM plugin da lista, cria uma nota de teste bem boba e dispara o comando

Você vai ver na hora se a confiança que o modelo devolve faz sentido pro teu vault ou se tuas tags e pastas existentes estão bagunçadas demais pra ele escolher bem

Spoiler: metade dos resultados ruins não é culpa do modelo, é do vault que nunca foi organizado haha

Se teu plano é o caminho por fora, começa lendo a política do jev-the-janitor ANTES de mexer em qualquer pergunta

Entender por que os limiares moram em janitor/policy.py e não na rubrica é o que separa uma faxina previsível de um arquivamento aleatório

E se tu tiver paciência pro experimento mais legal: pega o mesmo conjunto de 20 notas, passa pelo plugin e pela abordagem de script, e compara onde as decisões divergem

É ali, na divergência, que tu descobre qual dos dois caminhos entendeu o teu vault de verdade

Até o próximo post! 😀

Perguntas frequentes

Quanto custa usar o Jev no Obsidian pra marcar notas com tag?

O modelo jev-1.12 cobra US$ 0,042 por 1 milhão de tokens de entrada e a saída sai de graça, então uma marcação por nota (que é só uma pergunta Choice) custa uma fração mínima disso. O Smart Tagger, que faz lote no vault inteiro ou numa pasta, multiplica essa mesma tarifa pelo número de arquivos processados

Dá pra usar o Jev no Obsidian sem saber programar?

Dá sim, pelo menos com o Auto Tagger (Jev): ele está listado no diretório de plugins da comunidade do Obsidian, então é instalar, colar a chave da TypeSafe e disparar o comando ou o ícone na ribbon. Nenhum dos plugins citados nesse post pede que você escreva código, só configure settings

O Jev no Obsidian move ou renomeia arquivos automaticamente sem eu confirmar?

No Jevault não: ele mostra sugestões de pasta ranqueadas de 1 a 9 e mover a nota exige confirmação explícita depois que você escolhe. Nenhum dos plugins mapeados aqui aplica mudança estrutural no vault sem esse passo de aprovação

Preciso de conta paga na TypeSafe pra testar o Jev no Obsidian?

Você precisa de uma chave de API, criada no console.typesafe.ai na seção API Keys, e ela entra direto nas settings do plugin. Vale lembrar que novos cadastros no Jev estão pausados desde o anúncio de 22 de setembro de 2026 por excesso de demanda, mas quem já tem conta continua usando normal

Qual plugin de Jev no Obsidian avalia a nota em tempo real enquanto eu escrevo?

Esse é o Jev Lens: ele reavalia a nota em edição contra lentes definidas por você e mostra um emoji de semáforo na aba, com a pontuação por lente na barra de status. Pra economizar chamada, ele usa cache por hash de conteúdo, então nota que não mudou não é reenviada

O Jev no Obsidian funciona bem com notas em português?

O Jev aceita texto em linguagem natural em várias línguas, mas o inglês é a principal língua de treino e onde a acurácia é melhor hoje. Pra tag e classificação de pasta em vault português isso tende a funcionar, mas vale acompanhar a confiança que os plugins mostram antes de confiar de olhos fechados



Escrito por | Matheus Battisti

Matheus Battisti
Fundador da Hora de Codar

Programador apaixonado pelo mundo das tecnologias, sempre buscando em aprender e se aprofundar em linguagens, frameworks e o que mais for necessário para executar um bom trabalho. Agora tem uma nova missão que é de passar seu conhecimento adiante para formar novos programadores e especializar mais os que já são.

Formações

Formação Claude Code

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

  • 120 aulas
  • 4 projetos
  • 9h 48min

Blog | Mais populares