💬 Usar no dia a dia

Tudo que começa com / é comando: o orquestrador responde na hora, sem passar por modelo nenhum. O /ajuda lista todos em blocos; /ajuda <comando> abre o detalhe de um.

Comando é grátis e imediato; conversa passa pelo roteador e pode virar job. Saber o grupo certo evita gastar token para perguntar algo que um /status já responde.

Sete grupos · /ajuda e /ajuda <comando> · /chatid, /versao · comando nunca vira memória

A fila é um SQLite com lanes chat, agente, ollama, cron e io. /status mostra rodando e pendente por lane; /status <id> abre um job com resultado ou erro.

A lane agente roda um job por vez. Se um pedido demora, é a fila, não o bot travado. /cancelar e /prioridade resolvem sem restart.

Lane e concorrência · job nunca é apagado · /cancelar <id> · /prioridade <id> <n> só em queued

/tarefa add [quando] <texto> cria uma tarefa sua; se quando for reconhecido (em 2h, amanhã 9h, sex 10h, 15/09 14:30) vira lembrete. /daily resume tarefas, feitas em 24 h, custo, fila, Ollama e o MEMORY.md.

É a parte "Jarvis" mais simples e mais usada: você anota no chat e o bot cobra na hora certa. O cron daily-8h manda o resumo todo dia sem você pedir.

Formatos de quando · /tarefa lista · /tarefa feita <id> · cron lembretes a cada minuto

Cada cron vira um job na fila com idem_key = nome@ocorrência, então nunca dispara duas vezes. Padrão: lembretes, indexar-memoria, decaimento, consolidacao-noturna, backup-noturno, daily-8h, mais os de ingestão.

Metade do que o bot faz acontece de madrugada. Saber ler /cron lista diz se a memória está sendo indexada, consolidada e copiada em backup.

/cron on <nome> · /cron off <nome> · sessão isolada vs principal · heartbeat a cada 30 min

/agentes lista os agentes instalados com modelo e se são só leitura; /skills lista as skills (rascunho marcado). /novo limpa a sessão do CLI e o histórico do chat; /compress limpa só a sessão.

Uma sessão retomada carrega contexto por até 6 h. Quando o agente "insiste" em algo velho, /compress é a saída barata; /novo é o reset completo.

Sessão --resume · histórico do chat · skills só-metadata no prompt · skills/_rascunhos/

Pedido que precisa de ferramenta (arquivo, shell, repo, web, skill, calendário) vai para a rota agente: o bot avisa o nome do agente e o número do job, você acompanha com /status N e a resposta volta no mesmo chat.

Pedido vago vira job caro e resposta ruim. Um pedido com objetivo, onde e critério de pronto sai certo na primeira, e o custo real fica registrado no /usage.

Roteador decide direto vs agente · especialistas read-only + lead · /status N · store/saidas/job-N.txt quando a saída não pôde ser lida

Quatro depósitos: a tabela memories (FTS5 + salience), os vetores bge-m3 de cada memória, o conversation_log com todos os turnos e os insights gerados na consolidação.

Saber o que entra (e o que nunca entra, como pergunta) explica por que o bot lembra de umas coisas e esquece outras. Salience decide o que sobrevive.

semantic vs episodic · regex PT-BR · salience 1.0, +0.1 por uso, decai 0,5 % / 2 % ao dia · dedupe por hash

/memoria lista, /memoria buscar <termo>, /memoria salvar <texto> e /memoria esquecer <id> operam a memória. Em toda conversa o cérebro monta o contexto: 3 por palavra-chave, 3 por vetor, 3 mais importantes, 3 mais recentes, mais 3 insights, até 600 tokens.

O bot só "sabe" o que entra nesse contexto. Se um fato importante não aparece, é porque perdeu na busca ou estourou o teto, e você pode salvar de novo ou conferir com /context detail.

FTS5 (palavra) + cosseno (vetor) · vetores indexados a cada 15 min · /memoria salvar também propõe ao vault

O vault (~/vault/MEMORY.md e USER.md) é a memória curada, em Markdown, que você lê. Quando uma resposta direta detecta fato durável, o bot cria uma proposta; /memoria propostas lista, /memoria aprovar <id> grava, /memoria descartar <id> joga fora.

Nada é escrito no vault sem aprovação. USER.md entra no prompt de toda conversa: é o lugar de maior alavancagem para o bot te conhecer.

Proposta pendente · aprovada · descartada · VAULT_PATH · /daily mostra o MEMORY.md

Às 4h, no Ollama residente e a custo zero, o cron funde duplicatas (fica a mais recente), detecta contradições por data (a antiga recebe superseded_by, nunca é apagada) e gera até 3 insights por chat. /consolidar enfileira a mesma rotina agora.

É o que impede a memória de virar um saco de frases repetidas e contraditórias. Entender que a antiga fica marcada, não deletada, tira o medo de "perder contexto".

decaimento 3h30 · consolidacao-noturna 4h · backup-noturno 4h15 · lane ollama

Uma credencial OAuth do Google serve N contas; cada uma autentica uma vez (gmail.py --conta <alias> auth) e ganha token_gmail_<alias>.json. Grupos do Telegram entram em TELEGRAM_CHATS_OBSERVAR. Crons de ingestão leem o que chegou e extraem fatos no Ollama.

Acesso sem ingestão é o v2: o bot lê o e-mail e esquece. Com ingestão, o que passou nas fontes vira fato buscável, com origem por fonte e custo zero.

Acesso · observação · ingestão · /fontes · /fontes ingerir gmail|agenda · limites da Bot API · docs/CONECTORES.md

Memória de conversa guarda a frase inteira que você escreveu, não um fato extraído (só a ingestão de fontes extrai). Memória errada se corrige com /memoria esquecer <id> e, se for o caso, /memoria salvar com a versão certa.

Saber o limite evita esperar mágica: frase longa e ambígua vira memória longa e ambígua. Corrigir cedo custa um comando; deixar acumular custa uma consolidação inteira.

Frase, não fato · contradição: a nova vence, a antiga fica superseded · apagar uma fonte inteira com o serviço parado · /context detail