IDEL RPG

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