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

בנה בוט שעוקב אחרי התקדמות

🐦

אוטומציית 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 Endpoint

חשוף דרך API ציבורי עם CORS וקאשינג

4. תצוגת Frontend

בנה רכיבי 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.