convez.ai
AgenteDevOps & InfraestruturaIntermediário
Ar9av

AgentTower

Ar9av/AgentTower

Sala de controle web para agentes de IA de codificação em tempo real

Ver no GitHub
InicialPluginScore · de 0 a 100

Interface web em tempo real para monitorar, pesquisar e controlar sessões de Claude Code e OpenAI Codex CLI. Funciona como uma sala de controle local para agentes de codificação, oferecendo visualização completa de conversas, controle de processos, busca global e suporte multi-agente.

Instalação

$npx convez-ai Ar9av/AgentTower

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
12
Forks
1
Acompanhando
0
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
1
Contribuidores
2

Casos de uso

  • Monitorar e controlar múltiplas sessões de Claude Code simultaneamente
  • Pesquisar globalmente através de conversas de agentes para encontrar contexto específico
  • Visualizar diffs em tempo real de edições de código feitas por agentes
  • Bifurcar e continuar sessões de agentes a partir de qualquer ponto da conversa
  • Gerenciar workflows de orquestração com múltiplos agentes

Veredito

AgentTower é uma solução madura e bem-implementada para quem trabalha intensivamente com agentes Claude ou Codex. Interface responsiva, suporte multi-plataforma (web + iOS), e funcionalidades robustas de controle e observabilidade. Essencial para dev teams gerenciando múltiplos agentes em produção.

README

A tradução para o português deste README ainda está na fila.

For AI agents: See AGENTS.md — it has a fully automated setup script that requires only a password from the user.


About

AgentTower is a local control room for coding agents. It supports both Claude Code and OpenAI Codex CLI:

  • Claude mode reads sessions from ~/.claude/projects, supports live steering, process controls, Tower view, analytics, bookmarks, and orchestrator workflows.
  • Codex mode reads sessions from ~/.codex/sessions, groups them by project workspace, and supports starting work with codex exec plus continuing it with codex exec resume.

You can switch between Claude and Codex at the top of the Projects view.


Quick start

git clone https://github.com/Ar9av/AgentTower && cd AgentTower
echo "AUTH_PASSWORD=yourpassword" > .env.local
npm install && npm run dev

Open http://localhost:3000 — sign in with the password you set. That's it.

iOS client

There is now a SwiftUI iPhone/iPad client in ios/.

  • It connects to a running AgentTower server and renders the existing UI in a native shell
  • It does not replace the desktop/server app, because iOS cannot read ~/.claude or ~/.codex locally
  • Generate the Xcode project with cd ios && xcodegen generate

What it does

Session viewer

  • Full conversation rendering — user messages, agent responses, tool calls, tool results, thinking blocks
  • Inline diff viewer — Edit and MultiEdit tool calls render as a real red/green unified diff
  • Terminal-style Bash — Bash tool calls show the command with a $ prompt and scrollable output
  • Markdown tables — tables in agent responses render as proper HTML tables
  • Copy buttons — copy any code block or message text with one click
  • Live tail — new messages appear in real time via SSE while the agent is running
  • Deep-link to message — search results jump straight to the matching message in context
  • In-session filter — type in the session header to filter messages by text
  • Export to Markdown — download the full conversation as a .md file

Session control

  • Send input — inject a new message into any running or finished session
  • Fork from any message — create a copy of the conversation up to any point and branch from there
  • Kill / Pause / Resume — full process control for Claude sessions with confirmation
  • Stop & resend — kill the current task and immediately start a new one

Multi-agent support

  • Claude mode — project discovery from ~/.claude/projects, live session steering, process-aware status, and Tower visualization
  • Codex mode — project discovery from ~/.codex/sessions, codex exec launch, and codex exec resume continuation
  • Codex model switcher — choose the model for a new Codex run before launch, including a custom codex exec --model override
  • Mode switcher — swap between Claude and Codex project views from the top of the Projects page

Global search

  • Cross-session search — grep across every session file with live results
  • Regex mode — toggle .* for full regex patterns
  • Filter by project — narrow results to a single project
  • Sort by newest, oldest, or most hits

Agent Tower (visual monitor)

  • Office scene — pixel-art building with agents placed on floors by status: working → Office, done → Boardroom, idle → Lounge
  • Live state — agents animate between idle / working / done / signaling as sessions change
  • Lift car — animates between floors whenever an agent changes status
  • Click any agent — inspect messages and send input without leaving the Tower
  • Dispatch task — spawn a new Claude agent from the Commander button
  • Dark + light mode — night sky in dark mode, warm sky in light mode

Projects & navigation

  • Projects grid — Claude and Codex projects at a glance, active ones highlighted with a pulsing dot
  • Session list — Active / History split per project with message counts and cost estimates
  • Git branch badge — shows which branch each session ran on
  • Cmd+K — focus the global search from anywhere

Daily Brief

  • Scheduled morning summaries delivered to Telegram
  • Per-project task types: code improvements, bug fixes, docs, Obsidian notes
  • Output formats: GitHub PR, PDF, Telegram message, text summary
  • Manual trigger + brief history

Prerequisites

  • Node.js 18+ — node --version
  • npm 9+ — npm --version
  • Claude Code — optional, needed for Claude mode and Tower/process controls
  • Codex CLI — optional, needed for Codex mode and codex exec / codex exec resume

Configuration

All config via .env.local (gitignored).

VariableRequiredDefaultDescription
AUTH_PASSWORDYes—Login password
CLAUDE_DIRNo~/.claudeClaude config root
CODEX_DIRNo~/.codexCodex config root
SESSION_TTL_DAYSNo7Cookie lifetime in days
ACTIVE_THRESHOLD_SECSNo300Seconds window for "active" badge
NEXT_PUBLIC_BASE_PATHNo—Sub-path deployment, e.g. /agents

Minimal .env.local

AUTH_PASSWORD=my-secure-password

Sub-path deployment (e.g. behind a reverse proxy at /agents)

AUTH_PASSWORD=my-secure-password
NEXT_PUBLIC_BASE_PATH=/agents

Running

# Development (hot reload)
npm run dev

# Production
npm run build && npm start

# Custom port
PORT=8484 npm start

Persistent server (Linux / remote machine)

npm run build
npm install -g pm2
pm2 start "npm start" --name agenttower
pm2 save

Behind a reverse proxy (Apache / nginx)

For nginx, proxy location /agents/ to http://localhost:3000 and set NEXT_PUBLIC_BASE_PATH=/agents in .env.local.

For Apache:

<Location /agents/>
  ProxyPass        http://localhost:3000/agents/
  ProxyPassReverse http://localhost:3000/agents/
</Location>

Project structure

agenttower/
├── app/
│   ├── api/                    REST + SSE endpoints
│   │   ├── auth/               login / logout
│   │   ├── projects/           list projects
│   │   ├── sessions/           list sessions per project
│   │   ├── session/            parse JSONL (paginated, supports ?around=<uuid>)
│   │   ├── tail/               SSE live stream
│   │   ├── search/             cross-session grep
│   │   ├── fork/               copy session up to a message UUID
│   │   ├── run/                spawn new Claude or Codex process
│   │   ├── input/              send message to a running session
│   │   ├── kill / pause /      process signals
│   │   │   resume/
│   │   ├── recent-sessions/    last N sessions across all projects
│   │   ├── upload-image/       image attachment support
│   │   └── daily-brief/        brief config, history, trigger
│   ├── login/                  login page
│   ├── projects/               projects grid
│   ├── project/                sessions for one project
│   ├── session/                full session reader
│   ├── search/                 global search
│   ├── tower/                  Agent Tower visual monitor
│   ├── daily-brief/            daily brief config + history
│   └── integrations/           Telegram + Antigravity settings
├── components/
│   ├── MessageBlock.tsx         renders all message/tool block types
│   ├── LiveSession.tsx          SSE client, auto-scroll, input, fork
│   ├── TowerView.tsx            pixel-art office scene + agent sprites
│   ├── Nav.tsx                  sticky nav with Cmd+K search
│   └── ...
├── lib/
│   ├── auth.ts                  PBKDF2 hashing, rate limiting, cookies
│   ├── claude-fs.ts             JSONL parser, project discovery, search, SSE
│   ├── codex-fs.ts              Codex session discovery and transcript parsing
│   ├── types.ts                 shared TypeScript types
│   └── world-engine/            tile-map renderer for the Tower scene
├── public/sprites/              agent + building sprite sheets
├── AGENTS.md                    automated setup guide for AI agents
└── SETUP.md                     step-by-step human setup guide

How the data works

Claude Code writes session logs to ~/.claude/projects/<encoded-path>/<session-id>.jsonl. Codex CLI writes session logs under ~/.codex/sessions/.

AgentTower:

  1. Walks ~/.claude/projects/ for Claude projects and ~/.codex/sessions/ for Codex projects
  2. Parses JSONL files into typed transcript messages (cached by path + mtime)
  3. Reads ~/.claude/sessions/<pid>.json to detect running Claude processes
  4. Streams new lines via SSE by tracking file byte offsets for both Claude and Codex transcripts

Security

  • Passwords hashed with PBKDF2-HMAC-SHA256 (260k iterations + random salt). Plaintext never stored.
  • Exponential backoff on failed logins: 2s → 4s → 8s → … capped at 1 hour per IP.
  • HttpOnly + SameSite=Strict cookies.
  • All API routes require a valid session cookie.
  • File paths validated against CLAUDE_DIR or CODEX_DIR before reading (no path traversal).
  • Process signals verify the target PID is a claude process owned by the current user.

For remote/production access:

  • Put behind HTTPS (Caddy, nginx + Let's Encrypt, or Cloudflare)
  • Use a long random AUTH_PASSWORD (32+ chars)
  • Consider Tailscale or Cloudflare Access for an extra auth layer

Troubleshooting

SymptomFix
AUTH_PASSWORD is not setCreate .env.local with AUTH_PASSWORD=yourpassword
No projects showingCheck ~/.claude/projects/ exists and has .jsonl files
No Codex projects showingCheck ~/.codex/sessions/ exists and Codex has been run at least once
Live tail not updatingCheck browser console for SSE errors; reload the page
EADDRINUSE on port 3000PORT=8484 npm start
Can't log inNo spaces or quotes around the password value in .env.local
Tower shows no agentsSessions must exist — run a Claude Code session first
Ver o original no GitHub

Bom para

Relacionados