Posteçî

HTTP requests as plain text files you can read, review and run anywhere.

Posteçî keeps requests in .stamp files. Variables follow as many dimensions as your system has (environment, region, tenant, user), responses are checked with small scripts, and the same files run test plans, load tests and race condition tests. Open a folder of them in the Posteçî Mac app, or run them in a terminal and in CI with the free posteci command.

### Log in
POST {{baseUrl}}/login
Content-Type: application/json

{ "username": "{{username}}", "password": "{{password}}" }

> assert status == 200
> set token = body.token

### My orders
@needs logIn
@auth bearer {{token}}
GET {{baseUrl}}/orders?limit=20

> assert all(body.items, order => order.total > 0)

This repository holds everything around the format that is open: the language reference, example workspaces, an AI skill for writing .stamp files, and editor support. The Mac app and the engine behind posteci are not part of it.

What's here

docs/stamp.md	The Stamp language reference
Examples/	A workspace that talks to public test APIs: requests, dimensions, plans, load tests, WebSockets, GraphQL, WebRTC, MCP servers, sample data
plugins/posteci	A skill that teaches AI agents to write and check .stamp files
editors/vscode	Syntax highlighting for Visual Studio Code

The command-line tool

posteci runs requests, test plans and load tests from a workspace. It is free to use, including in commercial projects and CI.

brew install samalstudios/tap/posteci

Or download a binary from Releases: a universal build for macOS, and fully static builds for Linux on x86_64 and arm64 that need nothing else installed.

posteci run api/orders.stamp environment=qa region=eu
posteci test . --tags smoke --junit reports/junit.xml
posteci load . --json reports/load.json
posteci check .
posteci import openapi.yaml -o api

posteci help lists everything. It exits with 1 when a check fails and 2 when a file has errors, so pipelines fail when they should.

In GitHub Actions:

- name: API tests
  run: |
    curl -sL https://github.com/samalstudios/posteci/releases/latest/download/posteci-linux-x86_64.tar.gz | tar xz
    ./posteci test api --junit reports/junit.xml

The AI skill

The stamp-files skill teaches an agent the format, the conventions (no secrets in shared files, dimensions instead of copied environments) and to check its work with posteci check.

In Claude Code:

/plugin marketplace add samalstudios/posteci
/plugin install posteci@posteci

Other agents that read the Agent Skills format can use plugins/posteci/skills/stamp-files/SKILL.md directly.

Try the examples

git clone https://github.com/samalstudios/posteci.git
cd "posteci/Examples/Public APIs"
posteci run Blog/Posts.stamp
posteci test Plans.stamp

License

The contents of this repository are available under the MIT license. The posteci binaries are free to use under their own terms. The Posteçî name and icon belong to Samal Studios.

Found a mistake in the docs, or have an idea for the format? Open an issue.