The API client that keeps its requests in your repo.

Satchel is a small, fast desktop app for sending HTTP requests while you build, with collections, environments and scripts kept as plain files you commit next to your code.

Download for macOSDownload for WindowsDownload for LinuxDownload Source on GitHub

Version 1.0.1
macOS, Windows, Linux
Free and open source (MIT)
No account, no Electron

Resolves to http://localhost:8080/v2/products

Satchel

main2

GETList products

QUERYSearch products

GETGet product

→http://localhost:8080/v2/products

QUERYSafe and idempotent like GET, but the query goes in the body, so it can be cached and retried. Servers list what they accept in Accept-Query.

1
2
3
4
5
6
7
8
9
10
11

{ "q": "satchel", "filter": { "inStock": true, "tags": [ "bags" ] }, "sort": "-price", "limit": 20 }

200 OK48 ms516 B

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

{ "data": [ { "id": "prd_8Hx2", "name": "Canvas Satchel", "price": { "amount": 18990, "currency": "BRL" }, "stock": 12, "active": true, "tags": [ "bags", "canvas" ] } ], "meta": { "total": 1, "query": "satchel", "took_ms": 4 } }

Sample data: a made-up shop API. The window is live HTML from Satchel’s interface, not a screenshot.

Bring the requests you already have.

Paste a cURL
Copy as cURL from the browser’s devtools, then ⌘V anywhere in Satchel. Paste into a URL field and it replaces that request in place.
curl 'http://localhost:8080/v2/carts?expand=items' -X POST -H 'Content-Type: application/json' --data-raw '{"items":[{"product":"prd_8Hx2","qty":1}]}'
Import a Postman collection
Drop a Collection Format v2.1 export on the window. Folders, auth, variables, form data and path variables come across, and a preview names what doesn’t before anything is imported.
Or start from nothing
⌘N, a URL, ⌘↵. There’s no account to create first.

Satchel

main2

GETList products

QUERYSearch products

GETGet product

→http://localhost:8080/v2/products?limit=20&sort=-created_at

Query parameterskept in sync with the URL

	Key	Value

200 OK48 ms476 B

Changed by the post-response script.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

{ "total": 148, "products": [ { "id": "prd_8Hx2", "name": "Canvas Satchel", "price": 189.9, "inStock": true, "tags": [ "bags", "canvas" ] }, { "id": "prd_3Kd9", "name": "Waxed Tote", "price": 145, "inStock": false, "tags": [ "bags" ] }, { "id": "prd_Q71m", "name": "Leather Strap", "price": 49.9, "inStock": true, "tags": [ "accessories" ] } ] }

Built for the loop you run all day: edit, send, read.

Satchel stays open beside your editor and your terminal. Everything a request depends on is on screen, and nothing opens a dialog between you and the response.

Every {{variable}} shows where it comes from.
Hover a token in the URL, a header or the body to see its value and the scope it came from: the active environment first, then the collection, then globals. A variable the active environment can’t resolve is flagged before the request goes out.
All your environments in one table.
Local, Staging and Production side by side with the collection and global values they override. Create, copy, rename and color environments. Mark a variable secret and its values go to your system keychain instead of the shared files.
Read the response the way it’s shaped.
Pretty, Tree, Table or Raw. Lists of records become a sortable grid with a row inspector. Search keys, values or a path like data[0].name, pop the body out into its own window, or export it as JSON, CSV or the raw text.
Script before the request and after the response.
Sign a request before it’s sent, keep the token from a login response, or trim a payload down to what the screen needs. Scripts run in a sandbox with no network, files or timers, travel with the request’s file, and log to a Console.
Find the rate limit before your users do.
Fire N requests a second for T seconds at the resolved URL. Latency is charted, X-RateLimit-Remaining is traced across the run, and the first 429 is marked with the request that tripped it.
The whole loop, from the keyboard.
⌘K jumps to any request, switches environment or runs a command.
⌘↵
send
⌘E
next environment
⌘1…9
pick one
⌘N
new request
Ctrl instead of ⌘ on Windows and Linux.

Satchel

main2

GETList products

QUERYSearch products

GETGet product

→https://staging.shop.dev/v2/products?limit=50&sort=-created_at

Query parameterskept in sync with the URL

	Key	Value

200 OK240 ms476 B

Changed by the post-response script.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

{{baseUrl}}from Environment · Staging

https://staging.shop.dev

Environment · Staginghttps://staging.shop.dev

Collection · Shop APIhttp://localhost:8080

Globals—

env → collection → globals

id	name	price	inStock	tags
prd_8Hx2	Canvas Satchel	189.9	true	["bags","canvas"]
prd_3Kd9	Waxed Tote	145	false	["bags"]
prd_Q71m	Leather Strap	49.9	true	["accessories"]

#	t	Status	Latency	Remaining	Retry-After
100	5.00s	429	10 ms	0	55
99	4.95s	429	15 ms	0	56
98	4.90s	429	7 ms	0	56
97	4.85s	429	12 ms	0	56
96	4.80s	429	11 ms	0	56
95	4.75s	429	13 ms	0	56
94	4.70s	429	8 ms	0	56
93	4.65s	429	11 ms	0	56
92	4.60s	429	10 ms	0	56
91	4.55s	429	13 ms	0	56
90	4.50s	429	8 ms	0	56
89	4.45s	429	15 ms	0	56
88	4.40s	429	10 ms	0	56
87	4.35s	429	6 ms	0	56
86	4.30s	429	10 ms	0	56
85	4.25s	429	8 ms	0	56
84	4.20s	429	11 ms	0	56
83	4.15s	429	9 ms	0	56
82	4.10s	429	13 ms	0	56
81	4.05s	429	10 ms	0	56
80	4.00s	429	7 ms	0	56
79	3.95s	429	15 ms	0	57
78	3.90s	429	14 ms	0	57
77	3.85s	429	6 ms	0	57
76	3.80s	429	13 ms	0	57
75	3.75s	429	14 ms	0	57
74	3.70s	429	11 ms	0	57
73	3.65s	429	12 ms	0	57
72	3.60s	429	10 ms	0	57
71	3.55s	429	9 ms	0	57
70	3.50s	429	10 ms	0	57
69	3.45s	429	12 ms	0	57
68	3.40s	429	11 ms	0	57
67	3.35s	429	6 ms	0	57
66	3.30s	429	6 ms	0	57
65	3.25s	429	9 ms	0	57
64	3.20s	429	7 ms	0	57
63	3.15s	429	10 ms	0	57
62	3.10s	429	13 ms	0	57
61	3.05s	429	8 ms	0	57
60	3.00s	200	60 ms	0	—
59	2.95s	200	53 ms	1	—
58	2.90s	200	62 ms	2	—
57	2.85s	200	55 ms	3	—
56	2.80s	200	41 ms	4	—
55	2.75s	200	42 ms	5	—
54	2.70s	200	50 ms	6	—
53	2.65s	200	48 ms	7	—
52	2.60s	200	55 ms	8	—
51	2.55s	200	49 ms	9	—
50	2.50s	200	57 ms	10	—
49	2.45s	200	48 ms	11	—
48	2.40s	200	58 ms	12	—
47	2.35s	200	46 ms	13	—
46	2.30s	200	64 ms	14	—
45	2.25s	200	149 ms	15	—
44	2.20s	200	60 ms	16	—
43	2.15s	200	147 ms	17	—
42	2.10s	200	104 ms	18	—
41	2.05s	200	44 ms	19	—
40	2.00s	200	47 ms	20	—
39	1.95s	200	42 ms	21	—
38	1.90s	200	47 ms	22	—
37	1.85s	200	57 ms	23	—
36	1.80s	200	61 ms	24	—
35	1.75s	200	50 ms	25	—
34	1.70s	200	47 ms	26	—
33	1.65s	200	39 ms	27	—
32	1.60s	200	60 ms	28	—
31	1.55s	200	39 ms	29	—
30	1.50s	200	37 ms	30	—
29	1.45s	200	36 ms	31	—
28	1.40s	200	60 ms	32	—
27	1.35s	200	36 ms	33	—
26	1.30s	200	49 ms	34	—
25	1.25s	200	58 ms	35	—
24	1.20s	200	40 ms	36	—
23	1.15s	200	35 ms	37	—
22	1.10s	200	36 ms	38	—
21	1.05s	200	52 ms	39	—
20	1.00s	200	54 ms	40	—
19	0.95s	200	41 ms	41	—
18	0.90s	200	44 ms	42	—
17	0.85s	200	39 ms	43	—
16	0.80s	200	41 ms	44	—
15	0.75s	200	53 ms	45	—
14	0.70s	200	32 ms	46	—
13	0.65s	200	54 ms	47	—
12	0.60s	200	46 ms	48	—
11	0.55s	200	50 ms	49	—
10	0.50s	200	102 ms	50	—
9	0.45s	200	38 ms	51	—
8	0.40s	200	44 ms	52	—
7	0.35s	200	36 ms	53	—
6	0.30s	200	51 ms	54	—
5	0.25s	200	46 ms	55	—
4	0.20s	200	43 ms	56	—
3	0.15s	200	45 ms	57	—
2	0.10s	200	53 ms	58	—
1	0.05s	200	54 ms	59	—

Your workspace is a folder. Share it through git.

One file per request, in a folder you pick: a repository of its own, or a folder inside your API’s repo. Teammates pull, edit and push it like the rest of the code, on any git host.

~/code/shop/api


              shop-api/
              
            
              ├─ satchel.json
              order of collections and environments, globals
            
              ├─ collections/
              
            
              │  └─ shop-api/
              
            
              │     ├─ collection.json
              collection variables
            
              │     ├─ auth/
              
            
              │     │  └─ login.request.json
              
            
              │     └─ products/
              
            
              │        ├─ folder.json
              
            
              │        ├─ list-products.request.json
              
            
              │        └─ search-products.request.json
              one request per file
            
              ├─ environments/
              
            
              │  ├─ local.json
              
            
              │  └─ production.json
              secrets left empty
            
              └─ .satchel/
              yours alone; git ignores it

mainorigin/mainFetchPullPush ↑1

Changes 3

MQUERYSearch productscollections/shop-api/products/search-products.request.json

APOSTCreate chargecollections/payments-sandbox/create-charge.request.json

MProductionenvironments/production.json

Search products with QUERY

Commit & PushCommit 2 files

Nothing is committed or pushed until you click.

Secrets stay in your keychain
Mark a variable secret and its values go to the macOS Keychain, the Windows Credential Manager or the Secret Service on Linux. The shared files keep an empty value.
You decide when to sync
Satchel saves as you edit, like any editor, and never commits, pulls or pushes on its own. It runs your system git, so your SSH keys and credential manager apply.
Changes from outside reload
A pull or a branch switch in the terminal reloads the workspace. A file with conflict markers is listed and left alone until you resolve it.

Everything else in the bag.

Methods: GET
POST
PUT
PATCH
DELETE
QUERY
HEAD
OPTIONS
QUERY is the IETF draft: safe and idempotent like GET, with a body.
Request: Query params synced with the URL both ways
/:name path parameters
Headers, with the ones Satchel adds shown
Body: JSON, with Beautify
Form data, with text and file fields
x-www-form-urlencoded
Auth: Bearer
Basic
API key, in a header or the query
Response: Status, time and size
Pretty, Tree, Table and Raw, with search
Its own window that follows new responses
Export as JSON, CSV or raw
Scripts: Pre-request and post-response, in JavaScript
sat.env, sat.request, sat.response and a Console
QuickJS sandbox: no network, files or timers, 1 s per run
Import: Postman Collection v2.1 and environment files
cURL, pasted anywhere
Workspace: A folder of JSON files, one per request
Git status, commit, pull and push
Secrets in the system keychain
Single-file .json workspaces open and convert
Built with: Tauri 2 and Rust, React and TypeScript
MIT license

Satchel

main2

GETList products

QUERYSearch products

GETGet product

→http://localhost:8080/v2/products

QUERYSafe and idempotent like GET, but the query goes in the body, so it can be cached and retried. Servers list what they accept in Accept-Query.

1
2
3
4
5
6
7
8
9
10
11

{ "q": "satchel", "filter": { "inStock": true, "tags": [ "bags" ] }, "sort": "-price", "limit": 20 }

200 OK48 ms516 B

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

Dark and light themes. This is the light one, on the same request as above.

Download Satchel

Version 1.0.1, free and open source. Release notes

macOS

Universal: Apple silicon and Intel

Your system

Download .dmg8.7 MB

First launch: builds aren’t notarized yet, so macOS blocks the first open. Go to System Settings › Privacy & Security and choose Open Anyway.

Windows

Windows 10 and 11, x64

Your system

Download installer3.4 MB

First launch: the installer isn’t signed yet, so SmartScreen may warn. Choose More info, then Run anyway. A Microsoft Store listing is on its way.

Linux

x86_64: .deb, .rpm or AppImage

Your system

Download .deb5.6 MB

$sudo apt install ./Satchel_1.0.1_amd64.deb

Fedora, RHEL or openSUSE: sudo dnf install ./Satchel-1.0.1-1.x86_64.rpm

macOS

Windows

Microsoft StoreWindows 10 and 11 · updates through the StoreComing soon
Installer.exe · x643.4 MB
MSI package.msi · x644.6 MB

Linux

Older versions are on GitHub Releases. To build from source, follow the README.

Variable	WorkspaceGlobals	CollectionShop API	CollectionPayments Sandbox	Environment · activeLocal	EnvironmentStaging	EnvironmentProduction
apiVersion
baseUrl
clientId
clientSecretsecret
pageSize
payUrl
requestTimeout
stripeKeysecret
tokensecret
userAgent

The API client that keeps its requests in your repo.

Bring the requests you already have.

Paste a cURL

Import a Postman collection

Or start from nothing

Built for the loop you run all day: edit, send, read.

Every `{{variable}}` shows where it comes from.

All your environments in one table.

Read the response the way it’s shaped.

Script before the request and after the response.

Find the rate limit before your users do.

The whole loop, from the keyboard.

Environments & globals

Your workspace is a folder. Share it through git.

Secrets stay in your keychain

You decide when to sync

Changes from outside reload

Everything else in the bag.

Download Satchel

macOS

Windows

Linux

macOS

Windows

Linux

The API client that keeps its requests in your repo.

Bring the requests you already have.

Paste a cURL

Import a Postman collection

Or start from nothing

Every {{variable}} shows where it comes from.

All your environments in one table.

Read the response the way it’s shaped.

Script before the request and after the response.

Find the rate limit before your users do.

The whole loop, from the keyboard.

Environments & globals

Secrets stay in your keychain

You decide when to sync

Changes from outside reload

Everything else in the bag.

macOS

Windows

Linux

macOS

Windows

Linux

Every `{{variable}}` shows where it comes from.