How chelinho139/wow-ai works
wow-ai connects a World of Warcraft addon to local coding-agent CLIs through a screen-captured pixel-strip channel and load-on-demand reply slots. The player sends a task in-game; the bridge decodes it, runs the selected agent, and returns the reply for the addon to display and echo in chat. Separate capabilities include persistent multi-chat sessions, character context, map layers and navigation, gathering nodes, macros, permission retries, and bridge-status signals. The bridge’s central orchestration and protocol modules are excerpted; addon internals and some integrations are represented from README documentation, so their detailed internal links are omitted.
Main entry points: bridge.js Bridge orchestrator · WoWAI.lua WoW AI addon · agents.js Agent adapters · Inbox.lua Inbox and replies
Components 21
In-game experience
- WoW AI addon
addon/WoWAI/WoWAI.lua - Pixel codec
addon/WoWAI/Codec.lua - Inbox and replies
addon/WoWAI/Inbox.lua - Map display
addon/WoWAI/Map.lua
Bridge transport
- Screen capture
bridge/capture_x11.py - macOS capture
bridge/capture_mac.py - Bridge orchestrator
bridge/bridge.js - Protocol and formatting
bridge/protocol.js - Reply slot files
bridge/install-slots.js - Chat and session state
bridge/bridge.js
Agent runtime
- Agent adapters
bridge/agents.js
Chat capabilities
- Multi-chat sessions
bridge/bridge.js - Character context
addon/WoWAI/WoWAI.lua - Routes and map layers
bridge/protocol.js - Gathering spawns
addon/WoWAI/Map.lua - Macro creation
bridge/protocol.js - Allow and retry
bridge/agents.js - Bridge status
bridge/bridge.js
Other components
- Player
- WoW client
- Local agent CLIs
Connections 27
- Player → WoW AI addon: sends task
README.md - WoW AI addon → Pixel codec: encodes message
README.md - Pixel codec → WoW client: draws strip
README.md - WoW client → Screen capture: shows strip
README.md - WoW client → macOS capture: shows strip
README.md - Screen capture → Bridge orchestrator: emits decoded record
bridge/capture_x11.py - macOS capture → Bridge orchestrator: emits decoded record
bridge/capture_mac.py - Bridge orchestrator → Protocol and formatting: uses protocol
bridge/bridge.js - Bridge orchestrator → Agent adapters: starts agent
bridge/bridge.js - Agent adapters → Local agent CLIs: runs CLI
bridge/agents.js - Bridge orchestrator → Chat and session state: persists sessions
bridge/bridge.js - Bridge orchestrator → Reply slot files: writes reply slots
README.md - Reply slot files → Inbox and replies: provides slot data
bridge/install-slots.js - WoW client → Inbox and replies: loads reply slot
README.md - Inbox and replies → WoW AI addon: displays reply
- WoW AI addon → Player: echoes reply
README.md - WoW AI addon → Character context: supplies game context
README.md - Agent adapters → Routes and map layers: provides map tools
README.md - Bridge orchestrator → Routes and map layers: processes map layers
README.md - Routes and map layers → Map display: ships map layers
README.md - Map display → WoW client: shows routes
README.md - WoW client → Gathering spawns: filters spawns
README.md - Protocol and formatting → Macro creation: extracts macros
bridge/protocol.js - Bridge orchestrator → Allow and retry: handles denials
bridge/bridge.js - Agent adapters → Allow and retry: reports refusals
bridge/agents.js - Bridge orchestrator → Bridge status: updates signals
bridge/bridge.js - Bridge status → WoW client: signals presence
README.md