sorcgcs-server 0.1.0

Local development server for SorcGCS — game preview, file management, and AI agent support

sorcgcs-server

Local development server for SorcGCS (Sorceress) — game preview, file management, and AI code agent support.

Quick Start

# Using uv (fastest)
uvx sorcgcs-server

# Using pipx
pipx run sorcgcs-server

# Or install and run
pip install sorcgcs-server
sorcgcs-server

Options

sorcgcs-server --port 8080    # Custom port (default: 8080)
sorcgcs-server --dir ./games  # Serve a specific directory
sorcgcs-server --version      # Show version

What It Does

This is a lightweight local HTTP server (Python stdlib only, no dependencies) that provides:

• Game Preview — Serve HTML5 games with live reload support
• File API — Read, write, list, search, and manage project files
• FFmpeg Integration — Audio/video format conversion (if ffmpeg is installed)
• AI Agent Support — Endpoints for the SorcGCS AI code agent
• Checkpoint System — Create and restore file snapshots

API Endpoints

Method	Path	Description
GET	/api/status	Server status and config
GET	/api/games	List available games
GET	/preview/*	Serve game preview files
GET	/games/*	Serve game files
POST	/api/read-file	Read a file
POST	/api/write-file	Write a file
POST	/api/list-dir	List directory contents
POST	/api/search-files	Search files by glob pattern
POST	/api/run-command	Execute a shell command
POST	/api/create-dir	Create a directory
POST	/api/delete-file	Delete a file
POST	/api/rename-file	Rename/move a file
POST	/api/ffmpeg-process	Process media with FFmpeg

Requirements

• Python 3.8+
• No additional dependencies (uses Python standard library only)
• FFmpeg (optional, for media processing)

License

MIT