Uso local-first do sistema AIOX diretamente no Codex, com descoberta, recomendacao, ativacao e continuidade de fluxo dentro do workspace.
Este repo e o core workspace do AIOX no Codex.
Ele existe para turbinar o uso do Codex com bridge, skills, squads, evals, observabilidade, release discipline e fluxos operacionais locais.
Produtos reais como dashboards, CRMs ou sistemas internos devem nascer em projetos externos, nao como home permanente dentro deste repo.
O que este preview ja faz
checa se o workspace esta pronto
descobre agentes e squads locais
recomenda um melhor agente ou squad por regras simples
permite confirmar a escolha dentro do fluxo
ativa o agente ou squad no caminho Codex-native
sugere uma primeira tarefa util
sugere o proximo passo para manter o fluxo
inclui infraestrutura e referencias para evoluir produtos externos com ajuda do AIOX no Codex
Requisitos
Node.js 20+
npm
Codex aberto neste workspace
Setup rapido
npm install
npm run sync:skills:codex
npm run sync:skills:codex:global
npm run build
Atalho simples para abrir o lane principal do core:
npm start
Onboarding enxuto para terceiros
Se outra pessoa clonar este repo e quiser validar rapido se esta tudo pronto para uso no Codex:
npm install
npm run sync:skills:codex
npm run sync:skills:codex:global
npm run verify:shareability
npm run verify:clean-clone continua existindo como alias de compatibilidade, mas o comando canonico agora e npm run verify:shareability.
Esse gate agora tambem verifica se os artefatos gerados de IDE continuam sincronizados com os agentes fonte.
O npm install da raiz agora tambem prepara automaticamente as dependencias de runtime de .aiox-core, para o doctor funcionar num clone limpo sem etapa extra escondida.
Depois abra o workspace no Codex, crie um chat novo e teste:
npm start
npm start -- Quero criar um projeto novo fora do core
npm run doctor
npm run aiox -- bridge flow "Quero revisar esse projeto"
npm run aiox -- bridge flow "Quero criar um projeto novo fora do core"
npm run publish:github:plan se quiser o plano exato de branch/commit/push para publicar este lote no GitHub
No chat do Codex, quero revisar esse projeto ou /aiox-start quero revisar esse projeto
No chat do Codex, quero criar um projeto novo fora do core ou /aiox-start quero criar um projeto novo fora do core
/aiox-doctor so se quiser um health check dentro do chat
AIOX Master, quero revisar esse projeto se os slash commands nao responderem no chat atual
Se quiser validar o fluxo consolidado do bridge direto pelo CLI do workspace:
npm run aiox --
npm run aiox -- bridge exports --latest
npm run aiox -- bridge exports --latest --scout
npm run aiox -- bridge exports --attention
npm run aiox -- bridge exports --repair-incomplete
npm run aiox -- bridge flow "Quero revisar esse projeto"
npm run aiox -- bridge flow "Quero criar um dashboard novo fora do core" --capability=external-project-blueprint
npm run aiox -- bridge flow "Quero revisar esse projeto" --json
npm run aiox -- bridge exports --stale
npm run aiox -- bridge exports --prune-stale
npm run aiox -- bridge exports --prune-stale --apply
npm run codex-bridge:full-flow -- Quero revisar esse projeto
npm run codex-bridge:full-flow -- Quero criar um dashboard novo fora do core --capability external-project-blueprint
npm run codex-bridge:full-flow -- Quero revisar esse projeto --json
npm run aiox -- agora mostra um resumo curto e orientado ao core.
npm run aiox -- bridge flow ... passa a ser o caminho canonico do CLI AIOX para esse fluxo.
npm run codex-bridge:full-flow ... continua existindo como atalho compativel.
Se o runtime local do bridge ainda nao estiver compilado depois de um clone limpo, esses atalhos agora fazem a preparacao minima automaticamente na primeira execucao.
npm run aiox -- bridge exports --latest --scout le o scout do ultimo projeto exportado direto pelo core.
npm run aiox -- bridge exports --attention lista rapidamente exports stale ou com handoff incompleto.
npm run aiox -- bridge exports --repair-incomplete mostra um preview seguro para reconstruir handoffs incompletos sem sobrescrever arquivos existentes.
npm run aiox -- bridge exports --stale lista apenas registros quebrados.
npm run aiox -- bridge exports --prune-stale mostra preview seguro antes de qualquer limpeza do registry.
npm run doctor -- --dry-run agora tambem consegue antecipar essa remediacao quando houver stale exports, e npm run doctor -- --fix aplica a limpeza segura do registry local.
Se o objetivo for criar um produto novo fora deste repo, o caminho mais simples do dia a dia agora e:
npm start -- Quero criar um projeto novo fora do core
Esse atalho empurra o bridge para a rota segura de projeto externo antes de qualquer codigo de produto nascer dentro do core.
Se o pedido ainda estiver vago, o bridge agora para e faz perguntas curtas de clarificacao no mesmo chat antes de criar qualquer workspace novo.
Nessa hora a saida tambem deixa explicito que nenhuma pasta nova foi criada ainda, para evitar a sensacao de que o sistema saiu inventando projeto sem contexto suficiente.
As superfices principais desse fluxo agora tambem ficaram coerentes em portugues do inicio ao fim: entrada, recomendacao, escolha guiada, ativacao, primeira tarefa e proximo passo usam a mesma linguagem para reduzir atrito para usuarios leigos.
Se voce responder so com as respostas numeradas da clarificacao, o bridge continua automaticamente a mesma rota de projeto externo sem exigir que voce repita o pedido inteiro.
Se o runtime compilado do bridge estiver atrasado em relacao ao source, npm start e npm run codex-bridge:full-flow agora recompilam o minimo necessario antes de rodar, para evitar comportamento antigo em execucoes novas.
Quando o workspace externo nascer, ele ja leva um contrato melhor de execucao: objetivo, definicao de pronto, escopo, evidencia e criterio de parada ficam embutidos no handoff e no AGENTS.md, enquanto START-PROMPT.md fica so como fallback manual.
Esse bundle agora tambem leva OPEN-SOURCE-SCOUT.md, para o novo chat avaliar rapidamente se vale usar pronto, adaptar, so referenciar ou evitar repos open source antes de sair construindo tudo do zero.
Limite entre core e produtos
Alguns dashboards foram criados aqui durante exploracao:
packages/business-dashboard
packages/finance-dashboard
packages/revenue-ops-dashboard
Eles representam produtos externos e devem ser extraidos para pastas ou repositorios proprios.
O candidato principal para extracao hoje e packages/business-dashboard, que e o trilho alinhado ao deploy atual.
Mais detalhes em docs/project-boundaries-and-extraction.md.
Fluxo recomendado para projetos novos: docs/external-project-workflow.md.
Dashboard em operacao hoje
O business-dashboard continua disponivel, mas agora como trilho explicito de produto, nao como startup path da raiz.
npm run build
npm run start:dashboard
Depois acesse http://localhost:4310.
O app sobe em modo mock por padrao e mostra quais integracoes ainda dependem de credenciais reais.
Project Factory para produtos externos
Para preparar bundles copy-ready dos dashboards fora deste repo:
npm run project-factory:dashboard-audit
npm run project-factory:extract-dashboards
npm run project-factory:materialize-dashboard -- business-dashboard
npm run project-factory:materialize-business-dashboard
Os artefatos ficam em .runtime/project-factory/ e ajudam a mover os produtos para workspaces proprios sem misturar com o core AIOX.
Para preparar um projeto externo novo desde a ideia inicial, sem criar produto dentro deste repo:
npm start -- Quero criar um projeto novo fora do core
npm run aiox -- bridge flow "Quero criar um projeto novo fora do core"
npm run project-factory:list-blueprint-types
npm run project-factory:bootstrap-external -- --name "Revenue Command Center" --type dashboard --objective "Centralizar operacao comercial, financeira e de marketing em um projeto separado do core." --dry-run true
npm run project-factory:bootstrap-external -- --name "Revenue Command Center" --type dashboard --objective "Centralizar operacao comercial, financeira e de marketing em um projeto separado do core."
Use o --dry-run true primeiro quando quiser uma pre-visualizacao segura dos paths e artefatos antes de gravar qualquer coisa fora do core.
Quando o workspace externo estiver pronto, o caminho principal agora e abrir a pasta nova e dizer continue este projeto a partir do handoff. START-PROMPT.md continua existindo apenas como fallback manual.
Antes de assumir zero-build, o novo workspace tambem orienta o chat a ler OPEN-SOURCE-SCOUT.md e fazer uma triagem curta de open source reutilizavel.
Esse workspace novo tambem ja orienta o chat a resumir produto, arquitetura, MVP e o que vale reaproveitar primeiro, perguntar pouco quando faltar contexto critico e usar apenas os agentes, squads e ferramentas relevantes.
O bundle exportado agora tambem leva um runtime kit repo-local em .codex/skills/aiox-project-runtime/SKILL.md, para o novo chat herdar uma camada enxuta de inteligencia do AIOX Codex sem depender de copiar o core inteiro.
Quando voce voltar para o core depois, os atalhos mais uteis para retomar ou reparar esse projeto sao npm run aiox -- bridge exports --latest, npm run aiox -- bridge exports --latest --scout, npm run aiox -- bridge exports --attention e npm run aiox -- bridge exports --repair-incomplete.
Mais detalhes em docs/project-blueprint-bootstrap.md.
O que viaja com o repo
Este repo ja carrega no proprio workspace:
skills repo-local em .codex/skills/
agentes repo-local em .codex/agents/
bundle global versionado em codex-global/
o plugin workspace-local plugins/aiox-bridge/
scripts, docs, evals e quality gates do core
Isso significa que uma pessoa que clonar o repo e abrir a pasta no Codex consegue herdar a base principal do AIOX Codex 2026 sem depender do seu terminal antigo com Claude Code.
Para herdar tambem os comandos globais mais recentes, como /autonomo, /autonomogo e /autocontinue, a pessoa precisa rodar uma vez:
npm run sync:skills:codex:global
Esse comando instala no CODEX_HOME dela o bundle versionado em codex-global/, sem levar logs, registry ou secrets do seu ambiente.
O que viaja com projetos exportados
Quando o core cria um projeto novo fora do repo, o workspace externo nao recebe o core inteiro.
Ele recebe um kit enxuto e seguro para continuidade:
AGENTS.md
PROJECT-START-HERE.md
WORKSPACE-SETUP.md
NEXT-STEPS.md
OPEN-SOURCE-SCOUT.md
docs/stories/
.codex/skills/aiox-project-runtime/SKILL.md
Na pratica, isso significa:
o projeto externo herda handoff, guardrails e uma camada repo-local de continuidade
o projeto externo nao vira uma copia completa de .aiox-core nem do plugin workspace-local
o core continua sendo a fabrica/inteligencia principal
o projeto externo vira a casa do produto
O que ainda depende do ambiente da pessoa
Algumas capacidades nao viajam so com git e ainda dependem do setup local de quem clonar:
Node.js + npm instalados
npm install
npm run sync:skills:codex
npm run sync:skills:codex:global para instalar tambem os comandos globais novos no CODEX_HOME local
autenticacao/configuracao do proprio Codex
conectores externos autenticados na maquina da pessoa, como GitHub, Google Drive e Vercel
secrets reais que nao devem ir para o repo
Validacao rapida
npm run lint
npm run typecheck
npm test
Evals do bridge
O repo agora inclui uma esteira deterministica para avaliar comportamento do @aiox/codex-bridge
sem depender de modelo remoto.
npm run eval:codex-bridge
Esse comando gera saidas em packages/codex-bridge/evals/output/.
Mais detalhes em docs/codex-bridge-evals.md.
Para usar a versao de gate local antes de mandar para review:
npm run eval:codex-bridge:gate
Secrets e configuracao segura
O repo agora tem uma camada compartilhada de runtime secrets para manter o fluxo local-first, mas permitir bootstrap opcional por Infisical quando o time precisar compartilhar credenciais sem copiar valores manualmente.
Politica e inventario: docs/secrets-policy.md
Bootstrap opcional com Infisical: docs/infisical-bootstrap.md
Mais detalhes em docs/codex-bridge-observability.md.
Release local-first
O repo agora tem uma foundation de versionamento e preparo de release com Changesets para os workspaces ativos do lane principal.
Comandos principais:
npm run changeset:add
npm run release:plan
npm run release:rehearse
npm run release:prepare
npm run release:plan monta o plano local a partir dos .changeset/*.md
npm run release:rehearse faz um ensaio isolado e seguro da geracao de preview de versoes/changelog sem mutar o monorepo real
npm run release:prepare roda os gates e para antes de qualquer mutacao de versao
No Windows, o write final deve ser executado pelo release owner direto no shell com npm exec changeset version depois do preparo.
Mais detalhes em docs/release-workflow.md.
Como usar no Codex
Abra este workspace no Codex.
Comece com um pedido simples em linguagem natural, por exemplo:
quero revisar esse projeto
quero criar um projeto novo fora do core
/aiox-start quero revisar esse projeto
/aiox-start quero criar um projeto novo fora do core
AIOX Master, quero revisar esse projeto
@dev implemente a story 1.1
@qa revise esta mudanca
Se quiser validar o ambiente antes, rode:
npm start
npm run doctor
npm run aiox -- doctor
npm run sync:ide:check
Equivalente canonico no terminal para entrar no fluxo do bridge:
npm run aiox -- bridge flow "Quero revisar esse projeto"
npm run aiox -- bridge flow "Quero criar um projeto novo fora do core"
Checklist de clone limpo: docs/clone-clean-checklist.md.
Guia de compartilhamento no GitHub: docs/github-shareability.md.
Guia de publicacao no GitHub: docs/github-publish-flow.md.
Fluxo esperado do MVP
O bridge verifica readiness do workspace.
O sistema descobre agentes e squads locais.
O sistema recomenda a melhor opcao para a intencao inicial.
A escolha e confirmada no proprio fluxo.
A ativacao acontece usando os artefatos locais do Codex e do AIOX.
O sistema sugere a primeira tarefa util e o proximo passo.
Observacoes
O projeto e local-first: o fluxo principal funciona sem nuvem obrigatoria.
O MVP atual esta otimizado para preview e validacao inicial.
O estado de continuidade do fluxo fica em .aiox/codex-bridge/.