- Tabs: Items, Quests, Talents, Abilities, Professions, All - Items: equipped, bags and bank with useful tooltip lines, related quests and done state, vendor/AH prices - Quests: objective locations and turn-in NPCs from pfQuest, quest starters, hearthstone, flight paths, reputation - Abilities: merged class/pet trainer offers; Professions: have counts, trainer offers, recipe items, reagent prices - Bank rescans debounced; flight paths recorded from the flight master map - octo_query.py: item notes for bag/bank items, hearthstone and flight paths Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019rnyWdDpVXzjck3u1JFchU
OctoAI
Ask an AI about your own OctoWoW character. Type /octoai, press Copy, paste into any AI chat, ask your question.
For OctoWoW (Turtle WoW 1.18.1 content on the 1.12 client). The one-click Copy button needs ClassicAPI.dll; everything else works on a plain 1.12 client.
Install
Launcher: if your launcher lists OctoAI, install it there.
Manual: download the repository as a zip, extract it into Interface\AddOns\ and rename the extracted folder (for example OctoAI-main or octoai) to exactly OctoAI. You should end up with:
Interface\AddOns\OctoAI\OctoAI.toc
Restart the game completely (a new addon is not loaded by /reload) and make sure OctoAI is ticked in the AddOns list on the character screen.
Use
Type /octoai and pick the tab that matches your question:
| Tab | Ask about | Contains |
|---|---|---|
| Items | upgrades, what to sell or throw away, what is in the bank | equipped gear, bags and bank: gear with full stats, other items with their useful tooltip lines (starts a quest, Quest Item, Use:, flavor text), which quests use each item and whether you already did them, vendor and auction prices |
| Quests | where to go, how to do a quest, fastest route | quest log with objectives and text, mob/object/item locations and turn-in NPCs, items in your bags that start a quest, hearthstone, known flight paths, reputation |
| Talents | talent builds | full talent trees with every talent's effect and your points |
| Abilities | spells, rotation, what to train next, pet | every spell and ability with its tooltip, pet and Beast Training, what class and pet trainers still offer you |
| Professions | leveling a profession, materials | recipes with reagents and how many you have, what profession trainers still offer, recipes in your bags, reagent auction prices |
| All | anything else | all of the above plus buffs |
Every tab starts with the same character block: level, class, location, money, XP, talent points, stats, weapon skills, profession levels and pet.
You can also type the tab name: /octoai items, /octoai quests, /octoai talents, /octoai abilities, /octoai professions, /octoai all.
Copy puts the text on the clipboard (needs ClassicAPI.dll; otherwise it is greyed out, use Select all and Ctrl+C). Paste it into the AI chat and write your question after My question:.
Example questions:
- "Which items in my bags and bank can I sell or delete?"
- "Is the gear in my bags better than what I wear?"
- "Where do I go for the quests in my log, in what order?"
- "How should I spend my next talent points?"
The text starts with a short note telling the AI that this is OctoWoW, not retail or Classic, and to look things up on https://octowow.st/db/ by the IDs given. AIs still make mistakes about private server content, so double check anything important in game.
Optional addons that add more detail
OctoAI works on its own. If these are installed it reads their data too (nothing else is needed):
- pfQuest (with pfQuest-turtle): where quest mobs, objects and items are, where to turn quests in, which quests use the items you carry, and which of those quests you already completed.
- aux: recent auction house prices (scan the auction house now and then to keep them fresh).
- SellValue (or aux): vendor sell prices.
Some data only appears after you open a window once
- Bank: open the bank.
- Profession recipes: open the profession window.
- Trainer offers and costs: open the trainer window.
- Flight paths: open a flight master's map (once per continent).
Item tooltip cache
Every item you hover in game (auction house, vendors, chat links, loot rolls, bags, quest rewards, trade window) is remembered with its full tooltip, account wide (newest 4000 items). An AI that can read your WoW folder can then answer "is this worth buying?" with the exact stats, without you typing them. Stored in WTF\Account\<account>\SavedVariables\OctoAI.lua on logout or /reload.
Full snapshot
/octo writes a complete JSON snapshot (everything above plus spells, buffs, reputation, full talent trees and tooltips). It is also saved automatically when things change, out of combat.
- With VanillaHelpers.dll:
<WoW>\VanillaHelpersData\octo_<Name>.json - Otherwise:
WTF\Account\<account>\<realm>\<character>\SavedVariables\OctoAI.lua(written on logout or /reload)
Other commands: /octo auto on|off, /octo verbose, /octo status.
AI tools (optional, advanced)
tools/ is not used by the game. It is for people whose AI assistant can read their WoW folder (for example the Claude desktop app with the WoW folder connected):
-
tools/octo_query.py: command line lookup (Python 3.8+, standard library only) for quests, NPCs, items, zones and your snapshots, plusseen <item>for tooltips from the item cache. Runpython tools/octo_query.py -h. -
tools/skill/SKILL.md: instructions for the AI on how to use the tool and which rules to follow. Add it as a skill (or paste it into a project's instructions). -
tools/data/: the quest database from OctoQuestDatabase (MIT, attribution indata/NOTICE.mdafter download). It is not stored in this repository; download it once with:python tools/update_data.py # latest version python tools/update_data.py --check # compare installed and latestRun the same command again later to update. Character snapshot commands work without the database.
Privacy
Nothing leaves your computer unless you paste it somewhere yourself. The addon has no network access. The text contains your character name, realm, location and gold.
中文说明
让 AI 根据你自己角色的真实数据回答 OctoWoW 的问题。
-
安装:启动器里有就直接装;手动安装就把压缩包解压到
Interface\AddOns\,文件夹名改成OctoAI(不是OctoAI-main或octoai),然后完全重启游戏。 -
游戏里输入
/octoai,按你要问的问题点上面的按钮:- Items:换装备、什么能卖能扔、银行里有什么(身上、背包、银行所有物品,任务用途,商店价和拍卖价)
- Quests:任务去哪做、怎么走(任务日志、怪和物品的位置、交任务的 NPC、炉石、已开的飞行点、声望)
- Talents:天赋怎么点
- Abilities:技能、该学什么、宠物
- Professions:冲专业、缺什么材料
- All:全部
天赋树效果、技能说明、专业配方都直接从游戏里读取,包含 Turtle/Octo 的改动。装了 pfQuest 会多出任务地点,装了 aux 会多出拍卖价,不装也能用。
-
点 Copy(需要 ClassicAPI.dll;没有的话按钮是灰的,点 Select all 再按 Ctrl+C)。
-
粘贴到任何 AI 聊天里,在最后的
My question:后面写问题,可以用中文问。
银行、专业配方、训练师列表、飞行点要先在游戏里打开对应窗口一次才会记录。你在游戏里鼠标指过的物品(拍卖行、商人、聊天链接、掉落等)会自动记下完整属性,方便 AI 判断值不值得买。tools 文件夹是给能直接读取 WoW 目录的 AI(比如连接了文件夹的 Claude 桌面版)用的,普通玩家不需要。要用的话先运行一次 python tools/update_data.py 下载任务数据库(以后再运行一次就是更新)。
License
MIT, see LICENSE. The quest database downloaded into tools/data/ comes from OctoQuestDatabase and keeps its own license and notices.