CF Ready Web Agent
Browser UI at ready.orangecloud.vn/app. No local Node install required — scans run in a Cloudflare Sandbox container.
Layout
| Panel | Purpose |
|---|---|
| Project | Upload ZIP, import GitHub, repo picker (OAuth) |
| Workspace | Chat (natural language → commands) + CLI terminal |
| Results | Score rings, blockers, filterable findings |
Import source
ZIP upload
- Max 50MB
- Exclude
node_modules— upload source only - Drag-and-drop or file picker
GitHub
- Public URL — paste
https://github.com/owner/repoand Import - Private repos — Connect GitHub (OAuth), then My repos → Import per repo
Private import requires Worker secrets:
GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET, GITHUB_REDIRECT_URI. See repository DEPLOY.md.
Running commands
CLI tab — type commands directly:
scan
inspect
security-scan
ai-ready
seo-ready
deploy-check
migration-plan
ai-optimizeChat tab — examples:
- “scan project” → runs
scan - “kiểm tra bảo mật” →
security-scan
Session API
For integrations, the worker exposes REST endpoints:
| Endpoint | Method | Description |
|---|---|---|
/api/sessions | POST | Create session |
/api/sessions/:id/upload | POST | Multipart ZIP |
/api/sessions/:id/import/github | POST | { "repoUrl": "…" } |
/api/sessions/:id/exec | POST | { "line": "scan" } |
/api/sessions/:id/chat | POST | Natural language |
/api/sessions/:id/results | GET | Last scan JSON |
/api/health | GET | Worker health |
Limitations
- Ephemeral sessions — no persistent scan history yet (see Roadmap)
- Sandbox cold start may add latency on first command
- Same read-only safety model as CLI