One command registers an app. It prints a link; you open
it and click Approve, and the command prints your
client_id and the values your OIDC library needs.
One static file, nothing else to install. Pick your platform:
| Platform | Download |
|---|---|
| Linux, x86_64 | wicket-x86_64-unknown-linux-musl |
| Linux, arm64 | wicket-aarch64-unknown-linux-musl |
| macOS, Apple silicon | wicket-aarch64-apple-darwin |
| macOS, Intel | wicket-x86_64-apple-darwin |
curl -fsSLO https://wicketauth.com/cli/wicket-x86_64-unknown-linux-musl
curl -fsSLO https://wicketauth.com/cli/SHA256SUMS.txt
sha256sum --ignore-missing -c SHA256SUMS.txt
mv wicket-x86_64-unknown-linux-musl wicket && chmod +x wicket && ./wicket --version
Checksums for every file are in SHA256SUMS.txt.
On macOS, use shasum -a 256 -c; a file downloaded with a
browser rather than curl may need
xattr -d com.apple.quarantine wicket before it runs.
wicket setup --name "My app" \
--redirect-uri http://127.0.0.1:3000/callback
The command prints a link and a code, and opens the link in your browser when it can. Open it; the first time, it asks you to sign in to the dashboard with your email, and your browser then stays signed in for 30 days. Check the page shows the same code, and click Approve. That is the only step that needs a person. The command then registers the app and prints:
client_id live_...
issuer https://login.wicketauth.com
discovery https://login.wicketauth.com/.well-known/openid-configuration
# .env
WICKET_ISSUER=https://login.wicketauth.com
WICKET_CLIENT_ID=live_...
Approving gives this machine a credential that manages your apps and
nothing else: it can't sign anyone in. It is kept in your config
directory, readable only by you, and expires after 90 days unused.
wicket logout revokes it.
wicket setup --name --redirect-uri | Approve (once) and register an app. Repeat --redirect-uri for more than one. |
wicket login | Approve without registering an app. |
wicket apps list | Your apps. |
wicket apps show <client_id> | One app. |
wicket apps update <client_id> [--name] [--redirect-uri] | Change its name, or replace its redirect URIs. |
wicket apps delete <client_id> | Delete it. |
wicket upgrade <client_id> --plan starter (or pro) | Print a Stripe Checkout link that moves the app to that plan. Paying is yours to do; switch plans later under Manage billing on the app's dashboard page. |
wicket logout | Revoke this machine's credential and forget it. |
Every command takes --json, which prints the server's JSON
instead of text, for scripts and agents.