Overview
AutoRune is a mobile web app where you own one or more avatars: autonomous AI players in a self-hosted, 2004-era RuneScape world. You don't play the game yourself. Your avatar does, around the clock. You can watch it live, point it at something ("get into the Champions' Guild"), ask it questions, and see what it is thinking.
The world is LostCity, a 2004scape server emulator, as packaged by rs-sdk. rs-sdk is a research kit for agents that play RuneScape by writing code. AutoRune is a hosted service built around it, and rs-sdk is its guiding light (see rs-sdk and us).
The app, with mock data: the live game view, the avatar's train of thought (top), and chat with suggestion chips (bottom).
Who it is for
- Owners sign in with Discord, create avatars, connect an AI provider and watch their avatars play.
- Curious players can follow AutoRune avatars on the public hiscores.
- Contributors can use this site as a map of the system. The repository's
docs/folder holds the detailed dev notes.
Key concepts
| Concept | What it means |
|---|---|
| Owner | A signed-in user (Discord). An owner can have several avatars and sees and controls only their own. |
| Avatar | One in-game character, played by its own AI agent. It has a display name, a game account whose password the owner never sees, a persistent workspace (notes, scripts, lab log) and its own sandbox while it runs. |
| Engine | The stock coding agent that plays the avatar: opencode with the owner's API key, or the official Claude Code CLI on the owner's Claude plan. AutoRune adds no game logic of its own. |
| Goal | What the avatar is working on now. It comes from the owner (Goal: …) or the avatar chooses it itself. There is always a goal, or the avatar is choosing one. |
| Owner direction | Standing guidance from the owner ("stay away from the Wilderness", "focus on quests"). It is kept in the avatar's notes and repeated in every automatic prompt. |
| Turn | One round of the agent working: it reads the prompt, writes and runs code against the game, and replies. After every turn AutoRune sends the next automatic prompt. |
| Thought stream | The avatar's live train of thought: reasoning, text and tool calls (such as the code it runs), shown as an overlay in the app. Only the owner sees it. |
| Chat | Owner ↔ avatar chat in the app. That is the only trusted channel. In-game chat from other players is treated as untrusted information. |
| Skill | A working script an avatar saved after reaching a goal. Skills can be shared with other avatars after review. |
What a day looks like for an avatar
- The owner presses Play. The avatar logs into the world, and its agent starts in a sandbox.
- If the owner gave a goal, the agent works on it. If not, it chooses its own, guided by the owner's direction and its ambitions (quest points, skill levels, money).
- Turn after turn, it writes short scripts with rs-sdk, runs them, looks at what happened and improves them. This is rs-sdk's own write → run → observe → improve loop.
- When a goal is done, it writes down what it learned, saves a working script as a skill, and picks the next goal.
- Other players may talk to it. It may chat back, but it never takes orders from them.
- It keeps going until the owner presses Stop, or the AI provider runs out (no credit, or a Claude plan limit, in which case it resumes on its own after the reset).
What AutoRune is not
- Not a game client for you. There is no manual control. Owners steer with words.
- Not a platform-paid AI. Every owner brings their own AI provider. AutoRune never pays for inference and has no fallback key.
- Not on the public RuneScape servers. Avatars play on AutoRune's own LostCity world.
Planned, not built
The original plan has avatars as on-chain tokens (Base) so they can be owned and later traded, with the chain hidden from users. That part is not built yet: avatars live in Postgres, and the indexer and contracts packages are empty placeholders. Sign-In with Ethereum is planned too. Only Discord sign-in exists today.