Agent Zero UI

ChatGPT-style local web UI for talking to Agent Zero through the Agent Zero Gateway or directly to a running Agent Zero server.

See ROADMAP.md for planned richer agent inventory cards, session rename/archive/delete, Agent Work timing, and future memory approval UX.

Requirements

• Node.js 22+
• A running Agent Zero Gateway at http://127.0.0.1:7400, or a direct Agent Zero backend, usually:

cd ~/Agents/agent-zero
node ./bin/agent-zero.js serve \
  --profile base \
  --port 7331 \
  --cors http://localhost:5173

For bearer-token auth:

AGENT_ZERO_API_TOKEN=dev-token node ./bin/agent-zero.js serve \
  --profile base \
  --port 7331 \
  --cors http://localhost:5173 \
  --api-token env:AGENT_ZERO_API_TOKEN

Then enter the token in the UI connection panel.

Development

npm install
npm run dev

Open:

http://localhost:5173

Build

npm run build

Current MVP

• Configure gateway/direct Agent Zero backend URLs and optional tokens.
• View server/session health.
• List sessions.
• Create sessions with profile selection.
• Select a session.
• View conversation messages.
• Send messages.
• Stream session events with fetch-based SSE parsing so bearer auth works.
• Abort active turn.
• Inspect runtime state, active tools, recent events, available agents, and persisted Agent Work from turn summaries.

Notes

This project is intentionally a separate frontend consumer of Agent Zero's native HTTP API. Agent Zero remains the runtime/backend.