ravi

Inspeciona a autorização provider-runtime do Ravi. Use quando o usuário quiser: - Ver a cadeia ativa de providers de permissão - Verificar uma decisão provider-runtime - Materializar capabilities de um subject - Resolver denials com profiles/tags provider-owned - Aplicar autorização recorrente sem listas longas de capability

Gerencia jobs agendados do sistema Ravi. Use quando o usuário quiser: - Criar, listar ou deletar tarefas agendadas - Configurar cron expressions, intervalos ou horários específicos - Ativar/desativar jobs existentes - Executar jobs manualmente

Gerencia o Observation Plane do Ravi. Use quando precisar: - Listar, explicar ou atualizar observer bindings - Criar regras de observer por global/agent/session/task/profile/tag - Criar, validar ou pré-visualizar observer profiles Markdown - Configurar task observers como `observed-task` + profile `tasks`

Referência do sistema de eventos NATS. Use quando precisar: - Entender os tópicos e fluxo de eventos do Ravi - Emitir eventos manualmente via código - Debugar fluxo de mensagens entre componentes

Opera o canal Slack nativo do Ravi. Use quando o usuario quiser: - Criar, listar, inspecionar, renomear ou convidar pessoas para canais Slack - Enviar, ler, inspecionar ou dar replay em mensagens Slack - Criar, validar, enviar ou atualizar mensagens Slack Block Kit - Trabalhar com botoes, selects e eventos interativos do Slack nativo - Validar, publicar, unfurl e apresentar Work Objects nativos do Slack - Criar, publicar, editar ou gerenciar Slack Canvas - Publicar artifacts Markdown como Slack Canvas - Entender rotas, sessoes, threads, presenca/status ou topology do Slack nativo - Ver scopes/permissoes Slack e diagnosticar capacidades da integracao nativa

Receitas operacionais de automacao do Ravi. Use quando precisar: - Montar rotinas compostas com cron, triggers, sessions, media e state local - Implementar aprovacao por reaction sem perder correlacao de estado - Evitar automacoes que disparam LLM ou efeito externo sem necessidade - Documentar padroes reutilizaveis de rotina

Gerencia triggers de eventos do sistema Ravi. Use quando o usuário quiser: - Criar, listar, ver ou deletar triggers - Configurar reações automáticas a eventos CLI, watch, audit, TTS, artifacts e inbound normalizado - Ativar/desativar triggers existentes - Testar triggers manualmente

Gerencia canais de comunicação do Ravi. Use quando o usuário quiser: - Ver status das instâncias WhatsApp, Slack, Discord, Telegram - Conectar ou desconectar contas - Configurar policies de DM e grupo por instância - Verificar QR code de pareamento - Troubleshoot problemas de conexão

Cria e refatora CLIs no ecossistema Ravi, aterrado na arquitetura REAL do runtime. Cobre as duas famílias (CLI nativo do Ravi = classe com decorators auto-descoberta; CLI standalone/domínio = binário próprio), o contrato de decorators (@Group/@Command/@Arg/@Option/@CommandAccess/@Returns/@Scope), output agent-first (mandato --json, stdout=dado/stderr=log, exit 0/1, helper fail(), IDs semânticos), paginação real (páginas limitadas 50/500 + nextCommand), gate de --help padrão-ouro, e os meta-testes de CI que são a lei do repo. Use quando criar nova ferramenta CLI, refatorar CLI existente, padronizar comandos, ou integrar CLI ao runtime com RAVI_CONTEXT_KEY. Skill standalone — o essencial de --help e de skill→cli está inline; cli-help-engineering e dissolving-skills-into-cli-help são aprofundamento opcional. NÃO cobre: criar a skill que ensina o CLI (use skill-creator).

Gerencia rotas de mensagens do Ravi. Use quando o usuário quiser: - Criar, listar ou remover rotas - Direcionar contatos/grupos/threads para agents específicos - Configurar prioridade, policy e dmScope de rotas - Ver qual agent atende qual padrão

Gerencia sessões do sistema Ravi. Use quando o usuário quiser: - Listar, ver detalhes ou renomear sessões - Resetar ou deletar sessões - Configurar modelo ou thinking level por sessão - Limpar sessões inativas com dry-run e filtros explícitos - Criar sessões efêmeras com TTL - Estender, manter ou excluir sessões efêmeras - Enviar prompts, perguntas ou comandos entre sessões - Ler histórico de mensagens de uma sessão - Inspecionar trace SQLite de uma sessão para incidentes de runtime/canal - Atachar um chat como output target de uma sessão - Atachar múltiplos chats numa mesma sessão sem fork de histórico

Gera imagens via OpenAI (gpt-image-2 padrão) ou Gemini. Use quando o usuário pedir: - Gerar uma imagem a partir de texto - Editar/transformar uma imagem existente - Criar logos, ilustrações, arte - Mockups de UI, infográficos, ads

Opera reunioes nativas do Ravi. Use quando precisar: - Fazer um agent entrar em Google Meet como participante visivel - Gravar/capturar uma reuniao e gerar artifact raw meet.md - Rodar modo live com runtime nativo do Ravi e agent registrado - Finalizar runs do meet-recorder em artifacts do Ravi - Auditar eventos, transcricao, midias e diagnosticos de uma meeting

Gerencia agents do sistema Ravi. Use quando o usuário quiser: - Criar, configurar ou deletar agents - Gerenciar permissões de tools (whitelist/bypass) - Configurar permissões de Bash (allowlist/denylist) - Ver ou resetar sessões de agents - Configurar debounce de mensagens - Entender como rotear mensagens pra um agent

Gerencia Ravi Apps. Use quando precisar: - Listar, mostrar ou validar manifests de apps - Criar scaffold de um novo Ravi App - Entender interfaces CLI, SDK, UI, tool e stream de um app - Usar operations, storage, events, artifacts, skills e health checks declarados em ravi.app.json - Ensinar agentes a operar apps via `ravi <app-id> <operation>`

Gera áudio (TTS) via ElevenLabs. Use quando o usuário quiser: - Converter texto em fala - Gerar áudio narrado - Enviar mensagem de voz gerada - Criar podcast/narração

Analisa vídeos do YouTube ou arquivos locais. YouTube usa legendas primeiro e Gemini como fallback. Use quando o usuário quiser: - Assistir/analisar um vídeo do YouTube - Transcrever um vídeo - Entender o conteúdo de um vídeo - Extrair informações de um vídeo

Gerencia o ledger genérico de artifacts do Ravi. Use quando precisar: - Registrar outputs reutilizáveis de qualquer parte do Ravi - Encontrar de onde um artifact veio e quais metadados e métricas ele carregou - Editar metadata, anexar artifacts a tasks/sessões/projetos ou arquivar artifacts - Auditar lineage de imagens, reports, traces, documentos, tool outputs e mensagens

Gerencia funcionalidades do WhatsApp via Baileys. Use quando o usuário quiser: - Criar, gerenciar ou sair de grupos - Adicionar/remover membros de grupos - Gerar ou revogar links de convite - Renomear grupos ou mudar descrição - Alterar configurações de grupo (anúncio, locked) - Entrar em grupo via link de convite - Listar todos os grupos que o bot participa

Use when creating, reviewing, or debugging `.ravi/rules` runtime prompt rules: - adding workspace/fleet rules that must be injected into built system prompts - diagnosing missing or duplicated `## Ravi Rules` sections - changing runtime prompt assembly around rules, AGENTS.md, or provider fallbacks - deciding whether a rule belongs in `.ravi/rules`, AGENTS.md, a spec, or an agent prompt

Orquestra a configuração inicial do Ravi via recipes + plano determinístico. Use quando precisar: - Mapear a intenção de um usuário e propor um setup completo - Escolher (ou compor) uma recipe do catálogo e parametrizar - Gerar um plano auditável de operações antes de aplicar - Executar o plano em batches com confirmação em operações irreversíveis - Emitir setup spec + task profiles + cron entries ao final - Reverter (undo) um run prévio ou reconciliar com uma nova versão de recipe

Opera o CRM nativo do Ravi sobre contatos. Use quando precisar: - Ler ou atualizar card CRM de um contato - Criar contas, oportunidades, stakeholders e follow-ups - Propor, confirmar ou rejeitar facts de CRM com evidencia - Ensinar agentes a trabalhar com relacionamento, pipeline e next actions - Decidir quando escrever campo forte versus proposta revisavel

Gerencia contatos do sistema Ravi. Use quando o usuário quiser: - Listar, adicionar, aprovar ou bloquear contatos - Ver contatos pendentes de aprovação - Garantir captura automática de contatos a partir de DMs/chats - Rodar backfill de contatos canônicos a partir do ledger de chats - Configurar agent ou modo de resposta por contato - Adicionar/remover tags ou buscar por tags - Ver detalhes de um contato específico

Gerencia instâncias de canais do Ravi. Use quando o usuário quiser: - Criar, listar ou configurar instâncias (contas omni) - Conectar/desconectar contas WhatsApp, Matrix, etc - Definir policies de DM e grupo por instância - Configurar contact intake automático por instância - Gerenciar rotas de uma instância específica - Aprovar ou rejeitar pendências de acesso

Gerencia o engine de auto-tagging do Ravi. Use quando precisar: - Criar, validar, listar ou explicar tag rules - Aplicar regras manualmente em um contato ou em todos via tick - Entender como rules disparam reativas em mensagens novas - Modelar workflows com transições de tags (lifecycle:new → lifecycle:qualified)

Gerencia o task runtime profile-aware do Ravi. Use quando precisar: - Criar, listar ou inspecionar tasks - Escolher e operar profiles do catálogo - Despachar trabalho para um agent - Sincronizar progresso, blocker ou conclusão no runtime - Entender como funciona o fluxo task -> profile -> artifacts -> CLI -> DB/NATS

Gerencia configurações globais do Ravi. Use quando o usuário quiser: - Ver ou alterar configurações do sistema - Definir agent default - Configurar DM scope padrão - Ver todas as settings disponíveis

Gerencia Ravi Commands. Use quando precisar: - Criar, listar, mostrar, validar ou previewar comandos `#nome` - Editar arquivos Markdown em `.ravi/commands` ou `$RAVI_HOME/commands` - Entender como `#command` vira prompt composto antes do runtime - Debugar por que um comando foi expandido, falhou ou passou como chat normal - Usar o CLI `ravi commands`

Gerencia os skill gates do Ravi. Use quando precisar: - Entender por que uma tool carrega uma skill automaticamente - Listar regras default e overrides de skill gates - Criar novas regras para tools, grupos ou comandos shell - Sobrescrever, desativar ou resetar gates existentes - Usar o CLI `ravi skill-gates`

DEPRECATED. Matrix-specific management is not a supported Ravi CLI surface. Use this only to redirect away from legacy `ravi matrix ...`, `agents.matrix_account`, and `matrix_accounts` flows toward Ravi channel, instance, contact, chat, and route abstractions.

Opera prox.city Calls no Ravi. Use quando precisar: - Fazer ligacoes via `ravi prox calls` - Escolher ou explicar provider ElevenLabs/Twilio vs Agora SIP - Configurar call profiles, first message, prompt, pipeline/agent id e numero de origem - Consultar eventos, transcript e resultado de calls - Debugar webhooks, hangup por `end_call`, quiet-hours/rules e modo `--force`

Usa o eval harness do Ravi para medir trabalho real. Use quando o usuário quiser: - Testar um agent, skill ou workflow de forma reproduzível - Criar ou rodar task specs de benchmark - Validar regressão de comportamento no Ravi - Comparar motores, agents ou prompts no mesmo terreno

DEPRECATED. Compatibility alias for old TASK.md-first task handling. Use `ravi-system-tasks` for all current Ravi task runtime work.

Documentacao completa da arquitetura do Ravi. Use quando precisar: - Entender como o sistema funciona end-to-end - Modificar componentes existentes - Adicionar novos subsistemas - Debugar fluxos de mensagem - Onboarding no codebase

Gerencia a memória versionada de regras/specs do Ravi. Use quando precisar: - Criar ou consultar regras por domain/capability/feature - Recuperar contexto normativo antes de editar código - Linkar specs a Projects como contexto ou auditoria futura - Reindexar `.ravi/specs` no SQLite

Controla o daemon do Ravi. Use quando o usuário quiser: - Ver status do daemon - Reiniciar o daemon - Ver logs - Instalar/desinstalar serviço do sistema

Guia para criar, instalar e inspecionar skills no Ravi. Use quando o usuário quiser: - Instalar skills oficiais do catálogo do Ravi - Instalar skills de um repositório ou path local - Listar ou ver o conteúdo de skills pelo CLI - Criar uma nova skill - Entender como skills funcionam - Configurar frontmatter de skills - Adicionar skills a plugins

Documenta o sistema de construcao de prompts do Ravi. Use quando precisar: - Entender como system prompts sao montados - Adicionar novas secoes ao prompt - Modificar formatacao por canal - Entender injecao de contexto (grupo, reactions, runtime) - Criar novas regras de output por plataforma

Gerencia a biblioteca oficial de stickers do Ravi. Use quando o usuário quiser: - Adicionar, listar, mostrar, remover ou enviar stickers - Entender quando stickers aparecem no prompt - Configurar opt-in de stickers por agent - Verificar suporte WhatsApp-only para envio de stickers

Opera Projects no Ravi como camada de alignment/contexto. Use quando precisar: - Criar, listar, mostrar ou atualizar projects - Iniciar/anexar workflow runs a um project - Criar/anexar/despachar tasks a partir de project + workflow node - Gerenciar resources/links baratos de project - Seedar fixtures canônicas de project -> workflow -> task