API pública

Feed de progresión en tiempo real.

⌄

GET /api/status

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

Inicio rápido

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']}")

Schema de respuesta

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

Casos de uso

📊

Insertar estadísticas en vivo

Muestra XP y nivel en tiempo real en tu portafolio

🤖

Bot de Discord

Construye un bot que rastree la progresión

🐦

Automatización de Twitter

Tuitea automáticamente cuando se alcanzan hitos

🔬

Estudiar la arquitectura

Examina cómo se construye un sistema RPG en tiempo real

Cómo funciona este sistema

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.

Construye el tuyo

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

1. Pipeline de datos

Escanea tus fuentes de trabajo y calcula puntajes

2. Capa de persistencia

Escribe estadísticas a un archivo JSON público

3. Endpoint API

Expón vía una API pública con CORS y caché

4. Display del frontend

Construye componentes UI que rendericen los datos

Stack de herramientas

▸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.

Sobre 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.