
AiOperationsRoom
Sala de operações local para acompanhar sessões e subagentes do Claude Code.
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up AiOperationsRoom (git-clone project) into my current project. Found on https://claudeers.com/aioperationsroom Repo: https://github.com/mewsdev/AiOperationsRoom Homepage/docs: — Detected install method: git-clone → git clone https://github.com/mewsdev/AiOperationsRoom Category: devtools. Platforms: cli, api, mobile. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: active; community-verified: false. Confirm the source before running anything.
git clone https://github.com/mewsdev/AiOperationsRoom
// compatibility
| Platforms | cli, api, mobile |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | JavaScript |
AI Operations Room
Uma sala local para acompanhar sessões e subagentes do Claude Code. O aplicativo recebe somente metadados de hooks, mantém os dados em SQLite local e serve a interface em 127.0.0.1.
Requisitos
- Python 3.12 ou superior
uvinstalado e disponível no terminal- Claude Code, somente para acompanhar sessões reais
Início rápido
uv sync --extra dev
uv run python -m backend.cli hooks-install
uv run python -m backend.cli serve
Execute os comandos na pasta deste repositório. Abra http://127.0.0.1:8765 e deixe o terminal do servidor aberto enquanto usa a sala; Ctrl+C encerra o servidor. O hook continua instalado depois que o servidor para e registra eventos para a próxima abertura. A tela Projetos associa um diretório local a cada nome exibido na sala. O caminho mais específico vence. Uma sala aparece quando há uma sessão capturada nesse diretório; cadastrar um projeto sozinho não cria uma sala vazia.
Mantenha a pasta do repositório no mesmo lugar após instalar os hooks: o comando registrado no Claude Code aponta para o caminho local deste checkout. Se precisar movê-la, execute hooks-remove antes da mudança e hooks-install na nova localização.
Abrir automaticamente ao entrar no Windows
Depois de executar uv sync --extra dev e hooks-install uma vez, você pode iniciar o servidor em segundo plano e abrir o navegador com:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\start-room.ps1
O script usa a porta 8765, espera a API responder e abre a sala. Se a porta já estiver ocupada, ele encerra com erro em vez de abrir outra aplicação. Para usar outra porta, acrescente -Port 8898 ao comando. Se o atalho não abrir a sala, execute o comando manualmente em um terminal para ver o erro; erros de um atalho oculto não aparecem na tela.
Para executar esse script em cada login do Windows:
- Pressione
Win+R, digiteshell:startupe pressione Enter. - Na pasta aberta, crie um atalho. Como destino, use
powershell.exe -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File "C:\caminho\para\AiOperationsRoom\scripts\start-room.ps1", trocando o caminho pelo local real do repositório. - Faça logout e login para testar. Para desativar a abertura automática, remova esse atalho da pasta Inicializar.
O script inicia apenas o servidor real. A demonstração abaixo usa dados separados e deve ser aberta com demo --serve. A Microsoft documenta a pasta shell:startup para aplicativos iniciados no login.
Demonstração
O modo demo cria uma fila e um banco separados em ~/.ai-operations-room-demo, sem acessar dados reais ou precisar do Claude Code. Projetos cadastrados na demo não aparecem no servidor real, e vice-versa.
uv run python -m backend.cli demo --serve
Abra http://127.0.0.1:8765 e interrompa o processo quando terminar. Para apenas gerar os dados fictícios, omita --serve. Ao executar demo novamente, os eventos e horários fictícios são renovados; sessões da demo não são classificadas como órfãs por falta de PID.
Use --port 8876 em qualquer comando de servidor quando a porta padrão já estiver ocupada.
Hooks do Claude Code
O registro altera ~/.claude/settings.json: adiciona um command hook para SessionStart, UserPromptSubmit, Stop, SubagentStart, SubagentStop e SessionEnd. Antes de alterar o arquivo, revise seu conteúdo.
uv run python -m backend.cli hooks-install
uv run python -m backend.cli hooks-remove
hooks-remove remove somente entradas cujo comando aponta para hooks/capture.py deste checkout, mesmo se o executável Python tiver mudado. Ele preserva os demais hooks e configurações.
No Windows, hooks-install registra PowerShell explicitamente e também corrige um hook antigo deste checkout que tenha sido criado sem o campo shell.
O hook registra identificadores, tipo de agente, diretório de trabalho, razão de encerramento e a hora do evento. Ele não salva prompts, respostas nem transcrições. Para detectar sessões interrompidas sem hook de encerramento, o servidor consulta o identificador da sessão e o PID em ~/.claude/sessions; não copia o conteúdo desses arquivos para o banco. Os dados ficam por padrão em ~/.ai-operations-room; defina AI_OPERATIONS_ROOM_DATA_DIR para usar outra pasta.
O Painel usa um período selecionável de 6, 12 ou 24 horas. O Escritório mostra execuções ativas e as encerradas nas últimas 12 horas; apenas sessões principais sem subagentes encerradas em menos de 30 segundos são ocultadas da sala.
Sugestões de agentes
Estou compartilhando também 2 agentes que eu utilizo nos meus projetos de trabalho e pessoaisSUGESTAO_DE_AGENTES.md: um revisor de código e um pesquisador de contexto.
Desenvolvimento
.venv\Scripts\python.exe -m pytest -q --basetemp=.test-temp
node --check frontend/app.js
node --test tests/js/pixel.test.js
Consulte ARCHITECTURE.md, DEVELOPMENT.md e HANDOFF.md para decisões e pontos de extensão.
Limites atuais
- A interface consulta a API a cada quatro segundos.
- Esta versão é destinada somente ao Windows. macOS e Linux não foram validados; no macOS, a detecção de sessões órfãs ainda não funciona. Em 08/10/2026, uma sessão real do Claude Code com subagente Explore foi capturada no Windows, e a API exibiu a filha concluída e o principal trabalhando novamente.
- O suporte de hooks foi validado com o formato documentado do Claude Code. O registro assistido usa o arquivo global de configurações do usuário; configurações gerenciadas pela organização podem impedir hooks locais.
- O serviço é local e não fornece autenticação ou acesso remoto.
Inspiração visual
A sala pixel foi inspirada pelo Pixel Agents, da equipe Pixel Agents. Os personagens e móveis foram criados para este projeto; nenhum asset do Pixel Agents é usado.
Licença
Distribuído sob a licença MIT.
// faq
What is AiOperationsRoom?
Sala de operações local para acompanhar sessões e subagentes do Claude Code.. It is open-source on GitHub.
Is AiOperationsRoom free to use?
AiOperationsRoom is open-source under the MIT license, so it is free to use.
What category does AiOperationsRoom belong to?
AiOperationsRoom is listed under devtools in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/aioperationsroom)
// retro hit counter
[](https://claudeers.com/aioperationsroom)
// reviews
// guestbook
// related in Developer Tools
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Curs…
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…
Use Garry Tan's exact Claude Code setup: 23 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA