PoB AI

An AI agent and a command line for Path of Building (PoE2). Ask in plain words. The agent reads your build, changes it, calculates, and points at the exact spot in PoB.

English · 한국어

Why

Path of Building is the most precise tool for Path of Exile 2 builds, and it takes years to learn where everything lives. PoB AI lets an AI agent do the clicking for you, through a complete command line, so every step is real PoB work you can see, undo and save.

• Download once. PoB AI attaches to the Path of Building you already have, without changing a single PoB file. PoB keeps updating itself and PoB AI follows; PoB AI updates itself with one click.

• The whole editor from the command line. 142 commands cover builds and folders, loadouts, character import, passive tree, skills and gems, items (crafting, anoints, runes, corruption), trade searches, configuration, calculations, party, notes and PoB's own options.

• It shows you where. Ask "where do I set the enemy type?" and the agent switches PoB to the Configuration tab and highlights the option. Nodes, item slots, gem groups and stats work the same way.

• Real numbers only. What-if calculations, passive node ranking and build comparison use PoB's own calculator.

• Your language, everywhere. The PoB window, the panel and the agent's answers in ten languages, with the official in-game names. Items copied from the game in any client language are converted to the English text PoB reads.

• Uses the agent you already have. Claude Code (or Codex) runs with your existing sign-in. No API keys.

Related MCP server: rvn

Install

Requirements: Windows 10/11 and, for chat, Claude Code (or Codex) signed in.

1. Download pob-ai-<version>-win-x64.zip from Releases and unzip it anywhere. Node.js is included.

2. Double-click PoB AI.cmd. It opens your PoB and the agent panel.

PoB AI finds Path of Building Community (PoE2) in the usual install locations. Point it at a portable copy once, or let it install PoB for you:

pob setup "D:\Games\Path of Building PoE2"   # use this PoB
pob setup --install-pob                      # download the latest portable PoB from its GitHub releases

bin\pob.cmd is the command line; add the bin folder to PATH to use pob anywhere.

git clone https://github.com/tjdcks12/pob-ai.git
cd pob-ai
npm install          # Node.js 22+
npm start            # service, PoB window and panel
node bin/pob.mjs help

npm link puts pob on your PATH.

Talk to it

Set up PoB to measure my damage properly against a pinnacle boss.

Which passive within 6 points gives me the most damage? Show me where it is.

Import https://pobb.in/… and compare it with my build.

Add this item and tell me what it changes. (paste the item copied in game)

Find rings like the one I'm wearing on the trade site.

The agent answers in your language and uses the official in-game names.

The pob command line

Every command prints JSON, so agents and scripts can use it directly.

pob build import https://pobb.in/abc123          # code or link: pobb.in, poe.ninja, Maxroll, poe2db, pastebin
pob tree allocate "Essence of the Storm" --attribute int
pob tree allocate 태풍의 정수                      # game names work in any of the ten languages
pob skills add Spark "Controlled Destruction" --level 20
pob config set enemyIsBoss Pinnacle
pob calc whatif --node "Clean Shot"              # numbers without keeping the change
pob calc node-power --limit 5                    # best nearby notables by Full DPS
pob items add --text "<item copied in game>" --equip "Ring 1"
pob items trade "Ring 1" --min-percent 90        # trade search link for items like this one
pob ui show-config enemyIsBoss                   # highlight it in the PoB window
pob build save --name "Spark Ranger v2"

Full reference: docs/COMMANDS.md. pob help <group> <action> shows the same in the terminal.

When the PoB window is open, commands change what you see there. Without it, they work on a background copy of your build, so agents can explore ideas without touching your screen. PoB's Find Timeless Jewel search is switched off in PoB PoE2 itself, so it has no command yet.

Your language

PoB's bitmap fonts only contain ASCII, so translated text is drawn as small images with a Windows font for the language. Text without a translation stays in English.

Updates

• PoB updates itself as always. PoB AI attaches to whichever version is installed, and after PoB restarts for its own update, PoB AI is attached again automatically.

• PoB AI checks for a new version once a day and offers it in the panel. Click Update or run pob update apply --restart. The update is verified (SHA-256), unpacked into your data folder and used from the next start. The PoB window stays open and reconnects.

Something off? pob doctor checks the PoB install, the adapter against your PoB version, the window connection, updates and agents, and says what to do. Logs are in %LOCALAPPDATA%\pob-ai\logs.

How it works

flowchart LR
  you([You]) --> panel[Agent panel]
  panel --> agent[Claude Code / Codex]
  agent -->|pob …| service[PoB AI service]
  service -->|live| pob[Your PoB window]
  service -->|background| engine[Headless PoB]

The PoB launcher accepts an entry script as its first argument. PoB AI starts your PoB with adapter/shim.lua, which loads PoB normally and adds a small bridge that runs commands between frames and draws the highlights, the themes and the translated text. The same Lua operations also run without a window, inside PoB's own LuaJIT, for background work. Details: docs/ARCHITECTURE.md · docs/POB_INTERNALS.md.

It also speaks MCP: any MCP client can use the same commands as tools (pob_<group>_<action>) at the service's /mcp endpoint. The address and token are in %LOCALAPPDATA%\pob-ai\service.json; send Authorization: Bearer <token>.

Privacy

Everything runs on your PC. PoB AI goes online only:

• to download a build you ask it to import, or to upload one you ask it to share;

• for Korean item text, to fetch the official trade stat lists from Grinding Gear Games / Kakao (cached for a day);

• to check its update feed once a day, and to download an update or PoB when you ask;

• through PoB itself, for what PoB does online (account import, trade, PoB's own update check).

Chats go to the agent you chose, under its own terms.

Status

Early preview, verified on Windows 11 with PoB PoE2 0.22.0 and 0.23.1: every command has an adapter operation, and the engine suite runs build, tree, skill, item, config, calc, set, party and option operations against the background engine (npm test); the PoB window bridge, highlights, themes and window translation, PoB's in-place restart (the path of PoB's usual updates) and a simulated relaunch by PoB's updater, PoB AI self-update and PoB installation against a local release server.

Not yet verified: a full chat with a signed-in Claude Code or Codex (tested with a stand-in agent), PoE account character import with a real sign-in, and a published release (the update feed goes live with the first GitHub release).

Development

npm test                          # unit tests, plus engine tests against your PoB (set POB_PATH if it is not found)
node scripts/package.mjs          # dist/pob-ai-<version>-win-x64.zip and dist/latest.json
node scripts/gen-commands.mjs     # regenerate docs/COMMANDS.md

Maintainers refresh the bundled game text after a game patch with node scripts/sync-game-data.mjs <poe2way-overlay> <poe2way>; it reads the private data repositories the text is extracted into. Contributors use data/ as it is.

Pushing a v<version> tag builds and publishes a release (.github/workflows/release.yml). A daily workflow runs the tests against the latest PoB release.

License

MIT, like Path of Building. PoB AI does not include Path of Building; see THIRD_PARTY_NOTICES.md for bundled components and game text.

PoB AI is an unofficial community project, not affiliated with Grinding Gear Games or the Path of Building Community. Path of Exile is a trademark of Grinding Gear Games.