{"_id":"@alvaro-alencar/aios","_rev":"6-40f5b9652fc445181400feba8412836d","name":"@alvaro-alencar/aios","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.0":{"name":"@alvaro-alencar/aios","version":"0.1.0","keywords":["ai","agents","memory","cli","documentation","handoff","protocol"],"author":{"name":"Alvaro Alencar"},"license":"MIT","_id":"@alvaro-alencar/aios@0.1.0","maintainers":[{"name":"alvaro-alencar","email":"ac.alvaro@gmail.com"}],"homepage":"https://github.com/alvaro-alencar/AIOS#readme","bugs":{"url":"https://github.com/alvaro-alencar/AIOS/issues"},"bin":{"aios":"bin/aios.js"},"dist":{"shasum":"9dfbac1f0f1a2de559bfa36d47542f6644312a99","tarball":"https://registry.npmjs.org/@alvaro-alencar/aios/-/aios-0.1.0.tgz","fileCount":18,"integrity":"sha512-6ZZN6HCIU34qIStRCTu+efnMknmPTg/VNsoPALhrXD6iV3OwLb05eg9sNRbIXD9B099+SskGIrRSNXp/3MbenQ==","signatures":[{"sig":"MEUCIQCY1WunDgqgoh02mewfWAhVvbVyVeijJf4YS3kJYTZd9QIgIO+uKVtmmVXxIokCF1bJtW4qgngxb+oqb0iYKl8VO7o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42309},"type":"module","engines":{"node":">=18"},"gitHead":"589ed7f3774ed5b81114e1048fdc0bd5f94e3aa6","scripts":{"test":"node --test","check":"node --check ./bin/aios.js","smoke":"node ./bin/aios.js --help && node ./bin/aios.js --version","start":"node ./bin/aios.js"},"_npmUser":{"name":"alvaro-alencar","email":"ac.alvaro@gmail.com"},"repository":{"url":"git+https://github.com/alvaro-alencar/AIOS.git","type":"git"},"_npmVersion":"10.9.7","description":"AIOS - Agent Intelligence Operating System: operational memory protocol and CLI for AI-assisted projects.","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aios_0.1.0_1781567559041_0.5516073373101038","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@alvaro-alencar/aios","version":"0.1.1","keywords":["ai","agents","memory","cli","documentation","handoff","protocol","aios","context"],"author":{"name":"Alvaro Alencar"},"license":"MIT","_id":"@alvaro-alencar/aios@0.1.1","maintainers":[{"name":"alvaro-alencar","email":"ac.alvaro@gmail.com"}],"homepage":"https://github.com/alvaro-alencar/AIOS#readme","bugs":{"url":"https://github.com/alvaro-alencar/AIOS/issues"},"bin":{"aios":"bin/aios.js"},"dist":{"shasum":"ef1a948fa7220a87cf141f5d001fee06b3e80776","tarball":"https://registry.npmjs.org/@alvaro-alencar/aios/-/aios-0.1.1.tgz","fileCount":18,"integrity":"sha512-C5O2Vmlmfu1OnMbMZMjw+RI6erLZzzJpB1UDvlss0VrhYnnloKxXP+wC8eyj2krH48WmOJg/y3Xf3B75DMDMgQ==","signatures":[{"sig":"MEYCIQDzOxmv1CjtKtjRGNRkGyp6iwxduT344wqDXGVSVmY8mQIhAJub7vPiluTbrZ3rEVE5INLlnYh6azwdxqVNmREwrp1Y","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45785},"type":"module","engines":{"node":">=18"},"gitHead":"aaa8ee2bf9d64b746ce8d9db91a44514aee8c40a","scripts":{"test":"node --test","check":"node --check ./bin/aios.js","smoke":"node ./bin/aios.js --help && node ./bin/aios.js --version","start":"node ./bin/aios.js"},"_npmUser":{"name":"alvaro-alencar","email":"ac.alvaro@gmail.com"},"repository":{"url":"git+https://github.com/alvaro-alencar/AIOS.git","type":"git"},"_npmVersion":"10.9.7","description":"AIOS - Agent Intelligence Operating System: operational memory protocol and CLI for AI-assisted projects.","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aios_0.1.1_1781569588776_0.9801903218462764","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@alvaro-alencar/aios","version":"0.1.2","keywords":["ai","agents","memory","cli","documentation","handoff","protocol","aios","context"],"author":{"name":"Alvaro Alencar"},"license":"MIT","_id":"@alvaro-alencar/aios@0.1.2","maintainers":[{"name":"alvaro-alencar","email":"ac.alvaro@gmail.com"}],"homepage":"https://github.com/alvaro-alencar/AIOS#readme","bugs":{"url":"https://github.com/alvaro-alencar/AIOS/issues"},"bin":{"aios":"bin/aios.js"},"dist":{"shasum":"9df68f03d0935274e65821d413b319210942dc8e","tarball":"https://registry.npmjs.org/@alvaro-alencar/aios/-/aios-0.1.2.tgz","fileCount":18,"integrity":"sha512-8decqMg+tneGiXM0M8UHtqpPc7FpjKeY3e0Z0nddxaCupDrSLpnqEGwCfxhoYZRTZuW9GYKxS4rLnUu13CmyrA==","signatures":[{"sig":"MEUCIE3gapLAyYJ5cKXAJ7cKjBHE6xeflPkGbxZmIyCmh57iAiEA/Pb4gpSLpDnnHK/sInFcEfJ2IUqKIpLnEPW5tN8BxrQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56423},"type":"module","engines":{"node":">=18"},"gitHead":"f7231df1559580cc7f97f477c201a754c143fdfe","scripts":{"test":"node --test","check":"node --check ./bin/aios.js","smoke":"node ./bin/aios.js --help && node ./bin/aios.js --version","start":"node ./bin/aios.js"},"_npmUser":{"name":"alvaro-alencar","email":"ac.alvaro@gmail.com"},"repository":{"url":"git+https://github.com/alvaro-alencar/AIOS.git","type":"git"},"_npmVersion":"11.16.0","description":"AIOS - Agent Intelligence Operating System: operational memory protocol and CLI for AI-assisted projects.","directories":{},"_nodeVersion":"24.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aios_0.1.2_1781616402888_0.3919036787661845","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@alvaro-alencar/aios","version":"0.1.3","keywords":["ai","agents","memory","cli","documentation","handoff","protocol","aios","context"],"author":{"name":"Alvaro Alencar"},"license":"MIT","_id":"@alvaro-alencar/aios@0.1.3","maintainers":[{"name":"alvaro-alencar","email":"ac.alvaro@gmail.com"}],"homepage":"https://github.com/alvaro-alencar/AIOS#readme","bugs":{"url":"https://github.com/alvaro-alencar/AIOS/issues"},"bin":{"aios":"bin/aios.js"},"dist":{"shasum":"5f604aa6c7309878724e58f025d8688ac73bb0c3","tarball":"https://registry.npmjs.org/@alvaro-alencar/aios/-/aios-0.1.3.tgz","fileCount":18,"integrity":"sha512-j2lQIdxigDFeJJ75JQu5wzZ7AzFGoNhTl4ADjNM7YpYv3lIvvEp0cLTRTniAPZ4Q7EGN+GU0G/F6TaUrHvC+Qg==","signatures":[{"sig":"MEUCIDB7kgjORFSqX7xJlXh/ut0bmDogGsdqdkRonyKXTQ/zAiEA0gq+yDK7xWEzJmTL9xwSejbJDZh4I1wRL6LnvW9CLC8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59124},"type":"module","engines":{"node":">=18"},"gitHead":"6a42a9bc9bdaad7ff88016cedb1ecebd872a2324","scripts":{"test":"node --test","check":"node --check ./bin/aios.js","smoke":"node ./bin/aios.js --help && node ./bin/aios.js --version","start":"node ./bin/aios.js"},"_npmUser":{"name":"alvaro-alencar","email":"ac.alvaro@gmail.com"},"repository":{"url":"git+https://github.com/alvaro-alencar/AIOS.git","type":"git"},"_npmVersion":"11.16.0","description":"AIOS - Agent Intelligence Operating System: operational memory protocol and CLI for AI-assisted projects.","directories":{},"_nodeVersion":"24.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aios_0.1.3_1781631719053_0.5160723576391708","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@alvaro-alencar/aios","version":"0.1.4","keywords":["ai","agents","memory","cli","documentation","handoff","protocol","aios","context"],"author":{"name":"Alvaro Alencar"},"license":"MIT","_id":"@alvaro-alencar/aios@0.1.4","maintainers":[{"name":"alvaro-alencar","email":"ac.alvaro@gmail.com"}],"homepage":"https://github.com/alvaro-alencar/AIOS#readme","bugs":{"url":"https://github.com/alvaro-alencar/AIOS/issues"},"bin":{"aios":"bin/aios.js"},"dist":{"shasum":"a211c28978996537fa39bb2ea4bfb54c920515fe","tarball":"https://registry.npmjs.org/@alvaro-alencar/aios/-/aios-0.1.4.tgz","fileCount":18,"integrity":"sha512-Od7x5pFwMhXM9ZxF9bL8cwOHx63qQQf78gXIe6+6H1WA10s+4mg958PznhEsegWgJZAO75hIbObX4G3/0zhyKw==","signatures":[{"sig":"MEYCIQCOtKo78wWw2WIgVdbOfIOEgCPxVaeZ6ovSkO6oGRJorAIhALwGpPGZpLz4hpHoA6UJOvTjBDVoGRnrb/qeMsec2Uy8","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":82633},"type":"module","engines":{"node":">=18"},"gitHead":"9278c65841a379d0dda2b12b4e0443adc124bb6f","scripts":{"test":"node --test","check":"node --check ./bin/aios.js","smoke":"node ./bin/aios.js --help && node ./bin/aios.js --version","start":"node ./bin/aios.js"},"_npmUser":{"name":"alvaro-alencar","email":"ac.alvaro@gmail.com"},"repository":{"url":"git+https://github.com/alvaro-alencar/AIOS.git","type":"git"},"_npmVersion":"11.16.0","description":"AIOS - Agent Intelligence Operating System: operational memory protocol and CLI for AI-assisted projects.","directories":{},"_nodeVersion":"24.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/aios_0.1.4_1781707541921_0.25440138297755155","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-06-15T23:52:38.883Z","modified":"2026-07-10T01:37:55.723Z","0.1.0":"2026-06-15T23:52:39.173Z","0.1.1":"2026-06-16T00:26:28.899Z","0.1.2":"2026-06-16T13:26:43.027Z","0.1.3":"2026-06-16T17:41:59.202Z","0.1.4":"2026-06-17T14:45:42.088Z"},"bugs":{"url":"https://github.com/alvaro-alencar/AIOS/issues"},"author":{"name":"Alvaro Alencar"},"license":"MIT","homepage":"https://github.com/alvaro-alencar/AIOS#readme","keywords":["ai","agents","memory","cli","documentation","handoff","protocol","aios","context"],"repository":{"url":"git+https://github.com/alvaro-alencar/AIOS.git","type":"git"},"description":"AIOS - Agent Intelligence Operating System: operational memory protocol and CLI for AI-assisted projects.","maintainers":[{"email":"ac.alvaro@gmail.com","name":"arksystem"}],"readme":"# AIOS - Agent Intelligence Operating System\r\n\r\nAIOS é um protocolo agnóstico de memória operacional para projetos assistidos por agentes de IA.\r\n\r\nA ideia central é simples: todo projeto deveria ter uma memória versionada, legível por humanos e agentes, capaz de preservar contexto, decisões, pendências, riscos, validações e handoffs entre sessões.\r\n\r\nO AIOS não é apenas uma pasta. A pasta `.ai/` é a implementação padrão do protocolo.\r\n\r\n## O problema que o AIOS resolve\r\n\r\nVocê abre uma IA no projeto. Ela não sabe o que aconteceu antes.\r\n\r\nVocê explica o contexto. Ela entende metade.\r\n\r\nVocê troca de IA. Começa tudo de novo.\r\n\r\nA IA mexe onde não devia, esquece uma decisão antiga, sugere refatoração fora de hora ou tenta fazer commit sem autorização.\r\n\r\nO AIOS cria uma memória operacional dentro do repositório para que qualquer agente consiga entrar, observar o estado real do projeto, planejar com segurança e executar apenas o que foi autorizado.\r\n\r\nEm linguagem simples:\r\n\r\n```txt\r\nGit guarda o código.\r\nAIOS guarda o contexto operacional.\r\n```\r\n\r\n## O que você verá funcionando em 5 minutos\r\n\r\nDepois de instalar o AIOS em um projeto, você pode abrir uma IA de código e pedir:\r\n\r\n```txt\r\naios observe\r\n```\r\n\r\nA IA deve:\r\n\r\n- ler a memória `.ai/`;\r\n- rodar `git status` e `git log`;\r\n- comparar memória e repositório real;\r\n- apontar riscos e pendências;\r\n- sugerir próximos comandos;\r\n- não alterar código;\r\n- não commitar;\r\n- não fazer push.\r\n\r\nDepois você pode pedir:\r\n\r\n```txt\r\naios plan\r\n```\r\n\r\nA IA deve gerar um plano em milestones verificáveis, cada uma com objetivo, critério de sucesso, validações, riscos, rollback e próximo passo.\r\n\r\nQuando quiser autorizar uma ação específica:\r\n\r\n```txt\r\naios act \"corrigir o menor problema detectado no plano\"\r\n```\r\n\r\nA IA deve executar apenas esse escopo.\r\n\r\n## Primeiros 10 minutos\r\n\r\nEste é o caminho mais rápido para sentir o \"uau\".\r\n\r\n### 1. Entre em qualquer projeto com Git\r\n\r\n```bash\r\ncd meu-projeto\r\n```\r\n\r\nConfirme que o repositório está saudável:\r\n\r\n```bash\r\ngit status\r\n```\r\n\r\nSe houver mudanças pendentes, tudo bem. O AIOS pode ajudar a observar, mas não instale às cegas em um repositório com trabalho importante sem antes entender o estado atual.\r\n\r\n### 2. Instale o AIOS no projeto\r\n\r\n```bash\r\nnpx @alvaro-alencar/aios@latest install all\r\n```\r\n\r\nIsso cria ou completa a memória `.ai/` e instala instruções para agentes:\r\n\r\n```txt\r\n.ai/\r\n.ai/AIOS_AGENT_PROMPT.md\r\nAGENTS.md\r\nCLAUDE.md\r\n.cursor/rules/aios.mdc\r\n.github/copilot-instructions.md\r\n```\r\n\r\nO comando preserva arquivos existentes quando possível. Use `--force` apenas quando quiser regenerar instruções conscientemente.\r\n\r\n### 3. Audite a instalação\r\n\r\n```bash\r\nnpx @alvaro-alencar/aios@latest audit\r\n```\r\n\r\nVocê verá se a estrutura `.ai/` está compatível e quais marcadores ainda precisam de preenchimento.\r\n\r\n### 4. Abra sua IA de código no projeto\r\n\r\nPode ser Claude Code, Codex, Cursor, Copilot Chat, Gemini CLI ou outra ferramenta que leia arquivos do repositório.\r\n\r\nEnvie apenas:\r\n\r\n```txt\r\naios observe\r\n```\r\n\r\nNão explique o projeto. Esse é o teste.\r\n\r\nSe tudo estiver funcionando, o agente deve descobrir o estado do projeto sozinho lendo o repositório e a memória `.ai/`.\r\n\r\n### 5. Peça um plano\r\n\r\n```txt\r\naios plan\r\n```\r\n\r\nO agente deve responder com milestones verificáveis.\r\n\r\nUm bom plano deve parecer com isto:\r\n\r\n```txt\r\nMilestone 1: Sincronizar memória operacional\r\nObjetivo: atualizar .ai/ com o HEAD atual.\r\nCritério de sucesso: git status limpo e .ai/ consistente com git log.\r\nValidações: git status, git log --oneline -10, aios audit.\r\nRiscos: registrar informação não verificada.\r\nRollback: git restore .ai/.\r\nPróximo passo: validar ambiente real.\r\n```\r\n\r\n### 6. Autorize uma ação pequena\r\n\r\n```txt\r\naios act \"executar o primeiro milestone do plano\"\r\n```\r\n\r\nO agente deve agir com escopo limitado, validar o que fez e parar antes de commit ou push.\r\n\r\n### 7. Feche a sessão\r\n\r\nQuando terminar uma sessão relevante:\r\n\r\n```bash\r\nnpx @alvaro-alencar/aios@latest close --summary \"o que foi feito\" --next \"próximo passo\"\r\n```\r\n\r\nIsso atualiza `SESSION.md`, `HANDOFF.md` e `LOG.md`.\r\n\r\n## Instalação\r\n\r\nUse diretamente com npx, sem instalação global:\r\n\r\n```bash\r\nnpx @alvaro-alencar/aios@latest install all\r\n```\r\n\r\nOu instale globalmente:\r\n\r\n```bash\r\nnpm install -g @alvaro-alencar/aios\r\naios install all\r\n```\r\n\r\n## Fluxo recomendado\r\n\r\nPara deixar um projeto pronto para agentes de IA:\r\n\r\n```bash\r\ncd meu-projeto\r\nnpx @alvaro-alencar/aios@latest install all\r\nnpx @alvaro-alencar/aios@latest audit\r\n```\r\n\r\nDepois abra Codex, Claude Code, Cursor, Gemini CLI ou Copilot no projeto. O agente encontrará as instruções e executará o protocolo AIOS.\r\n\r\nEm ferramentas com suporte nativo ao comando, você pode digitar:\r\n\r\n```txt\r\naios observe\r\n```\r\n\r\nou, se a ferramenta tiver slash command configurado:\r\n\r\n```txt\r\n/aios\r\n```\r\n\r\nPor segurança, o fluxo AIOS entra em **OBSERVE** por padrão: o agente lê, audita, compara e resume, mas não altera código, não commita e não faz push.\r\n\r\nSem suporte nativo, use o handshake:\r\n\r\n```bash\r\nnpx @alvaro-alencar/aios@latest handshake\r\n```\r\n\r\nCopie a saída para o agente.\r\n\r\n## Modos operacionais\r\n\r\nAIOS separa observação, planejamento e execução para evitar que agentes virem workaholics sem autorização humana.\r\n\r\n### OBSERVE\r\n\r\n```bash\r\naios observe\r\n```\r\n\r\nModo seguro padrão. O agente deve ler a memória, comparar com o repositório, identificar riscos e sugerir próximos passos.\r\n\r\nEle não deve alterar código de produção, commitar ou fazer push.\r\n\r\n### PLAN\r\n\r\n```bash\r\naios plan\r\n```\r\n\r\nModo de planejamento. O agente deve transformar a observação em plano priorizado, sem executar.\r\n\r\nO plano deve ser organizado em milestones verificáveis, cada uma com:\r\n\r\n1. objetivo;\r\n2. critério de sucesso;\r\n3. validações ou comandos sugeridos;\r\n4. riscos;\r\n5. rollback ou caminho de reversão;\r\n6. próximo passo recomendado.\r\n\r\n### ACT\r\n\r\n```bash\r\naios act \"tarefa autorizada\"\r\n```\r\n\r\nModo de ação. O agente só deve executar a tarefa explicitamente autorizada.\r\n\r\nMesmo em ACT, commit e push exigem autorização separada.\r\n\r\n### CLOSE\r\n\r\n```bash\r\naios close --summary \"sessão concluída\" --next \"próximo passo\"\r\n```\r\n\r\nFecha a sessão e atualiza a memória operacional.\r\n\r\n## Rodapé operacional\r\n\r\nAs instruções geradas pelo AIOS orientam o agente a terminar respostas operacionais sugerindo próximos comandos AIOS. O usuário não precisa decorar a CLI.\r\n\r\nExemplo:\r\n\r\n```txt\r\nPróximos comandos AIOS sugeridos:\r\n- aios observe\r\n- aios plan\r\n- aios act \"corrigir primeiro item do plano\"\r\n- aios close --summary \"resumo\" --next \"próximo passo\"\r\n```\r\n\r\n## Uso rápido\r\n\r\n```bash\r\naios init        # cria .ai/ no projeto atual\r\naios bootstrap   # cria .ai/ e .ai/AIOS_AGENT_PROMPT.md\r\naios install all # cria .ai/ e instruções para agentes\r\naios observe     # modo seguro: audita e orienta sem alterar código\r\naios plan        # cria plano em milestones verificáveis, sem executar\r\naios act \"...\"   # executa apenas tarefa autorizada\r\naios handshake   # imprime o handshake universal em modo observe\r\naios open        # alias de handshake\r\naios prompt      # imprime o prompt completo para preencher a memória\r\naios audit       # verifica estrutura AIOS, marcadores pendentes e estado Git\r\naios doctor      # diagnóstico de saúde operacional da memória AIOS\r\naios status      # mostra resumo operacional\r\naios handoff     # imprime .ai/HANDOFF.md\r\naios close       # encerra sessão e atualiza SESSION, HANDOFF e LOG\r\n```\r\n\r\n## Arquivos gerados por `install all`\r\n\r\n```txt\r\n.ai/\r\n.ai/AIOS_AGENT_PROMPT.md\r\nAGENTS.md                          ← agentes compatíveis com instruções AGENTS.md\r\nCLAUDE.md                          ← Claude Code\r\n.cursor/rules/aios.mdc             ← Cursor\r\n.github/copilot-instructions.md    ← GitHub Copilot\r\n```\r\n\r\n## Exemplo de conversa com uma IA\r\n\r\nVocê:\r\n\r\n```txt\r\naios observe\r\n```\r\n\r\nIA:\r\n\r\n```txt\r\n[observado] Memória .ai/ encontrada.\r\n[observado] Branch main sincronizada com origin/main.\r\n[risco] SESSION.md não registra os dois últimos commits.\r\n[pendencia] Atualizar memória operacional antes de nova feature.\r\n\r\nPróximos comandos AIOS sugeridos:\r\n- aios plan\r\n- aios act \"sincronizar memória AIOS com HEAD atual\"\r\n```\r\n\r\nVocê:\r\n\r\n```txt\r\naios plan\r\n```\r\n\r\nIA:\r\n\r\n```txt\r\nMilestone 1: Sincronizar memória\r\nObjetivo: alinhar .ai/ com o estado real do Git.\r\nCritério de sucesso: SESSION e HANDOFF refletem o HEAD atual.\r\nValidações: git status, git log --oneline -10, aios audit.\r\nRiscos: registrar inferências como fatos.\r\nRollback: git restore .ai/.\r\nPróximo passo: validar testes do projeto.\r\n```\r\n\r\nVocê:\r\n\r\n```txt\r\naios act \"executar milestone 1\"\r\n```\r\n\r\nIA:\r\n\r\n```txt\r\n[observado] Alterei apenas .ai/SESSION.md, .ai/HANDOFF.md e .ai/LOG.md.\r\n[observado] Nenhum código de produção foi alterado.\r\n[observado] Não fiz commit nem push.\r\n```\r\n\r\n## Para quais ferramentas funciona?\r\n\r\nAIOS é agnóstico. Ele funciona melhor com agentes que conseguem ler arquivos e rodar comandos no repositório.\r\n\r\nTestado em fluxo real com:\r\n\r\n- Claude Code;\r\n- OpenAI Codex CLI;\r\n- Gemini CLI;\r\n- Cursor;\r\n- GitHub Copilot instructions.\r\n\r\nA regra é simples: se a ferramenta consegue ler o repositório, ela consegue seguir o protocolo.\r\n\r\n## Quando usar\r\n\r\nUse AIOS quando:\r\n\r\n- você trabalha com mais de uma IA no mesmo projeto;\r\n- você alterna entre sessões e perde contexto;\r\n- você precisa que agentes respeitem limites antes de agir;\r\n- você quer handoff claro entre humano e IA;\r\n- você quer registrar decisões, riscos, pendências e validações no próprio repositório.\r\n\r\nEvite usar como substituto de Git, testes, issues ou documentação real. AIOS complementa essas camadas.\r\n\r\n## O problema, em termos técnicos\r\n\r\nProjetos modernos são trabalhados por humanos, assistentes de código, agentes de CLI, copilotos, modelos locais e ferramentas diferentes. Cada agente entra no projeto com pouco contexto e pode repetir análise, desfazer decisões antigas, ignorar riscos ou quebrar fluxos críticos.\r\n\r\nCódigo mostra o que existe. Commits mostram o que mudou. Issues mostram parte do plano. Mas falta uma camada persistente para responder o que o projeto é, como funciona, qual é o estado atual, quais decisões importam e como validar mudanças com segurança.\r\n\r\nAIOS é essa camada.\r\n\r\n## Princípios\r\n\r\n1. O repositório é a fonte da verdade.\r\n2. A memória deve refletir o estado real do projeto.\r\n3. Fatos, inferências e dúvidas devem ser separados.\r\n4. Segredos nunca devem ser copiados para a memória.\r\n5. O próximo agente deve conseguir continuar o trabalho sem perguntar onde está.\r\n6. A memória deve ser útil antes de ser bonita.\r\n7. O protocolo deve ser agnóstico de stack, linguagem, framework e ferramenta de IA.\r\n8. Observar vem antes de planejar; planejar vem antes de agir.\r\n9. Execução exige autorização explícita.\r\n\r\n## Roadmap\r\n\r\n### Entregues\r\n\r\n- [x] Publicação npm `@alvaro-alencar/aios`\r\n- [x] Especificação inicial do protocolo\r\n- [x] Especificação AIOS Handshake v1\r\n- [x] Template padrão `.ai/`\r\n- [x] Prompt de inicialização manual\r\n- [x] CLI `aios init`\r\n- [x] CLI `aios bootstrap`\r\n- [x] CLI `aios install all` (Codex, Claude, Cursor, Copilot)\r\n- [x] CLI `aios observe`\r\n- [x] CLI `aios plan` com milestones verificáveis\r\n- [x] CLI `aios act`\r\n- [x] CLI `aios handshake` / `aios open`\r\n- [x] CLI `aios audit`\r\n- [x] CLI `aios status`\r\n- [x] CLI `aios handoff`\r\n- [x] CLI `aios close`\r\n- [x] Testes automatizados do CLI\r\n- [x] CLI `aios doctor` — diagnóstico com Structural Score, Git Score e Memory Score\r\n- [x] Semantic Memory Validator v1 — CONTEXT, DECISIONS, LOG, CHECKLIST e consistência cruzada\r\n\r\n### Pendentes\r\n\r\n- [ ] Estudos de caso reais por tipo de projeto — ver [`examples/README.md`](examples/README.md) (ga-core, marketplace Dr. Saulo, tutoria)\r\n\r\n### Divulgação (opcional, sem prazo)\r\n\r\n- [ ] Tutorial em vídeo ou GIF curto\r\n\r\n## Status\r\n\r\nAIOS está publicado no npm como `@alvaro-alencar/aios`.\r\n\r\nA versão atual é `0.1.3`, com todos os modos operacionais (OBSERVE, PLAN, ACT, CLOSE), `aios doctor` com Semantic Memory Validator, e cobertura de testes automatizados.\r\n","readmeFilename":"README.md"}