Repository navigation
PoB Agent Edition v0.8.0
Public beta. Please report problems.
One release for four pieces of work: the optimiser (Stage 4), the AI chat inside PoB (Stage 10), much smaller downloads and updates (Stage 17), and Guide tab fixes. Based on Path of Building Community v2.67.2 (same as 0.7.0), with the 3.30 passive tree and unique previews.
Optimiser (Stage 4)
Added
- Optimiser (Stage 4): ask "I'm weak at single target" or "I keep dying" and the AI's new
optimisetool picks a goal (single target / bossing, clear, tankiness, balanced, or "fix weakest" from the build's diagnosis), sets the config that goal needs for the run only (put back afterwards) and simulates every lever in PoB: passives within N points with their path, respecs (net gain per Orb of Regret), mastery effects, support gem swaps, gem levels and quality, auras, heralds and curses, utility flasks, anoints, pantheon and bandit. Results are ranked by gain per cost, each with before/after numbers, the mechanic that makes it work (explained at your explanation level, with its source) and side effects ("costs 4% EHP"). It also lists config you may be under-counting, auras that would help but don't fit your mana, and a scaling report: what one more step of each stat (10% more damage, +100 life, +1% max resistance, ...) is worth for your build. With a budget it adds instant-buyout gear fromplan_upgrades; Hardcore never trades defence away for damage. - AI Advisor tabs on the Overview: Items (gear from
plan_upgrades), Passives, Gems and Other (from the optimiser). Hover a row for its numbers and cost, click to open the tab where the change is made.
AI chat inside PoB (Stage 10)
Added
- AI chat inside PoB (Stage 10): a chat panel docked on the right of the build screen (hide it with
>, the AI Chat tab on the right edge opens it again). Ask "why am I weak at bosses?" and the answer streams in from Claude Code or Codex with your own login, or from the Anthropic API with your own key. The AI works on the build in the window with the same PoB tools and rules as your AI apps, and gets the open build, your profile (play mode, league, currency, explanation mode) and your guide stage automatically. - In chat answers, passives, items and gems are links: hover for the tooltip, click to find them (tree search, Items list, Skills group). Suggested changes come as cards with Preview (PoB simulates it and shows before/after, nothing changes) and Apply (changes the build in the window; it is never saved over your file).
- AI may edit toggle in the panel (off by default): off, the AI can only read and simulate, and changes come as Preview/Apply cards; on, it may change the build in the window when you ask. Quick prompts ("Why am I dying?", "Next upgrade", "Weak at bosses?"), Stop, New chat, and one conversation per build that continues where you left off.
- AI chat model per backend in Options. The default is the balanced, mid-priced model, never the most expensive one: Claude Code Sonnet (Haiku cheaper, Opus strongest), Codex GPT-6.1-Sol at low reasoning effort (GPT-6-Luna cheaper, GPT-6-Astra strongest), API Sonnet 5.5 (Haiku 5.5 cheaper, Opus 5.5 strongest). The panel shows the model in use.
- Options > AI chat backend with a Sign in button (opens the CLI's own sign-in window:
claude auth login/codex login) and an optional Anthropic API key field. The key stays inAgentEdition.jsonon this PC, is never shown again, and is only sent to api.anthropic.com. Claude Code and Codex are found on PATH, in their usual install folders or inside the Claude / Codex desktop apps.
Security
- The chat never touches the game client and trade stays instant-buyout only. The CLIs run with their built-in command, file and web tools switched off, only the pob tools (edit tools only when you allow them), in their read-only sandbox, outside any project folder, and pinned to this PoB window. No POESESSID, API key or build file path is passed to a backend; Cancel ends the backend and everything it started.
- New dependency: Anthropic's official TypeScript SDK (
@anthropic-ai/sdk1.3.0) for the optional API-key backend.
Lighter: smaller downloads and updates, less CPU and memory (Stage 17)
Added
- Smaller downloads (Stage 17): the zips are about 247 MB (installer, was 632 MB) and 280 MB (portable, was 665 MB). Ruthless, "alternate" and older passive trees (about 514 MB unpacked) are no longer in the zip: when you open a build that uses one, PoB asks and downloads just that tree (3-25 MB) from GitHub, checks every file, and keeps it for next time. The AI's tools download it on their own. Offline, PoB says which tree is missing and how big it is instead of failing.
- Small updates (Stage 17): from this release on, Update now downloads only the files that changed (a few MB when only our code changed; a test update was 0.3 MB instead of 247 MB). The first small update is the one after 0.8.0; updating to 0.8.0 still downloads the full (now much smaller) zip. Every file is checked against the release's manifest; if anything doesn't match, the updater falls back to the full zip on its own. Passive trees you downloaded are kept across updates and rollbacks.
tools\update.ps1 -Fullforces the full zip. tools\measure.ps1: download sizes, disk use per folder, RAM and CPU of the PoB window, the AI server and the headless engine, and the size of caches and backups, with a before/after comparison.
Changed
- Less CPU and memory in the background (Stage 17): PoB in the background now runs at about 3 frames a second when nothing happens (10 while the AI is working, 1 when minimised, full speed when focused or under the mouse) and tidies up its memory once it goes quiet. Measured with a build loaded: unfocused 5.9% -> 2.6% of a CPU core, minimised 0.6-2%.
- The AI server shuts its background PoB engine down after 5 idle minutes (frees about 315 MB each) and brings the build back exactly as it was, unsaved changes included, on the next question.
POB_AGENT_IDLE_MINUTESchanges the wait (0 = never). - The AI server keeps its caches within limits: web pages for facts 50 MB / 60 days, snapshots 100 files / 90 days, item icons 50 MB, the answers log 2 MB. Character history keeps its existing limits (200 entries, 30 build copies per character).
Fixed
- Minimised PoB used a full CPU core and kept growing until it crashed (0.6.x, with a build loaded): it now idles at 1 frame a second when minimised, and its memory stays flat.
- The release
.sha256files end in LF, sosha256sum -cworks on Linux and macOS too.
Guide mode fixes (follow-up to Stage 3)
Added
- Hide panel button in the Guide tab: hides the guide panel on the left so the tree uses the whole width; Show panel brings it and the Analyse results back. The choice is remembered.
Fixed
- Guide tab crash (0.6.1): opening the Guide tab with a guide imported stopped PoB with "attempt to index global 'build'" when no AI app had talked to the window yet. The tab and the Sync character button now always work on their own build.
- The Guide tab now saves your stage choice, kept differences and the Overview card on a fresh install too (it could not create its
AgentCachefolder there).
Download (much smaller now):
PoB-Agent-Edition-0.8.0-win64.zip(252 MB): extract, double-clickInstall.cmd(needs Node.js 20+, which it offers to install).PoB-Agent-Edition-0.8.0-win64-portable.zip(286 MB): unzip and play withStart PoB Agent Edition.cmd, no Node.js needed;Connect AI apps.cmdconnects your AI app.
Older and Ruthless passive trees download the first time a build needs them (a few MB each, from GitHub).
Already installed? Click Update now on the Overview banner, or run tools\update.ps1. Updating to 0.8.0 downloads the full zip once; from 0.8.0 on, updates download only the changed files. After updating, run Install.cmd (or Connect AI apps.cmd) again and restart your AI app.
SHA256:
PoB-Agent-Edition-0.8.0-win64.zip:16459f406f87fdb3b7474ed84d0f19d3b1d8e794792afd5acc45327648854f6fPoB-Agent-Edition-0.8.0-win64-portable.zip:f1cd0d96c37d78f723b45308f014df80be3d6bd48bbeb54879c334b10a0084e2