Skip to content
Back to search

moedux-cli

Instruções para um agente de IA usar o moedux-cli, o cliente oficial da API /api/v1 da Moedux: instalar, autenticar com API Key, ler diagnóstico financeiro (Gasto Diário, Mar Vermelho), transações e patrimônio, e criar, editar ou excluir transações e aplicar cenários. Use when o usuário pedir para consultar a conta Moedux, analisar as finanças, listar ou alterar transações, comparar cenários, ou quando o comando `moedux` estiver disponível no ambiente.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jhonnysabino--moedux-agent-tools/badge.svg)](/listings/jhonnysabino--moedux-agent-tools)

HTML

<a href="/listings/jhonnysabino--moedux-agent-tools"><img src="/api/listings/jhonnysabino--moedux-agent-tools/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 101 lines · 1 finding marked
  1. ---
  2. name: moedux-cli
  3. description: >-
  4. Instruções para um agente de IA usar o moedux-cli, o cliente oficial da API
  5. /api/v1 da Moedux: instalar, autenticar com API Key, ler diagnóstico
  6. financeiro (Gasto Diário, Mar Vermelho), transações e patrimônio, e criar,
  7. editar ou excluir transações e aplicar cenários. Use when o usuário pedir
  8. para consultar a conta Moedux, analisar as finanças, listar ou alterar
  9. transações, comparar cenários, ou quando o comando `moedux` estiver
  10. disponível no ambiente.
  11. ---
  12. # moedux-cli
  13. CLI Go com entrada/saída JSON para a conta Moedux. O cliente não tem regra de
  14. negócio: o servidor decide, o CLI transpõe o contrato `/api/v1`.
  15. ## Contrato da API
  16. A especificação OpenAPI 3.1 legível por máquina está em
  17. `https://www.moedux.com/openapi.json`. Consulte-a para confirmar caminhos,
  18. corpos de requisição, formatos de resposta e a permissão exata (`x-permission`)
  19. de cada operação antes de chamar a API — não adivinhe o formato de um campo.
  20. A CLI cobre todas as operações publicadas; o contrato é a fonte canônica quando
  21. os dois diferirem.
  22. ## Instalar
  23. ```sh
  24. curl -fsSL https://www.moedux.com/static/cli-install.sh | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 30 on GitHub
  25. ```
  26. Instala em `~/.local/bin` (sobrescreva com `MOEDUX_CLI_INSTALL_DIR`).
  27. ## Autenticação (obrigatória)
  28. 1. Crie a API Key na UI: Configurações > API Keys. Escolha permissões mínimas.
  29. 2. Exporte uma vez por sessão: `export MOEDUX_API_KEY=moedux_live_<segredo>` (ou `--api-key`, que tem prioridade).
  30. 3. A base URL é fixa em `https://www.moedux.com`. Não passe `--base-url`; use apenas para apontar staging/local.
  31. A chave nunca é impressa pelo CLI. Permissões válidas: `diagnosis:read`,
  32. `transactions:read`, `transactions:write`, `scenarios:compare`,
  33. `scenarios:apply`, `networth:read`.
  34. ## Comandos de leitura (nunca alteram dados)
  35. ```sh
  36. moedux diagnosis [--horizon-days N] # balance, dailyVariableSpend.value/confidence/windowDays, redSeaDate, projection[], userTier
  37. moedux transactions list [--type income|expense|savings|credit_card] [--from D] [--to D] [--limit N]
  38. moedux networth # { items[], total }
  39. ```
  40. `confidence` usa o vocabulário canônico: `Sem dados | Aprendendo | Confiável`.
  41. ## Comandos de escrita (alteram dados)
  42. ```sh
  43. moedux transactions add <json | --fields>
  44. moedux transactions edit <id> --mode only|from|all [--fields]
  45. moedux transactions remove <id> [--mode only|from|all] [--date D]
  46. ```
  47. - Campos do JSON/`--fields`: `id` (UUID, opcional), `amount`, `type`, `frequency` (`once|daily|monthly`), `description`, `startDate` (YYYY-MM-DD), `dayOfMonth`, `isStartingBalance`.
  48. - `add --fields` gera o `id` como UUID, para idempotência.
  49. - Editar/excluir recorrência exige `--mode` (`only|from|all`): mesma semântica de escopo da UI. `only/from` exigem `--date`.
  50. - Sempre `list` antes de `edit`/`remove` para obter o `id` real.
  51. ## Cenários
  52. ```sh
  53. moedux scenarios compare <json> [--horizon-days N] # NÃO grava. Compare sempre primeiro.
  54. moedux scenarios apply <json> # GRAVA. Atômico: converte itens em transações reais.
  55. ```
  56. ## Códigos de saída (o agente deve reagir a eles)
  57. | Código | Significado | Ação do agente |
  58. |--------|-------------|----------------|
  59. | 0 | sucesso | use o JSON do stdout |
  60. | 1 | uso/argumento | corrija flags ou JSON e repita |
  61. | 2 | autenticação/permissão (401/403) | confira chave e permissões; nunca retente cegamente |
  62. | 3 | validação (422) | `stderr` lista os campos; corrija e repita |
  63. | 4 | servidor/rede | retente uma vez; se persistir, pare e reporte |
  64. JSON de dados sai no stdout; erros saem no stderr. Capture o stdout direto,
  65. sem misturar com logs.
  66. ## Receita típica (agente)
  67. ```sh
  68. export MOEDUX_API_KEY=moedux_live_xxx
  69. moedux diagnosis | jq -r '.redSeaDate // "sem mar vermelho"'
  70. moedux transactions list --type expense --from "$(date +%F)" | jq '.total'
  71. moedux scenarios compare "$(cat cenário.json)" | jq '.projection[0]'
  72. ```
  73. 1. Leia sempre `diagnosis` primeiro: o Mar Vermelho (`redSeaDate`) é o alerta
  74. mais urgente.
  75. 2. Antes de qualquer escrita, liste e compare.
  76. 3. Nunca aplique um cenário sem ter mostrado o `compare` ao usuário.
  77. 4. Não invente valores ou IDs: o que não vier da API, pergunte ao usuário.
README.md · README · 71 lines · 1 finding marked
  1. # Moedux — ferramentas para agentes de IA
  2. [Moedux](https://www.moedux.com/?utm_source=github&utm_medium=repo&utm_campaign=agent-tools) é um aplicativo brasileiro de finanças pessoais: transações, contas e estimativas de gasto viram um diagnóstico legível e uma próxima ação concreta.
  3. Este repositório reúne os artefatos que um agente de IA precisa para usar o Moedux sem adivinhar formato de campo nem permissão de API. É um espelho público e versionado do que o próprio app publica em `/developers`.
  4. ## Servidor MCP (registro oficial)
  5. O Moedux publica um servidor MCP remoto (Streamable HTTP) no **Registro Oficial de MCP**, sem cadastro nem chave de API:
  6. - Endpoint: `https://www.moedux.com/mcp`
  7. - Registro: `io.github.jhonnysabino/moedux@1.0.0` — https://registry.modelcontextprotocol.io/v0.1/servers/io.github.jhonnysabino%2Fmoedux/versions/1.0.0
  8. - Server Card SEP-1649: https://www.moedux.com/.well-known/mcp.json
  9. - Conector Glama (qualidade das ferramentas): https://glama.ai/mcp/connectors/io.github.jhonnysabino/moedux
  10. - Lista de servidores MCP remotos, categoria Finance: https://github.com/punkpeye/awesome-remote-mcp-servers/pull/5498
  11. Ferramentas disponíveis:
  12. - `prever_mar_vermelho` — data prevista em que o saldo chega a zero (Mar Vermelho), com link pré-preenchido.
  13. - `projetar_saldo_12_meses` — saldo projetado em 12 meses e a data do Mar Vermelho, com link pré-preenchido e citação da fonte.
  14. Exemplo de configuração para um cliente MCP:
  15. ```json
  16. {
  17. "mcpServers": {
  18. "moedux": {
  19. "type": "streamable-http",
  20. "url": "https://www.moedux.com/mcp"
  21. }
  22. }
  23. }
  24. ```
  25. ## Contrato da API
  26. - Especificação OpenAPI 3.1: [`openapi.json`](openapi.json) — espelho de https://www.moedux.com/openapi.json
  27. - Documentação para humanos: https://www.moedux.com/developers?utm_source=github&utm_medium=repo&utm_campaign=agent-tools
  28. - Autenticação: HTTP Bearer com API Key criada em Configurações > API Keys no app.
  29. Cada operação carrega `x-permission`. Peça sempre a permissão mínima: `diagnosis:read`, `transactions:read`, `transactions:write`, `scenarios:compare`, `scenarios:apply` ou `networth:read`.
  30. ## Skill do CLI
  31. [`SKILL.md`](SKILL.md) ensina um agente a instalar e usar o `moedux-cli`, o cliente oficial da API `/api/v1` com entrada e saída JSON. Instalação:
  32. ```sh
  33. curl -fsSL https://www.moedux.com/static/cli-install.sh | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 48 on GitHub
  34. ```
  35. O binário aceita `diagnosis`, `transactions list|add|edit|remove`, `networth` e `scenarios compare|apply`. A especificação em `openapi.json` é a fonte canônica quando houver divergência.
  36. ## Começando sem cartão
  37. O cadastro cria 14 dias de teste gratuito: https://www.moedux.com/app/login?utm_source=github&utm_medium=repo&utm_campaign=agent-tools
  38. ## Guias de finanças pessoais
  39. Conteúdo gratuito e independente, mantido no gist canônico do projeto:
  40. - [Guia prático de controle financeiro com modelos CSV](https://gist.github.com/jhonnysabino/8e2a46d8947166f362cfaab7f3f7cee7#file-guia-controle-financeiro-md)
  41. - [Reserva de emergência: como montar e quanto guardar](https://gist.github.com/jhonnysabino/8e2a46d8947166f362cfaab7f3f7cee7#file-guia-reserva-emergencia-md)
  42. - [Comparativo de aplicativos de finanças pessoais](https://gist.github.com/jhonnysabino/8e2a46d8947166f362cfaab7f3f7cee7#file-guia-comparativo-apps-md)
  43. ## Atualização
  44. Os arquivos deste repositório são gerados a partir do código do app. Para atualizar, copie `cmd/moedux-cli/SKILL.md` e o `GET /openapi.json` da versão publicada.
  45. ---
  46. Moedux · [Termos de uso](https://www.moedux.com/terms-of-use?utm_source=github&utm_medium=repo&utm_campaign=agent-tools) · [Privacidade](https://www.moedux.com/privacy-policy?utm_source=github&utm_medium=repo&utm_campaign=agent-tools)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.