See the API endpoints your app actually calls, live, without leaving your editor.
Features
Finds what you run. Start your backend and frontend in a VS Code terminal as usual
(python manage.py runserver, uvicorn main:app, npm run dev, …). Scope links each
listening port to its terminal and folder, and groups a frontend with the backends its
.env / proxy config calls into one project. Services nothing calls are listed under
"Also running". Without terminal shell integration it falls back to a listening-port scan.
Called endpoints (default). Each request in a backend's own access log becomes a row:
call count, last status and latency, and who called it (web app, an AI agent's terminal, or you).
Watching costs no Scope requests.
All endpoints (opt-in). "Fetch all endpoints" reads the OpenAPI schema once and runs nothing.
Run on demand. Pick a group (not called yet, failing, all safe GETs) and a maximum. The panel
shows how much of your hourly ShappeScope limit it will use. POST/PUT/PATCH/DELETE never run in bulk.
Endpoint detail. Response, Request and Headers tabs; full paths and JSON wrap. Set a Bearer
token once per backend (from a .env key, pasted, or none). Copy as curl, Open trace, Go to handler.
Rate-limit aware. Uploads are paced; on a 429 the panel and status bar say "limit reached" and
uploads resume after Retry-After. Nothing runs on save.
Getting started
Open ShappeScope from the activity bar and Sign in to your Shappe account (browser sign-in, no password in the editor). One Shappe sign-in covers ShappeScope and ShappeTrack, and it shows up in the editor's Accounts menu (provided by the Shappe Account extension, installed automatically).
Start your services in a VS Code terminal. They appear within seconds.
Use your app — endpoints show up as they are called.
Commands
ShappeScope: Sign In to Shappe, Sign In with a Token, Sign Out of Shappe, Add Backend by URL, Rescan Running Services, Open Web App.
Settings
shappe.scope.batchIngestEndpoint — optional batch ingest URL (for a future backend endpoint).
Empty (default) uploads one request at a time.
Requirements
A ShappeScope account (scope.shappe.ai). Live call capture needs a terminal with shell integration
(VS Code 1.93+); other editors use the port-scan fallback and "Fetch all endpoints".
