How humaedihume/kantor-agent works
Kantor Agent is a local Claude Code activity viewer: its server reads real project transcripts, summarizes main-session and subagent activity, assigns subagents to team members or freelancers, and serves a 3D office and status panel to a browser. Node and PHP are alternative server implementations. README describes the launcher, polling, transcript privacy, UI capabilities, and optional tunnel; several implementation details—especially browser rendering and Node server routing—were not excerpted, so those links are documented rather than inferred from names.
Main entry points: serve-node.mjs Node HTTP server · index.php PHP HTTP entry · transcripts.mjs Transcript scanner · Transcripts.php PHP transcript scanner
Components 21
Launch and configuration
- Command launcher
skills/kantor-agent/runtime/bin/kantor.sh - Agent skill
skills/kantor-agent/SKILL.md - Default settings
skills/kantor-agent/runtime/defaults.json - Node configuration
skills/kantor-agent/runtime/lib/node/config.mjs - PHP configuration
skills/kantor-agent/runtime/lib/php/Config.php
Transcript processing
- Transcript scanner
skills/kantor-agent/runtime/lib/node/transcripts.mjs - PHP transcript scanner
skills/kantor-agent/runtime/lib/php/Transcripts.php - Claude transcripts
- Summary cache
- Node text utilities
skills/kantor-agent/runtime/lib/node/util.mjs - PHP text utilities
skills/kantor-agent/runtime/lib/php/Util.php
Activity and assignment
- Node activity model
skills/kantor-agent/runtime/lib/node/office.mjs - PHP activity model
skills/kantor-agent/runtime/lib/php/Office.php
HTTP and presentation
- Node HTTP server
skills/kantor-agent/runtime/bin/serve-node.mjs - PHP HTTP entry
skills/kantor-agent/runtime/public/index.php - PHP HTTP safeguards
skills/kantor-agent/runtime/lib/php/Http.php - Office page
skills/kantor-agent/runtime/views/page.html - 3D office and panel
skills/kantor-agent/runtime/public/assets/kantor.js
Other components
- Claude Code user
- User browser
- Cloudflared tunnel
Connections 29
- Claude Code user → Agent skill: invokes command
README.md - Agent skill → Command launcher: starts runtime
README.md - Command launcher → Node HTTP server: selects Node
README.md - Command launcher → PHP HTTP entry: selects PHP
README.md - Node configuration → Default settings: loads defaults
skills/kantor-agent/runtime/lib/node/config.mjs - PHP configuration → Default settings: loads defaults
skills/kantor-agent/runtime/lib/php/Config.php - Node configuration → Node text utilities: uses helpers
skills/kantor-agent/runtime/lib/node/config.mjs - PHP configuration → PHP text utilities: uses helpers
skills/kantor-agent/runtime/lib/php/Config.php - Transcript scanner → Claude transcripts: reads summaries
README.md - PHP transcript scanner → Claude transcripts: reads summaries
README.md - Transcript scanner → Summary cache: stores incremental state
skills/kantor-agent/runtime/lib/node/transcripts.mjs - PHP transcript scanner → Summary cache: stores incremental state
skills/kantor-agent/runtime/lib/php/Transcripts.php - Transcript scanner → Node text utilities: uses helpers
skills/kantor-agent/runtime/lib/node/transcripts.mjs - PHP transcript scanner → PHP text utilities: uses helpers
skills/kantor-agent/runtime/lib/php/Transcripts.php - Node activity model → Transcript scanner: scans activity
skills/kantor-agent/runtime/lib/node/office.mjs - PHP activity model → PHP transcript scanner: scans activity
skills/kantor-agent/runtime/lib/php/Office.php - Node activity model → Node text utilities: uses helpers
skills/kantor-agent/runtime/lib/node/office.mjs - PHP activity model → PHP text utilities: uses helpers
skills/kantor-agent/runtime/lib/php/Office.php - Node HTTP server → Node activity model: builds state
README.md - Node HTTP server → Node configuration: loads settings
- PHP HTTP entry → PHP activity model: builds state
skills/kantor-agent/runtime/public/index.php - PHP HTTP entry → PHP configuration: loads settings
skills/kantor-agent/runtime/public/index.php - PHP HTTP entry → PHP HTTP safeguards: checks host
skills/kantor-agent/runtime/public/index.php - Node HTTP server → Office page: serves page
README.md - PHP HTTP entry → Office page: serves page
README.md - User browser → Node HTTP server: polls state
README.md - User browser → PHP HTTP entry: polls state
README.md - Office page → 3D office and panel: loads interface
- Node HTTP server → Cloudflared tunnel: exposes optionally
README.md