Skip to content

README.md

Latest commit

 

History

History
76 lines (51 loc) · 1.38 KB

README.md

File metadata and controls

76 lines (51 loc) · 1.38 KB

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:

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

npm install
npm run dev

Health check:

curl http://127.0.0.1:38474/

Widget preview:

http://127.0.0.1:38474/widget

Verify

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:

cloudflared tunnel --config cloudflared.example.yml run tiny-roll

Then create a ChatGPT connector using:

https://tiny-roll.apps.ramonsandoval.com/mcp

Do not use production credentials or real user data until the connector has been tested and approved.