Guide
Every feature, from the command line and from the app.
Each section shows what to write in a .stamp file, how to run it with the free stamp command, and where the same thing lives in the Mac app. The language reference has the exhaustive grammar; the guide is about doing things.
Start
Values and access
- Variables and dimensionsInstead of copying a set of variables per environment, describe the axes your API varies along.
- SecretsWrap anything private in secret(...) . It is masked in output, in reports and in the app, and it belongs in environment.local.stamp , which the app keeps out of git.
- AuthenticationAn @auth line before the first request applies to the whole file. OAuth 2 tokens are fetched once and reused until they expire.
Responses
Testing
- Test plansPlans go before the first request in a file. Settings: matrix , data , parallel , retry , timeout , tags .
- Load testsThresholds decide the exit code, so a slow release fails a pipeline the way a broken test does.
- Race conditionsconcurrently N starts actors together, sync "label" lines them up on the same instant, share passes a value between them, and results holds what every actor got.
Beyond HTTP
Agents and data
- Working with an AI agentTwo independent pieces. The skill teaches an agent the format and the conventions; the MCP server lets it run what it wrote.
- Sample data that holds togetherperson(key) , address(key) and organization(key) return related fields that stay the same for a key, in any request, against any API.
Day to day
- Bringing collections inEnvironments become values of a dimension, anything that looks like a token goes to environment.local.stamp , and whatever could not be translated is left as a #…
- Running in CIUseful flags anywhere: --quiet for failures only, --no-color for plain output, -d name=value for a dimension, -v name=value for a variable.
- ReportsEvery report comes from the same run, so the numbers in them agree.
- The app, in shortcutsWhat the app does without the mouse, in the order you reach for it.