Play World of Warcraft normally. Rambleon quietly remembers the night. When you log out, it hands you a permanent record: a timeline, a factual log, a story page, and a journal chapter written from what actually happened, readable in game and ready to paste anywhere.
It is a memory layer, not a meter: it never automates anything, never reads protected combat data, and keeps your history on your own Mac.
The example is the real, unedited journal of Rambleon Birdsong, Night Elf Hunter, on World of Warcraft: Forever.
Three commands. The last one finds your WoW folder, links the AddOn in, starts the background watcher and opens your empty journal.
brew install uv uv tool install "git+https://github.com/realworldbuilder/rambleon#subdirectory=companion" ramble setup
Then play. In game /ramble opens the panel and /ramble note <text> adds your own words. Logging out is the save. Add --no-ai to ramble setup if you do not want the Claude step.
Not a terminal person? Paste this into Claude Code on your Mac and it walks you through the install, explaining each step and stopping when it needs a decision.
I want to set up **Rambleon** on this Mac. It is a free, open-source "personal memory layer" for World of Warcraft: a small AddOn quietly records my adventure while I play (places, levels, quests, deaths, people I grouped with, my own notes, screenshots at big moments), and a Mac companion turns each evening into a chapter I can read in game and as a web page. Repo and README: https://github.com/realworldbuilder/rambleon. Please read the README first, then do the following, telling me what each step does before you run it, and stopping to ask me if anything needs a decision. 1. Check the ground: this must be macOS with World of Warcraft installed (Rambleon was built on WoW: Forever, the Classic-beta client, and expects the mainline-style 12.x AddOn API). Tell me which WoW folders you find. 2. Install the companion: - `brew install uv` if `uv` is missing (install Homebrew first if that is missing too, and tell me). - `uv tool install "git+https://github.com/realworldbuilder/rambleon#subdirectory=companion"` - `ramble setup` — it finds my WoW folder, links the AddOn into `Interface/AddOns`, installs a background watcher that survives reboots, and opens my empty journal. If it cannot find WoW, ask me for the path and set `RAMBLEON_WOW_DIR`. Run `ramble doctor` afterwards and show me the result. 3. AI-written chapters are optional. If I have Claude Code installed and logged in (`claude`, then `/login`), the companion uses it to write the chapter at the end of the night. If not, tell me I still get the timeline, the factual log, the story page and a prompt file I can paste anywhere, and offer `ramble setup --no-ai`. 4. Explain the in-game side in a few lines: start WoW (or relog so it sees the AddOn), `/ramble` opens the panel, `/ramble note <text>` adds my own words (the best thing I can give the writer), `/ramble mark` remembers a moment and takes a picture, `/ramble chapters` shows past chapters, and logging out is the save. There is no end button. 5. Tell me what Rambleon never does: no DPS meter, no automation, no combat log, nothing leaves my Mac except, when AI is on, the prompt for the chapter. 6. Sharing is manual: `ramble share tonight` puts a chapter on a GitHub Pages site, but only from a git checkout of my own fork with Pages enabled. Leave that for later unless I ask. When you are done, give me a short checklist of what is installed and where, and what to do after my first night (`ramble nights`, `ramble page tonight`).
For hacking on the AddOn or the companion. Everything is editable in place and ramble points at your checkout.
git clone https://github.com/realworldbuilder/rambleon.git cd rambleon scripts/bootstrap ramble setup
scripts/test runs the Lua check, a simulated session and the Python tests, the same as CI.
/ramble note remarks. Nothing else./ramble chapters or share like this site.Free and open (MIT). Your data never leaves the Mac unless you run the optional AI step, and even then only the night's prompt does.