パブリック API

リアルタイムプログレッションフィード。

⌄

GET /api/status

curl https://shawnos.ai/api/status

クイックスタート

cURL

bash

curl https://shawnos.ai/api/status

JavaScript (fetch)

javascript

fetch('https://shawnos.ai/api/status')
  .then(res => res.json())
  .then(data => {
    console.log(`Level ${data.level}: ${data.title}`)
    console.log(`XP: ${data.xp_total} / ${data.xp_next_level}`)
  })

Python

python

import requests

response = requests.get('https://shawnos.ai/api/status')
data = response.json()

print(f"Level {data['level']}: {data['title']}")
print(f"XP: {data['xp_total']} / {data['xp_next_level']}")

レスポンススキーマ

json

{
  "name": "Operator",
  "title": "Prompt Apprentice",
  "level": 9,
  "xp_total": 1882,
  "xp_next_level": 2000,
  "class": "Polymath",
  "avatar_tier": 1,
  "milestones": [
    {
      "id": "first_100xp",
      "title": "Spark Plug",
      "description": "Earned 100 XP",
      "unlocked_at": "2026-02-15T05:51:44Z"
    }
  ],
  "updated_at": "2026-02-15T05:51:44Z",
  "meta": {
    "api_version": "1.0",
    "docs": "https://shawnos.ai/api"
  }
}

namestring

Character display name

titlestring

Current RPG title (e.g., 'Terminal Initiate', 'Repo Architect')

levelnumber

Current level (1-based)

xp_totalnumber

Total accumulated XP

xp_next_levelnumber

XP required to reach the next level

classstring

Primary RPG class: Builder, Scribe, Strategist, Alchemist, or Polymath

avatar_tiernumber

Avatar visual tier (1-6)

milestonesarray

List of unlocked milestone achievements

updated_atstring

ISO-8601 timestamp of last profile update

metaobject

API metadata including version and documentation URL

ユースケース

📊

ライブ統計を埋め込む

ポートフォリオにリアルタイムのXPとレベルを表示

🤖

Discord Bot

プログレッションを追跡するBotを構築

🐦

Twitter自動化

マイルストーン達成時に自動ツイート

🔬

アーキテクチャを学ぶ

リアルタイムRPGシステムの構築方法を調査

このシステムの仕組み

The RPG system tracks daily output across multiple dimensions: commits, content, GTM deliverables, and more. Each activity type contributes to XP based on weighted scoring.

Data flows from gitignored Python scripts → public JSON → API endpoint. The progression engine scans my work, calculates XP, checks for level-ups, and unlocks milestones based on cumulative stats.

The API endpoint reads from data/progression/profile.json (a public file) and serves it with CORS headers and CDN caching.

Type definitions are available in the rpg.ts file. The core scoring algorithms remain proprietary.

自分で作る

Want to build a similar system? Here's the architecture:

1. データパイプライン

作業ソースをスキャンしてスコアを計算

2. 永続化レイヤー

統計をパブリックJSONファイルに書き込み

3. APIエンドポイント

CORSとキャッシュ付きでパブリックAPIとして公開

4. フロントエンド表示

データをレンダリングするUIコンポーネントを構築

ツールスタック

▸Frontend: Next.js, React, Tailwind CSS
▸Backend: Python (progression engine), TypeScript (API routes)
▸Deployment: Vercel (auto-deploy from GitHub)
▸Development: Cursor IDE, Claude Code, MCP servers
▸Monorepo: Turborepo with shared packages

I built this using Claude Code and Cursor IDE. The full repo is on GitHub.

ShawnOSについて

This API is part of ShawnOS — an AI-powered operating system for GTM engineering and content operations.

Built with MCP servers connecting Cursor IDE, Claude Code, and 15+ automation tools, the system gamifies vibe coding and live building in public.

Every commit, post, and deliverable feeds the progression engine. The RPG system provides real-time feedback and unlocks visual rewards as the work compounds.