cadencia-cli — Referência completa de comandos¶
Gerado automaticamente do registry (
src/cadencia_cli/registry.py+actions/). Fonte de verdade: o código. Para regenerar:python tools/gen_commands_doc.py. Resumo operacional para agentes:pd-framework/_core/CADENCIA-CLI.md. Projeto Linear: Cadencia — CLI/MCP de Controle (7648831d).
Modelo de acesso e segurança¶
Não há login nem credencial própria do cadencia-cli. A autenticação é herdada do ambiente:
| Recurso | Credencial usada | Como resolve | Alcance |
|---|---|---|---|
| CRM + Conteúdo (leitura/escrita) | PAT do Supabase (item 1P Supabase - ClaudeCode - CLI) via Management API | op (Service Account headless) ou env SUPABASE_ACCESS_TOKEN | Admin de TODOS os projetos Supabase do Felipe — bypassa RLS |
Disparo de worker (growth/newsletter-dispatch) | Chave SSH hostinger_prod_master | arquivo ~/.ssh/hostinger_prod_master | Shell na VPS Master de produção |
Consequência direta: quem tiver acesso a um shell onde OP_SERVICE_ACCOUNT_TOKEN/SUPABASE_ACCESS_TOKEN esteja disponível acessa o Cadencia inteiro (todos os tenants — o PAT é admin e ignora RLS), e quem tiver a chave SSH dispara workers em produção. A barreira de segurança é o acesso ao ambiente/credencial, não a CLI.
- A blindagem por
tenant_idno código protege contra erro de programação (vazar dado de outro tenant por engano), não contra quem detém o PAT — esse pode ignorar a CLI e falar direto com o Supabase. - Hardening planejado (DEV-582): token de serviço dedicado e escopado por tenant, substituindo o PAT admin nas mutações. Reduz o "tudo ou nada".
- Recomendação: tratar
OP_SERVICE_ACCOUNT_TOKENehostinger_prod_mastercomo segredos de produção; só em máquinas do Felipe / agentes confiáveis.
Setup¶
cd "Hub Projetos/_repos/cadencia-cli" && pip install -e .
# Credencial resolve sozinha pelo 1Password (Service Account). Override opcional:
export SUPABASE_ACCESS_TOKEN=$(op item get "Supabase - ClaudeCode - CLI" --vault databases --fields credencial --reveal)
# Tenant default = PD. Outro tenant:
export CADENCIA_TENANT_ID=<uuid>
Legenda de access-type¶
- 🟢 READ — leitura (Supabase select/search). Seguro.
- 🟡 WRITE — CRUD sem lógica de negócio (insert/update blindado por tenant).
- 🔴 MUTATION — mutação com lógica de negócio (crédito/idempotência). Bloqueado até DEV-582.
- 🟠 DISPATCH — dispara worker via SSH na VPS Master. Sem
--send= preview.
cadences — Cadências (CRM — setup/templates)¶
cadencia-cli cadences add-step — 🟡 WRITE¶
Adiciona um passo a uma cadência.
cadencia-cli cadences add-step [--cadence ..] [--channel ..] [--order ..] [--day ..] [--name ..] [--subject ..] [--body ..] [--manual ..]
Opções: - --cadence — Cadência (id ou system_key). - --channel — Canal: email | whatsapp | call | instagram | linkedin | sms. - --order — Ordem do passo. Auto (último+1) se omitido. - --day (default: 0) — Dia da cadência em que o passo dispara (offset). - --name — Nome do passo (rótulo). - --subject — Template de assunto (email). - --body — Template do corpo da mensagem. - --manual (default: False) — Passo manual (is_auto=false). Default é automático.
cadencia-cli cadences create — 🟡 WRITE¶
Cria uma cadência custom no tenant.
cadencia-cli cadences create [--name ..] [--key ..] [--category ..] [--duration-days ..] [--active ..]
Opções: - --name — Nome da cadência (ex.: Onboarding 14D). - --key — system_key (a-z0-9_). Derivado do nome se omitido. - --category — Categoria (ex.: prospeccao, followup, onboarding). - --duration-days — Duração em dias. - --active (default: False) — Marca a cadência como ativa.
cadencia-cli cadences list — 🟢 READ¶
Lista as cadências do tenant.
cadencia-cli cadences steps — 🟢 READ¶
Lista os passos de uma cadência.
Opções: - --cadence — Cadência (id ou system_key).
companies — Empresas (CRM)¶
cadencia-cli companies contacts — 🟢 READ¶
Lista os contatos vinculados a uma empresa.
Argumentos: company_id — ID da empresa.
cadencia-cli companies create — 🟡 WRITE¶
Cria uma empresa no tenant.
cadencia-cli companies create [--razao-social ..] [--nome-fantasia ..] [--cnpj ..] [--setor ..] [--cidade ..] [--uf ..] [--telefone ..] [--email ..] [--site ..] [--endereco-logradouro ..] [--endereco-numero ..] [--endereco-complemento ..] [--endereco-bairro ..] [--endereco-cep ..]
Opções: - --razao-social — Razão social. - --nome-fantasia — Nome fantasia. - --cnpj — CNPJ. - --setor — Setor. - --cidade — Cidade. - --uf — UF (2 letras). - --telefone — Telefone comercial. - --email — E-mail comercial. - --site — Site. - --endereco-logradouro — Logradouro. - --endereco-numero — Número. - --endereco-complemento — Complemento. - --endereco-bairro — Bairro. - --endereco-cep — CEP.
cadencia-cli companies get — 🟢 READ¶
Mostra uma empresa (campos ricos).
Argumentos: company_id — ID da empresa.
cadencia-cli companies link-contact — 🟡 WRITE¶
Vincula um contato a uma empresa.
Argumentos: company_id — ID da empresa.
Opções: - --contact — ID do contato. - --role — Papel do contato na empresa (ex.: socio, gestor).
cadencia-cli companies list — 🟢 READ¶
Lista empresas do tenant.
Opções: - --limit (default: 20) — Máximo de empresas. - --setor — Filtra por setor.
cadencia-cli companies search — 🟢 READ¶
Busca empresas por razão/fantasia/CNPJ.
Argumentos: term — Termo a buscar.
Opções: - --limit (default: 20)
cadencia-cli companies update — 🟡 WRITE¶
Edita campos de uma empresa.
cadencia-cli companies update <company_id> [--razao-social ..] [--nome-fantasia ..] [--setor ..] [--cidade ..] [--uf ..] [--telefone ..] [--email ..] [--site ..] [--endereco-logradouro ..] [--endereco-numero ..] [--endereco-complemento ..] [--endereco-bairro ..] [--endereco-cep ..]
Argumentos: company_id — ID da empresa.
Opções: - --razao-social — Razão social. - --nome-fantasia — Nome fantasia. - --setor — Setor. - --cidade — Cidade. - --uf — UF (2 letras). - --telefone — Telefone comercial. - --email — E-mail comercial. - --site — Site. - --endereco-logradouro — Logradouro. - --endereco-numero — Número. - --endereco-complemento — Complemento. - --endereco-bairro — Bairro. - --endereco-cep — CEP.
contacts — Contatos (CRM)¶
cadencia-cli contacts activities — 🟢 READ¶
Lista a timeline de atividades de um contato.
Argumentos: contact_id — ID do contato.
Opções: - --type — Filtra por tipo (ex.: call.made). - --limit (default: 50) — Máximo de atividades.
cadencia-cli contacts activity — 🟡 WRITE¶
Registra uma atividade/touchpoint no contato.
cadencia-cli contacts activity <contact_id> [--type ..] [--note ..] [--direction ..] [--duration ..] [--scheduled-at ..]
Argumentos: contact_id — ID do contato.
Opções: - --type — Tipo (ex.: call.made, email.sent, whatsapp.sent). - --note — Detalhe opcional (vai no payload). - --direction — Sentido do contato (inbound/outbound). - --duration — Duração em minutos (calls). - --scheduled-at — Quando estava agendado (ISO8601).
cadencia-cli contacts add-email — 🟡 WRITE¶
Anexa um e-mail adicional ao contato (sem trocar o principal).
Argumentos: contact_id — ID do contato., email — E-mail adicional.
cadencia-cli contacts add-phone — 🟡 WRITE¶
Anexa um telefone adicional ao contato (sem trocar o principal).
Argumentos: contact_id — ID do contato., phone — Telefone adicional.
cadencia-cli contacts create — 🟡 WRITE¶
Cria um contato no tenant.
cadencia-cli contacts create [--first-name ..] [--last-name ..] [--email ..] [--phone ..] [--status ..] [--lead-source ..] [--temperatura ..] [--is-icp ..] [--lifecycle ..] [--score ..] [--cpf ..] [--registro-profissional ..] [--endereco-logradouro ..] [--endereco-numero ..] [--endereco-complemento ..] [--endereco-bairro ..] [--endereco-cidade ..] [--endereco-uf ..] [--endereco-cep ..]
Opções: - --first-name — Primeiro nome. - --last-name — Sobrenome. - --email — E-mail. - --phone — Telefone/WhatsApp. - --status — Status. - --lead-source — Origem (evento/indicacao/inbound/linkedin/outbound). - --temperatura — Temperatura (frio/morno/quente/hot). - --is-icp — Marca como ICP (true/false). - --lifecycle — Lifecycle (lead/cliente/ex_cliente; aceita customer→cliente, churned→ex_cliente). - --score — Score 0–100. - --cpf — CPF (com ou sem formatação). - --registro-profissional — Conselho + número (ex: 'CRO RJ 29991'). - --endereco-logradouro — Logradouro (rua/avenida). - --endereco-numero — Número. - --endereco-complemento — Complemento. - --endereco-bairro — Bairro. - --endereco-cidade — Cidade. - --endereco-uf — UF (2 letras). - --endereco-cep — CEP.
cadencia-cli contacts emails — 🟢 READ¶
Lista todos os e-mails do contato (principal + adicionais).
Argumentos: contact_id — ID do contato.
cadencia-cli contacts enrich — 🔴 MUTATION¶
[BLOQUEADO até DEV-582] Enriquece um contato (debita crédito).
Argumentos: contact_id — ID do contato.
cadencia-cli contacts find — 🟢 READ¶
Resolve contato por nome/e-mail/telefone (inclui adicionais).
Opções: - --name — Parte do nome (ILIKE). - --email — E-mail (principal ou adicional). - --phone — Telefone (principal ou adicional; compara dígitos). - --limit (default: 10) — Máximo de resultados.
cadencia-cli contacts get — 🟢 READ¶
Mostra um contato (campos ricos).
Argumentos: contact_id — ID do contato.
cadencia-cli contacts import — 🟡 WRITE¶
Importa contatos em lote de um CSV (dedupe por email/telefone).
cadencia-cli contacts import [--file ..] [--delimiter ..] [--map ..] [--lead-source ..] [--dry-run ..]
Opções: - --file — Caminho do CSV (cabeçalho na 1ª linha). - --delimiter (default: ,) — Delimitador do CSV (use ';' p/ planilhas BR). - --map — Mapeamento extra 'csvcol=campo;...' (sobrepõe aliases). - --lead-source — lead_source default p/ todas as linhas sem valor. - --dry-run (default: False) — Não grava; só reporta o que faria.
cadencia-cli contacts link-company — 🟡 WRITE¶
Vincula um contato a uma empresa.
Argumentos: contact_id — ID do contato.
Opções: - --company — ID da empresa. - --role — Papel do contato na empresa (ex.: socio, gestor).
cadencia-cli contacts list — 🟢 READ¶
Lista contatos do tenant.
cadencia-cli contacts list [--limit ..] [--status ..] [--is-icp ..] [--temperatura ..] [--lead-source ..] [--lifecycle ..] [--pipeline ..] [--stage ..] [--tag ..]
Opções: - --limit (default: 20) — Máximo de contatos. - --status — Filtra por status. - --is-icp — Filtra por is_icp. - --temperatura — Filtra por temperatura (frio/morno/quente/hot). - --lead-source — Filtra por origem do lead. - --lifecycle — Filtra por lifecycle (lead/cliente/ex_cliente; aceita aliases EN). - --pipeline — Lista contatos com oportunidade neste pipeline (slug ou id). - --stage — Lista contatos com oportunidade neste stage (slug ou id). - --tag — Lista contatos com esta tag (label ou id).
cadencia-cli contacts note — 🟡 WRITE¶
Cria uma nota num contato.
Argumentos: contact_id — ID do contato.
Opções: - --body — Texto da nota.
cadencia-cli contacts notes — 🟢 READ¶
Lista as notas de um contato.
Argumentos: contact_id — ID do contato.
cadencia-cli contacts phones — 🟢 READ¶
Lista todos os telefones do contato (principal + adicionais).
Argumentos: contact_id — ID do contato.
cadencia-cli contacts remove-email — 🟡 WRITE¶
Remove um e-mail adicional do contato (não toca no principal).
Argumentos: contact_id — ID do contato., email — E-mail adicional a remover.
cadencia-cli contacts remove-phone — 🟡 WRITE¶
Remove um telefone adicional do contato (não toca no principal).
Argumentos: contact_id — ID do contato., phone — Telefone adicional a remover.
cadencia-cli contacts search — 🟢 READ¶
Busca contatos por nome/e-mail/telefone.
Argumentos: term — Termo a buscar.
Opções: - --limit (default: 20)
cadencia-cli contacts tag add — 🟡 WRITE¶
Adiciona uma tag a um contato (label ou id).
Argumentos: contact_id — ID do contato.
Opções: - --tag — Tag por label ou id.
cadencia-cli contacts tag list — 🟢 READ¶
Lista as tags de um contato.
Argumentos: contact_id — ID do contato.
cadencia-cli contacts tag remove — 🟡 WRITE¶
Remove uma tag de um contato (label ou id).
Argumentos: contact_id — ID do contato.
Opções: - --tag — Tag por label ou id.
cadencia-cli contacts update — 🟡 WRITE¶
Edita campos de um contato.
cadencia-cli contacts update <contact_id> [--first-name ..] [--last-name ..] [--email ..] [--phone ..] [--status ..] [--lead-source ..] [--temperatura ..] [--is-icp ..] [--lifecycle ..] [--score ..] [--cpf ..] [--registro-profissional ..] [--endereco-logradouro ..] [--endereco-numero ..] [--endereco-complemento ..] [--endereco-bairro ..] [--endereco-cidade ..] [--endereco-uf ..] [--endereco-cep ..]
Argumentos: contact_id — ID do contato.
Opções: - --first-name — Primeiro nome. - --last-name — Sobrenome. - --email — E-mail. - --phone — Telefone/WhatsApp. - --status — Status. - --lead-source — Origem (evento/indicacao/inbound/linkedin/outbound). - --temperatura — Temperatura (frio/morno/quente/hot). - --is-icp — Marca como ICP (true/false). - --lifecycle — Lifecycle (lead/cliente/ex_cliente; aceita customer→cliente, churned→ex_cliente). - --score — Score 0–100. - --cpf — CPF (com ou sem formatação). - --registro-profissional — Conselho + número (ex: 'CRO RJ 29991'). - --endereco-logradouro — Logradouro (rua/avenida). - --endereco-numero — Número. - --endereco-complemento — Complemento. - --endereco-bairro — Bairro. - --endereco-cidade — Cidade. - --endereco-uf — UF (2 letras). - --endereco-cep — CEP.
content — Conteúdo / Marketing¶
cadencia-cli content calendar-add — 🟡 WRITE¶
Agenda um post num canal (seta *_scheduled_at).
Argumentos: post_id — ID do post.
Opções: - --date — Data/hora ISO8601 (ex.: 2026-06-30T11:00:00). - --canal — blog/linkedin/seinfeld/instagram.
cadencia-cli content calendar-gap — 🟢 READ¶
Mostra dias sem conteúdo na janela (buraco editorial).
Opções: - --week/--no-week (default: True) — Janela = hoje..+7 dias (default). - --from — Início ISO. - --to — Fim ISO.
cadencia-cli content calendar-list — 🟢 READ¶
Grade editorial: conteúdo agendado/publicado na janela.
Opções: - --week/--no-week (default: True) — Janela = hoje..+7 dias (default). - --from — Início ISO (sobrepõe --week). - --to — Fim ISO.
cadencia-cli content carousel-dispatch — 🔴 MUTATION¶
[BLOQUEADO até DEV-582] Dispara carrossel/reels.
Opções: - --content-idea-id — ID da ideia (usado quando desbloqueado).
cadencia-cli content cover-set — 🟡 WRITE¶
Define a capa de um post (capa_url + featured_image_url).
Argumentos: post_id — ID do post.
Opções: - --image — URL da imagem de capa. - --alt — Texto alternativo (cover_alt).
cadencia-cli content derive — 🟡 WRITE¶
Cria uma ideia derivada de um post existente.
Opções: - --from-post — ID do post de origem. - --to — Formato derivado (carrossel/reels/thread/linkedin).
cadencia-cli content documents-create — 🟡 WRITE¶
Cria um documento de conteúdo.
cadencia-cli content documents-create [--idea-id ..] [--caption ..] [--carousel-model ..] [--status ..]
Opções: - --idea-id — ID da ideia de origem (obrigatório). - --caption — Legenda do documento. - --carousel-model — Modelo de carrossel. - --status (default: draft) — Status do documento (default draft).
cadencia-cli content documents-delete — 🟡 WRITE¶
Remove um documento de conteúdo de vez (DESTRUTIVO — exige --yes).
Argumentos: document_id — ID do documento.
Opções: - --yes (default: False) — Confirma a remoção definitiva (obrigatório — destrutivo).
cadencia-cli content documents-get — 🟢 READ¶
Mostra um documento de conteúdo.
Argumentos: document_id — ID do documento.
cadencia-cli content documents-list — 🟢 READ¶
Lista documentos de conteúdo.
Opções: - --limit (default: 20) - --status — Filtra por status. - --idea-id — Filtra por ideia.
cadencia-cli content documents-publish — 🟡 WRITE¶
Marca o publish_status de um documento.
Argumentos: document_id — ID do documento.
Opções: - --status (default: published) — publish_status (default published).
cadencia-cli content documents-update — 🟡 WRITE¶
Edita um documento de conteúdo.
Argumentos: document_id — ID do documento.
Opções: - --caption — Legenda. - --hashtags — Hashtags (texto). - --status — Status.
cadencia-cli content growth-dispatch — 🟠 DISPATCH¶
Dispara geração no worker growth (via SSH na VPS).
cadencia-cli content growth-dispatch [--channel ..] [--content-idea-id ..] [--dry-run ..] [--send ..]
Opções: - --channel — Canal (blog/seinfeld/linkedin/instagram). - --content-idea-id — ID da ideia (só blog). - --dry-run (default: False) — Roda o script em modo dry-run (só blog; não publica). - --send (default: False) — Dispara de verdade (gera conteúdo + custo).
cadencia-cli content ideas-create — 🟡 WRITE¶
Cria uma ideia de conteúdo.
cadencia-cli content ideas-create [--title ..] [--description ..] [--editorial-id ..] [--keywords ..]
Opções: - --title — Título da ideia. - --description — Descrição. - --editorial-id — Editorial. - --keywords — Palavras-chave separadas por vírgula.
cadencia-cli content ideas-delete — 🟡 WRITE¶
Remove uma ideia de conteúdo.
Argumentos: idea_id — ID da ideia.
cadencia-cli content ideas-get — 🟢 READ¶
Mostra uma ideia de conteúdo.
Argumentos: idea_id — ID da ideia.
cadencia-cli content ideas-list — 🟢 READ¶
Lista ideias de conteúdo do tenant.
Opções: - --limit (default: 20) — Máximo de ideias. - --status — Filtra por status. - --editorial-id — Filtra por editorial.
cadencia-cli content ideas-status — 🟡 WRITE¶
Muda o status de uma ideia.
Argumentos: idea_id — ID da ideia.
Opções: - --status — Novo status (draft/pending/used/rejected).
cadencia-cli content ideas-update — 🟡 WRITE¶
Edita uma ideia de conteúdo.
cadencia-cli content ideas-update <idea_id> [--title ..] [--description ..] [--editorial-id ..] [--keywords ..]
Argumentos: idea_id — ID da ideia.
Opções: - --title — Título. - --description — Descrição. - --editorial-id — Editorial. - --keywords — Palavras-chave separadas por vírgula (substitui).
cadencia-cli content image-upload — 🟡 WRITE¶
Sobe uma imagem ao Storage do tenant e retorna a URL pública.
Argumentos: arquivo — Caminho do arquivo de imagem local (png/jpg/jpeg/webp/gif/svg).
Opções: - --alt — Texto alternativo (sugere o cover-set pronto na saída). - --bucket (default: content) — Bucket de Storage (default: content, público).
cadencia-cli content newsletter-dispatch — 🟠 DISPATCH¶
Dispara a newsletter (worker growth, via SSH).
Opções: - --send (default: False) — Dispara de verdade.
cadencia-cli content publish — 🟡 WRITE¶
Ideia → enfileira → dispara, num passo (blog).
cadencia-cli content publish [--title ..] [--channel ..] [--keywords ..] [--description ..] [--send ..]
Opções: - --title — Título da ideia/post. - --channel (default: blog) — Canal (blog suporta idea-id). - --keywords — Palavras-chave separadas por vírgula. - --description — Descrição da ideia. - --send (default: False) — Dispara o worker de verdade (gera + publica).
cadencia-cli content published-create — 🟡 WRITE¶
Cria um post de blog com texto próprio (bypass worker).
cadencia-cli content published-create [--title ..] [--html-content ..] [--slug ..] [--keyword ..] [--meta-description ..] [--capa-url ..] [--status ..]
Opções: - --title — Título do post (obrigatório). - --html-content — HTML/markdown do corpo. - --slug — Slug do post. - --keyword — Palavra-chave SEO. - --meta-description — Meta description SEO. - --capa-url — URL da capa. - --status (default: archived) — Status (published/archived; default archived = fora do ar).
cadencia-cli content published-delete — 🟡 WRITE¶
Remove um post publicado de vez (DESTRUTIVO — exige --yes).
Argumentos: post_id — ID do post.
Opções: - --yes (default: False) — Confirma a remoção definitiva (obrigatório — destrutivo).
cadencia-cli content published-get — 🟢 READ¶
Mostra um post publicado (detalhe rico).
Argumentos: post_id — ID do post.
cadencia-cli content published-list — 🟢 READ¶
Lista posts publicados.
Opções: - --limit (default: 20) - --status — Filtra por status. - --formato — Filtra por formato.
cadencia-cli content published-unpublish — 🟡 WRITE¶
Tira um post do ar (status != published).
Argumentos: post_id — ID do post.
cadencia-cli content published-update — 🟡 WRITE¶
Edita um post publicado.
cadencia-cli content published-update <post_id> [--title ..] [--headline ..] [--html-content ..] [--legenda ..] [--capa-url ..] [--status ..] [--linkedin-text ..] [--seinfeld-body ..]
Argumentos: post_id — ID do post.
Opções: - --title — Título. - --headline — Headline. - --html-content — Corpo HTML/markdown. - --legenda — Legenda. - --capa-url — URL da capa. - --status — Status (published/archived). - --linkedin-text — Texto próprio do LinkedIn (published_posts.linkedin_text). - --seinfeld-body — Corpo próprio do e-mail Seinfeld (published_posts.seinfeld_body).
cadencia-cli content queue-enqueue — 🟡 WRITE¶
Enfileira geração (status dispatched).
Opções: - --content-idea-id — ID da ideia. - --channel — Canal único (ex.: blog). - --priority (default: 1) — Prioridade.
cadencia-cli content queue-list — 🟢 READ¶
Lista a fila de geração.
Opções: - --limit (default: 20) - --status — Filtra por status. - --channel — Filtra por channel.
cadencia-cli content seo-update — 🟡 WRITE¶
Atualiza campos de SEO de um post.
cadencia-cli content seo-update <post_id> [--meta-description ..] [--keyword ..] [--slug ..] [--cover-alt ..] [--og-image ..]
Argumentos: post_id — ID do post.
Opções: - --meta-description — Meta description. - --keyword — Palavra-chave SEO. - --slug — Slug. - --cover-alt — Alt da capa (acessibilidade/SEO). - --og-image — Imagem OG (mapeia p/ featured_image_url — schema não tem og_image separado).
cadencia-cli content slide-add — 🟡 WRITE¶
Adiciona um slide (texto + imagem) ao carrossel de um documento.
Argumentos: document_id — ID do documento (carrossel).
Opções: - --text — Texto do slide. - --image — URL da imagem do slide (do content image-upload).
cadencia-cli content slides-clear — 🟡 WRITE¶
Esvazia os slides de um carrossel (slides_content = []).
Argumentos: document_id — ID do documento (carrossel).
cadencia-cli content slides-set — 🟡 WRITE¶
Substitui todos os slides de um carrossel por uma lista JSON.
Argumentos: document_id — ID do documento (carrossel).
Opções: - --slides-json — Lista JSON de slides, ex.: '[{"text":"..","url":".."}]'.
credits — credits¶
cadencia-cli credits balance — 🟢 READ¶
Mostra o saldo de créditos do tenant atual.
cadencia-cli credits history — 🟢 READ¶
Histórico de débitos/créditos do tenant.
Opções: - --limit (default: 20) — Máximo de transações.
crm-views — Views do CRM (metadados)¶
cadencia-cli crm-views list — 🟢 READ¶
Lista as views salvas do CRM.
Opções: - --entity — Filtra por entidade.
custom-fields — Campos customizados (CRM — metadados)¶
cadencia-cli custom-fields create — 🟡 WRITE¶
Cria uma definição de campo customizado.
cadencia-cli custom-fields create [--entity ..] [--label ..] [--key ..] [--type ..] [--options ..] [--position ..]
Opções: - --entity — Entidade: contact | company | opportunity. - --label — Rótulo exibido (ex.: CNPJ). - --key — Chave técnica (a-z0-9_). Derivada do label (prefixo cf_) se omitida. - --type (default: text) — text | textarea | number | date | select. - --options — Opções do select (separadas por ';'). Só para type=select. - --position — Posição na ordenação. Auto (fim) se omitido.
cadencia-cli custom-fields list — 🟢 READ¶
Lista as definições de campos customizados.
Opções: - --entity — Filtra por entidade (contact/company/opportunity).
leads — leads¶
cadencia-cli leads enrich-company — 🟡 WRITE¶
Atualiza uma empresa com dados do CNPJ.ws (pelo CNPJ cadastrado).
Argumentos: company_id — ID da empresa já cadastrada.
cadencia-cli leads import — 🟡 WRITE¶
Importa um lead (por CNPJ) como empresa + sócios + oportunidade.
Opções: - --cnpj — CNPJ do lead (14 dígitos). - --pipeline — Pipeline da oportunidade (slug ou id). - --stage — Stage da oportunidade (slug ou id).
cadencia-cli leads search — 🟢 READ¶
Busca um lead por CNPJ no CNPJ.ws (não grava no CRM).
Opções: - --cnpj — CNPJ a consultar (14 dígitos).
loss-reasons — loss-reasons¶
cadencia-cli loss-reasons list — 🟢 READ¶
Lista os motivos de perda do tenant.
opportunities — Oportunidades / Funil (CRM)¶
cadencia-cli opportunities close — 🟡 WRITE¶
Fecha uma oportunidade (won/lost) com motivo.
Argumentos: opportunity_id — ID da oportunidade.
Opções: - --status — won ou lost. - --reason — Motivo (vira lost_reason quando lost; senão status_reason).
cadencia-cli opportunities create — 🟡 WRITE¶
Cria uma oportunidade (resolve slug de pipeline/stage).
cadencia-cli opportunities create [--contact ..] [--pipeline ..] [--stage ..] [--value ..] [--source ..]
Opções: - --contact — ID do contato. - --pipeline — Pipeline por slug ou id. - --stage — Stage por slug ou id (do mesmo pipeline). - --value — Valor estimado. - --source — Origem da oportunidade (ex.: evento).
cadencia-cli opportunities get — 🟢 READ¶
Mostra uma oportunidade.
Argumentos: opportunity_id — ID da oportunidade.
cadencia-cli opportunities list — 🟢 READ¶
Lista oportunidades do tenant.
cadencia-cli opportunities list [--limit ..] [--status ..] [--contact ..] [--pipeline ..] [--stage ..]
Opções: - --limit (default: 20) — Máximo de oportunidades. - --status — Filtra por status. - --contact — Filtra por contato (id). - --pipeline — Filtra por pipeline (slug ou id). - --stage — Filtra por stage (slug ou id).
cadencia-cli opportunities move — 🟡 WRITE¶
Move a oportunidade para outro stage do mesmo pipeline.
Argumentos: opportunity_id — ID da oportunidade.
Opções: - --to-stage — ID do stage destino.
cadencia-cli opportunities update — 🟡 WRITE¶
Atualiza valor/source/status_reason de uma oportunidade.
Argumentos: opportunity_id — ID da oportunidade.
Opções: - --value — Valor estimado. - --source — Origem da oportunidade. - --status-reason — Motivo/observação de status.
pipeline — pipeline¶
cadencia-cli pipeline forecast — 🟢 READ¶
Forecast do funil: soma do valor das oportunidades abertas.
Opções: - --pipeline — Pipeline (slug ou id). Omitido → todos os pipelines do tenant.
cadencia-cli pipeline summary — 🟢 READ¶
Relatório do funil por stage: nº de oportunidades abertas + valor total.
Opções: - --pipeline — Pipeline (slug ou id). Omitido → todos os pipelines do tenant.
pipeline-stages — pipeline-stages¶
cadencia-cli pipeline-stages create — 🟡 WRITE¶
Cria um estágio num funil.
cadencia-cli pipeline-stages create [--pipeline ..] [--name ..] [--slug ..] [--position ..] [--is-terminal ..] [--color ..]
Opções: - --pipeline — Funil (id ou slug). - --name — Nome do estágio (ex.: Em contato). - --slug — Slug (a-z0-9-). Derivado do nome se omitido. - --position — Posição no funil. Auto (fim) se omitido. - --is-terminal (default: False) — Marca como estágio terminal (ganho/perda). - --color — Cor hex (ex.: #6366f1).
cadencia-cli pipeline-stages list — 🟢 READ¶
Lista os estágios (filtre por --pipeline).
Opções: - --pipeline — Funil (id ou slug).
pipelines — Pipelines / Stages (CRM — metadados)¶
cadencia-cli pipelines create — 🟡 WRITE¶
Cria um funil no tenant.
Opções: - --name — Nome do funil (ex.: Onboarding). - --slug — Slug (a-z0-9-). Derivado do nome se omitido. - --position — Posição na ordenação. Auto (fim) se omitido.
cadencia-cli pipelines list — 🟢 READ¶
Lista os funis do tenant.
products — products¶
cadencia-cli products contacts — 🟢 READ¶
Lista os contatos vinculados a um produto.
Argumentos: product_id — ID do produto.
Opções: - --kind — Filtra por tipo: interesse|adquirido.
cadencia-cli products create — 🟡 WRITE¶
Cria um produto no tenant.
Opções: - --name — Nome do produto (obrigatório). - --description — Descrição. - --price — Preço (numérico). - --active/--inactive (default: True) — Produto ativo (padrão) ou inativo.
cadencia-cli products get — 🟢 READ¶
Mostra um produto (campos ricos).
Argumentos: product_id — ID do produto.
cadencia-cli products link-contact — 🟡 WRITE¶
Vincula um contato a um produto (interesse/adquirido).
Opções: - --product — ID do produto. - --contact — ID do contato. - --kind (default: interesse) — Tipo de relação: interesse|adquirido.
cadencia-cli products list — 🟢 READ¶
Lista produtos do tenant.
Opções: - --active/--all (default: True) — Só ativos (padrão) ou todos. - --limit (default: 20) — Máximo de produtos.
cadencia-cli products of-contact — 🟢 READ¶
Lista os produtos de um contato.
Argumentos: contact_id — ID do contato.
Opções: - --kind — Filtra por tipo: interesse|adquirido.
cadencia-cli products unlink-contact — 🟡 WRITE¶
Remove o vínculo de um contato com um produto.
Opções: - --product — ID do produto. - --contact — ID do contato. - --kind (default: interesse) — Tipo de relação: interesse|adquirido.
cadencia-cli products update — 🟡 WRITE¶
Edita campos de um produto.
cadencia-cli products update <product_id> [--name ..] [--description ..] [--price ..] [--active/--inactive ..]
Argumentos: product_id — ID do produto.
Opções: - --name — Nome. - --description — Descrição. - --price — Preço (numérico). - --active/--inactive — Marca ativo/inativo.
tags — Tags (CRM — metadados)¶
cadencia-cli tags create — 🟡 WRITE¶
Cria uma tag no tenant.
Opções: - --label — Texto da tag (ex.: gestores-ia). - --color — Cor hex (ex.: #6366f1).
cadencia-cli tags list — 🟢 READ¶
Lista as tags do tenant.
tasks — tasks¶
cadencia-cli tasks complete — 🟡 WRITE¶
Marca uma tarefa como concluída.
Argumentos: task_id — ID da tarefa.
cadencia-cli tasks create — 🟡 WRITE¶
Cria uma tarefa/follow-up no tenant.
Opções: - --title — Título da tarefa (obrigatório). - --contact — ID do contato vinculado. - --opportunity — ID da oportunidade vinculada. - --due — Prazo (YYYY-MM-DD) → due_at. - --note — Anotação livre (vai em actor_metadata).
cadencia-cli tasks delete — 🟡 WRITE¶
Remove (soft-delete) uma tarefa.
Argumentos: task_id — ID da tarefa.
Opções: - --yes (default: False) — Confirma a remoção sem prompt.
cadencia-cli tasks get — 🟢 READ¶
Mostra uma tarefa (campos ricos).
Argumentos: task_id — ID da tarefa.
cadencia-cli tasks hoje — 🟢 READ¶
Tarefas pendentes com prazo até hoje (inclusive atrasadas).
Opções: - --limit (default: 50) — Máximo de tarefas.
cadencia-cli tasks list — 🟢 READ¶
Lista tarefas do tenant.
Opções: - --contact — Filtra por contato. - --due-before — Só tarefas com due_at antes de (YYYY-MM-DD). - --pending (default: False) — Só tarefas pendentes (completed_at IS NULL). - --limit (default: 50) — Máximo de tarefas.
tenants — tenants¶
cadencia-cli tenants provision — 🟡 WRITE¶
Provisiona um tenant (conta + tabelas base). Idempotente por e-mail.
cadencia-cli tenants provision [--name ..] [--email ..] [--password ..] [--plan ..] [--credits ..] [--tipo ..] [--nicho ..] [--whatsapp ..]
Opções: - --name — Nome do cliente/usuário (display name). - --email — E-mail de acesso (login). - --password — Senha. Gera uma segura se omitida. - --plan (default: trial) — growth_pro|profissional|essencial|trial|custom. - --credits — Créditos (obrigatório quando plan=custom). - --tipo (default: P) — Tipo: P (perfil pessoal) | E (empresa/marca). - --nicho — Nicho/segmento. - --whatsapp — WhatsApp com DDD.
cadencia-cli tenants set-config — 🟡 WRITE¶
Grava chaves no tenant_config.config (merge jsonb, não sobrescreve o resto).
cadencia-cli tenants set-config <tenant_id> [--soul-md ..] [--temas ..] [--restricoes ..] [--audiencia ..] [--historia ..] [--json ..]
Argumentos: tenant_id — ID do tenant.
Opções: - --soul-md — Persona do chat agent (soul_md). - --temas — temas_prioritarios (separados por ';'). - --restricoes — content_restrictions (separadas por ';'). - --audiencia — audiencia_descricao. - --historia — historia_cliente. - --json — Objeto JSON extra a mesclar no config.
cadencia-cli tenants set-dossier — 🟡 WRITE¶
Grava o dossier (tenant_dossier.data) + version + validated_at. Upsert.
cadencia-cli tenants set-dossier <tenant_id> [--file ..] [--json ..] [--version ..] [--validated ..]
Argumentos: tenant_id — ID do tenant.
Opções: - --file — Arquivo JSON com os blocos do dossier. - --json — JSON dos blocos do dossier (inline). - --version (default: 2) — Versão do dossier. - --validated (default: True) — Marca validated_at = now().
cadencia-cli tenants set-editorials — 🟡 WRITE¶
Grava editorias (tenant_editorials). topics/audience_pains são text[].
Argumentos: tenant_id — ID do tenant.
Opções: - --file — Arquivo JSON: lista de editorias. - --json — JSON inline: lista de editorias.
cadencia-cli tenants set-visual — 🟡 WRITE¶
Define sub-preset + cores/fontes custom do tenant.
cadencia-cli tenants set-visual <tenant_id> [--sub-preset ..] [--cor-primaria ..] [--cor-destaque ..] [--font-headline ..] [--font-body ..]
Argumentos: tenant_id — ID do tenant.
Opções: - --sub-preset — Sub-preset visual (ex.: creator_personal_vinci). - --cor-primaria — Cor primária (#hex). - --cor-destaque — Cor de destaque (#hex). - --font-headline — Fonte de headline. - --font-body — Fonte de corpo.
cadencia-cli tenants upload-asset — 🟡 WRITE¶
Envia logo/foto ao Supabase Storage e grava a URL no config.
Argumentos: tenant_id — ID do tenant.
Opções: - --type — logo | photo. - --file — Caminho do arquivo local.
cadencia-cli tenants verify — 🟢 READ¶
Estado consolidado de um tenant (validação do provisionamento).
Argumentos: tenant_id — ID do tenant.
Total: 111 comandos em 17 grupos. Bloqueados até DEV-582: contacts enrich, content carousel-dispatch (mutações com lógica de crédito/sessão).