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

In PoB AI settings, Character refresh binds a chosen account character to the currently saved PoB file. Pick a 1, 2, 5 or 10 minute interval and turn on Automatic refresh (off by default). It refreshes passives, jewels, equipment and skills, preserves the main skill and calculation settings, then saves the same file. Unsaved edits, another open file or sign-out pause refresh. A missing or ambiguous main skill leaves the previous build intact and requires a manual import. The previous file is backed up under %LOCALAPPDATA%\pob-ai\backups\character-sync. Keep PoB open through PoB AI and signed in; refresh uses the character snapshot available on the game server.

In poe2way desktop, load that same XML file and enable Settings → PoB → Automatically reload changed save file (also off by default). It checks every five seconds and updates the current build and open Alt+E comparison.

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. 144 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.

• One theme for both windows. Choose PoB original, Dark, Light, Ocean, Forest or Sand once for the panel and PoB together. PoB original is the initial default. Custom themes use Pretendard, responsive calculation tables and themed tooltips while keeping PoB's category colours.

• AI and settings, separately. The PoB AI title bar is always enabled. Its AI button opens or brings the agent panel forward. The gear opens a separate settings modal for appearance, languages, PoB and agent setup.

• Uses the agent you already have. Claude Code, Codex or Antigravity runs with your existing sign-in: pick it from the cards, chat in several tabs at once, choose the model and reasoning effort, attach screenshots. No API keys.

Related MCP server: pob-mcp

Install

Requirements: Windows 10/11 and, for chat, a signed-in CLI: Claude Code, Codex (0.50.0 or newer) or Antigravity (1.4.4 or newer). Antigravity uses the official agy CLI, which is installed separately from its IDE. PoB AI detects it on PATH or in %LOCALAPPDATA%\agy\bin; a custom executable can be selected in Settings.

1. Download the latest Windows ZIP and unzip it anywhere. Node.js is included.

2. Double-click PoB AI.exe. It opens PoB and the agent panel without a console window. PoB AI.cmd remains a compatibility shortcut.

If PoB is not installed, the agent panel still opens and shows Install PoB and Connect existing PoB. Installation downloads the official portable PoB release and opens it automatically. Connecting an existing copy opens the folder setting in its own window, which works without a PoB window. The composer and suggested questions stay hidden until PoB is found.

Chat failures explain the cause and the next step: sign-in expiry, an outdated CLI, network or usage limits, an unavailable model, or CLI setup problems. Diagnostics shows the detected CLI version, exit code and scrubbed error details; Copy diagnostics makes a report you can share when asking for help. For an outdated Codex installation, run npm install -g @openai/codex in PowerShell, then retry. For Antigravity, run agy update. For an expired sign-in, use the Sign in button on the error message.

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

Use + beside the chat tabs to start another conversation with Claude Code, Codex or Antigravity. Each tab keeps its own draft and attachments. Choose the model and reasoning effort beside the composer, or open History to resume a previous conversation.

The agent picker provides Sign in with Claude, Sign in with ChatGPT or Sign in with Google using the installed CLI's browser authentication flow, only when the CLI reports that it is signed out. Signed-in agents show no login or account prompt. Sign-in progress and cancellation stay in the panel; no terminal is opened. Create account opens the provider's official website, and a setup-guide button is shown when the CLI is missing. If Antigravity shows an authorization code in the browser, paste it into the panel's Authorization code field and choose Complete sign-in. Codes are forwarded only to the waiting CLI and are not saved in chat history or logs. After installation, return to the panel to detect it again.

Choose Allow full access when starting a new conversation to let that chat change files and run commands without approval prompts. It is off for every new conversation. To change it later, open the model/reasoning menu beside the composer; changes apply from the next message. All three agents support this option. With full access off, Antigravity uses its Auto mode and native sandbox. Accounts that cannot use Auto mode may deny a required command; the panel then offers the existing permissions menu. It never enables full access automatically. Antigravity's model list and supported reasoning levels come from agy models; attached images are read with its native file tool.

Review my build and suggest the top 3 improvements.

Check my boss DPS for unrealistic settings.

Can I improve damage by reallocating 5 passive points?

Which gear should I upgrade first, and what stats should I look for?

Compare support gem options for my main skill.

Why am I vulnerable to one-shots, and how can I fix it?

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

One language selection in Settings applies to the panel and PoB window together. Both follow the Windows display language by default; choose System default (or pob ui language system) to follow Windows again. Unsupported system languages fall back to English.

PoB's bitmap fonts only contain ASCII, so PoB AI draws text from a glyph atlas made with Pretendard (and Windows fonts for Thai, Japanese and Chinese) at the exact positions PoB would use. A translation wider than the English is squeezed into its space. 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 on startup and every 30 minutes, and downloads verified updates in the background. When Restart to update appears, apply it whenever you are ready. Your PoB window stays open and reconnects; the AI panel reopens with the new version. Downloading never interrupts a conversation. In Settings → Updates, turn automatic downloads off or check manually. pob update apply --restart also works. Downloads are checked with SHA-256 and kept in your data folder.

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 / Antigravity]
  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);

• on startup and every 30 minutes to check for updates, to download updates when automatic downloads are enabled, or when you request an update or PoB installation;

• 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

This README describes v0.2.5, including expanded official item and modifier translations. Download the release ZIP from GitHub Releases. Compatibility has been checked on Windows 11 with PoB PoE2 0.22.0 and 0.23.1. The current suite has 173 passing tests, covering editor operations, agent sessions, login, permissions and failure diagnostics, item and modifier translation, language selection, shared theme persistence, popup rendering and updates.

Local PoB and WebView2 checks cover all six themes, unchanged calculation results across theme switches, separate AI/settings windows, chat drafts, and compact layouts. Real PoE account import, Windows 10, multiple monitors and Windows display scaling still need manual verification. Antigravity 1.4.7 was also checked against a local response server for its native image/tool protocol, model/effort selection and conversation resumption. The local Google sign-in state and a live Korean response were verified. When Auto mode is unavailable for an account, command execution requires an explicit permission choice; the panel's permission-recovery flow was verified too.

Development

Use a disposable PoB copy and an isolated data folder for engine tests:

$env:POB_PATH = 'D:\Tests\PoB-PoE2'  # a copy of PoB, separate from the one you use
$env:POB_AI_HOME = Join-Path $env:TEMP ('pob-ai-test-' + [guid]::NewGuid().ToString('N'))
npm test
npm run build:panel               # build the native WebView2 window shell
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.