https://github.com/ramsani/tiny-roll
https://github.com/ramsani/tiny-roll
Last synced: 22 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/ramsani/tiny-roll
- Owner: ramsani
- Created: 2026-05-17T19:44:05.000Z (about 1 month ago)
- Default Branch: master
- Last Pushed: 2026-05-18T16:06:30.000Z (about 1 month ago)
- Last Synced: 2026-05-18T18:12:09.400Z (about 1 month ago)
- Language: TypeScript
- Size: 56.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Tiny Roll
Local-first ChatGPT Apps SDK project generated by Nova Build ChatGPT App.
Deployment Intent: PRIVATE_SELF_USE
## What It Does
This app exposes a local MCP server at:
```txt
http://127.0.0.1:38474/mcp
```
It includes a widget resource and sample tools that should be replaced with the real app workflow.
## Local Run
```bash
npm install
npm run dev
```
Health check:
```bash
curl http://127.0.0.1:38474/
```
Widget preview:
```txt
http://127.0.0.1:38474/widget
```
## Verify
```bash
npm run verify
```
The verification command runs typecheck, build, tests, smoke checks, and the quality gate.
## Process Control
Before changing the app, update:
- DEPLOYMENT_INTENT.md
- QUALITY_PLAN.md
- SDK_CONFORMANCE.md
- PROCESS_EVIDENCE.md
- app-value.md
- quality-contract.md
- sdk-fit.md
- tool-contracts.md
- risk-matrix.md
- failure-model.md
- verification-report.md
The app is not ready until those files show what was planned, what was built, what passed, and what still needs Ramon approval.
## ChatGPT Connector
For local testing through a public HTTPS URL, expose the MCP endpoint with Cloudflare Tunnel:
```bash
cloudflared tunnel --config cloudflared.example.yml run tiny-roll
```
Then create a ChatGPT connector using:
```txt
https://tiny-roll.apps.ramonsandoval.com/mcp
```
Do not use production credentials or real user data until the connector has been tested and approved.