The CodeHub Handbook

A friendly guide to CodeHub — what it is, how to browse it, how to use the API, and how to compare versions. This page is open. No password needed.

1. What is CodeHub?

CodeHub is a website that stores code projects — every version, with screenshots and notes. Think of it like a museum where every project you ever made is preserved, with a card explaining what changed between versions.

What's in each project?

• Project metadata — name, icon, category, tags, description, tech stack, when it was created, who maintains it
• Versions — every release (v1.0, v1.1, …) with date, screenshots, code changes
• Raw code — open it directly in your browser or download
• AI-readable notes — for each version: what you asked, what AI did, what changed
• Live URL — link to the deployed version

Two ways to use it

2. Browsing projects

The homepage lists every project. Click any card to dive in.

Opening a project's code

Each version has its own code/ folder. Open any file directly in browser:

https://codehub.sj88ai.com/api/project/{slug}/{version}/code/{filename}

List what files exist:

https://codehub.sj88ai.com/api/project/{slug}/{version}/code/

3. Searching across everything

The search engine is real SQLite FTS5 — looks through titles, AI commands, AI responses, change lists, and code.

curl 'https://codehub.sj88ai.com/api/search?q=heatmap' | python3 -m json.tool

Tips

• One word works fine, but multi-word is better — ?q=heatmap filter matches both terms
• Search returns highlighted snippets with <mark> tags
• Search is scoped to ?slug= and ?version= if you want to narrow down
• There's also a search box on the navbar

4. Comparing versions (V1 / V2 / V3)

Some projects have multiple side-by-side live URLs so you can compare how a project evolved. Look at the example: AI Data Analyzer.

How to compare 3 versions

1. Open all three URLs in three browser tabs
2. Alt-Tab between them to see the evolution
3. Or — use the in-page Timeline view (/project/{slug}/timeline/) which shows them stacked vertically

5. Read-only API (no token needed)

Everything below is free to call. Use it for scripts, integrations, or to query codehub from your own tools.

Project endpoints

All return JSON. All are paginated where it makes sense. /docs has interactive Swagger UI.

# 1) List projects
curl https://codehub.sj88ai.com/api/projects | python3 -m json.tool | head -30

# 2) Get a specific project (with all versions)
curl https://codehub.sj88ai.com/api/project/ai-data-analyzer | python3 -m json.tool | head -30

# 3) Read a file from a version
curl -sL https://codehub.sj88ai.com/api/project/ai-data-analyzer/v1.2/code/index.html | head -10

6. Talking via MCP (Model Context Protocol)

If you're an AI agent, the cleanest way to use CodeHub is through MCP — a JSON-RPC 2.0 endpoint at /api/mcp.

13 tools available

Example conversation with any MCP-aware AI

# 1. Initialize
curl -s -X POST https://codehub.sj88ai.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"you","version":"1.0"}}}'

# 2. List available tools
curl -s -X POST https://codehub.sj88ai.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

# 3. Call a tool
curl -s -X POST https://codehub.sj88ai.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_projects","arguments":{}}}'

For protocol details, see modelcontextprotocol.io.

7. Useful pages

8. For admins (uploads)

If you already have the admin token

Send it as a header:

X-Admin-Token: YOUR_TOKEN_HERE

Or login to get a 7-day session cookie:

# Login (saves cookie to /tmp/cookies)
curl -c /tmp/cookies -X POST "https://codehub.sj88ai.com/api/login?password=YOUR_TOKEN"

# Upload a new version (multipart form)
curl -b /tmp/cookies -X POST https://codehub.sj88ai.com/api/admin/upload \
  -F "slug=my-project" \
  -F "version=v1.0" \
  -F "title=My Project v1.0" \
  -F "user_cmd=What I asked" \
  -F "ai_response=What AI did" \
  -F 'what_changed=["Change 1","Change 2"]' \
  -F 'code_files_json={"index.html":"<h1>Hello</h1>"}' \
  -F "live_url=https://my.example.com/"

Other admin endpoints

🎯 TL;DR

• Browse the website — no token needed
• Call /api/* endpoints — no token needed
• Talk via MCP at /api/mcp — no token needed
• Compare V1/V2/V3 of any deployed project — no token needed
• To upload / edit / delete: ask the platform owner for the admin token

Open guide · No password · No tracking · Just code ✿