Metadata-Version: 2.4
Name: sorcgcs-server
Version: 0.2.0
Summary: Local development server for SorcGCS — game preview, file management, and AI agent support
Project-URL: Homepage, https://sorceress.app
Project-URL: Repository, https://github.com/SorcGCS/sorcgcs-server
Author: SorcGCS
License-Expression: MIT
License-File: LICENSE
Keywords: game-preview,gamedev,local-server,sorcgcs
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# sorcgcs-server

Local development server for [SorcGCS (Sorceress)](https://sorceress.app) — game preview, file management, and AI code agent support.

## Quick Start

```bash
# 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
