IDEL RPG

IDEL RPG is a local-first RPG layer for agent-assisted software development. This repository starts with the CLI prototype: create a quest, validate real work, claim XP, and grow a tiny engineering guild.

Quick Start

pnpm install
pnpm build
pnpm idelrpg init
pnpm idelrpg quest create --title "First Green" --type bug_hunt --done "Validation passes" --validation "echo ok"
pnpm idelrpg quest start <quest-id>
pnpm idelrpg validate
pnpm idelrpg claim
pnpm idelrpg profile

State is stored locally in .ide-rpg/ide-rpg.sqlite.

MCP Server

Build the workspace, then run the stdio MCP server from any repo you want IDEL RPG to track:

pnpm build
pnpm idelrpg:mcp

For Codex or another MCP client, configure a stdio server with:

{
  "mcpServers": {
    "idelrpg": {
      "command": "node",
      "args": [
        "/Users/jared/Documents/Codex/2026-05-20/can-you-see-my-conversation-here/packages/mcp-server/dist/index.js"
      ]
    }
  }
}

Available tools:

• initialize

• create_quest

• list_quests

• start_quest

• get_current_quest

• submit_validation_result

• claim_reward

• show_profile

Available resources:

• idelrpg://profile

• idelrpg://quests/current

• idelrpg://quests