@intelex-ia/cli

CLI pra instalar e configurar o @intelex-ia/sdk em projetos Next.js — um comando, zero configuração manual.

Uso

cd seu-projeto-nextjs
npx @intelex-ia/cli init

O comando:

1. Detecta sua estrutura (App vs Pages Router, TS vs JS, src/ ou não, alias @/, gerenciador npm/pnpm/yarn/bun).
2. Pergunta seu API token, secret de revalidate, e como quer integrar (additive / isolated / replace / none).
3. Instala @intelex-ia/sdk com o gerenciador certo.
4. Cria os arquivos nos lugares certos:
   • lib/intelexia.{ts,js} — cliente singleton
   • app/api/revalidate/route.{ts,js} (App) ou pages/api/revalidate.{ts,js} (Pages) — webhook
   • app/blog/page.{tsx,jsx} + [slug]/page.{tsx,jsx} se você não tem blog ainda
   • .env.local — 3 variáveis (cria ou faz append)
   • INTELEXIA.md — documentação completa na raiz (devs + LLMs leem)
5. Imprime resumo + próximos passos.

Comandos

| Comando | O que faz | |---|---| | npx @intelex-ia/cli init | Setup completo (interativo) | | npx @intelex-ia/cli init --update-docs | Só regenera o INTELEXIA.md | | npx @intelex-ia/cli --version | Mostra versão | | npx @intelex-ia/cli --help | Mostra ajuda |

Modos de integração

Quando você já tem um /blog, o CLI pergunta o modo:

| Modo | O que faz | Quando usar | |---|---|---| | Additive ⭐ | Mantém seu /blog atual + adiciona artigos do painel via mergePosts() | Recomendado pra clientes existentes com posts antigos | | Isolated | Cria /blog/ia lado-a-lado, /blog original intacto | Mais seguro pra testar sem risco | | Replace | Substitui /blog inteiro pelos artigos do painel | Migração completa (cuidado com slugs antigos) | | None | Só lib + webhook, deixa as páginas pra você editar manualmente | Pra quem prefere integrar do zero |

Pra modos additive e replace em sites com blog existente, o CLI não faz o codemod automático ainda (v0.1.0). Ele orienta passo-a-passo via INTELEXIA.md §6. Codemod automático vem na v0.2.0.

O que é o INTELEXIA.md

É um documento com 400+ linhas que vai pra raiz do seu projeto, cobrindo tudo sobre a integração:

• Arquitetura e fluxo end-to-end
• Quais arquivos foram criados e por quê
• Variáveis de ambiente (o que cada uma faz)
• API reference completa do SDK (todos os exports)
• Customizações comuns (sitemap, RSS, paginação, filtros, edge runtime)
• Debug (erros comuns + soluções)
• Como atualizar / desinstalar
• Seção dedicada pra LLMs (Claude/Cursor/Copilot) — assim devs podem pedir customizações em linguagem natural e a IA usa o SDK corretamente

Compatibilidade

• Node 18+
• Next.js 13+ (App Router) e 12+ (Pages Router)
• Gerenciadores: npm, pnpm, yarn, bun
• OS: macOS, Linux, Windows

Roadmap

• v0.1.x: setup interativo + INTELEXIA.md + páginas starter pra projeto sem blog
• v0.2.0 (atual): codemod automático pros modos additive/replace em blogs existentes — detecta shape do post local (@/lib/posts, etc), confirma via prompts, faz backup .bak-<timestamp> do original + escreve o novo. Cobre tanto app/blog/page.tsx quanto [slug]/page.tsx. Antes (v0.1.x) só orientava via INTELEXIA.md §6.
• v0.3.0: npx @intelex-ia/cli eject — exporta artigos como MDX/JSON pra cliente cancelando (Fase 4 do roadmap multiplataforma)

Licença

MIT. Veja LICENSE.