CLI reference
amendable --help| Command | What it does | Grant needed |
|---|---|---|
login | Device grant, store token | none (creates a session) |
logout | Drop stored token | none |
whoami / usage | Username + /v1/account/usage | any token |
git-credential | Git get helper | token in config |
oidc-exchange --id-token | POST /v1/oidc/token | none on the request |
repo list | List repos | any token |
repo create NAME | Create | API_REPOS_WRITE or ALL |
repo get NAME | Show one | any token that can see it |
repo url NAME | Print clone URL | any token (resolves username) |
repo clone NAME [DIR] | git clone with token, then clean origin | GIT_HTTP_READ |
repo delete NAME --yes | Delete | API_REPOS_WRITE or ALL |
token list | List tokens | ALL + ALL_REPO |
token create --grants ... | Mint token, print secret once | ALL + ALL_REPO |
token delete ID | Delete token | ALL + ALL_REPO |
webhook list | List | API_WEBHOOKS or ALL |
webhook create URL | Create, print secret once | API_WEBHOOKS or ALL |
webhook ping ID | Queue ping | API_WEBHOOKS or ALL |
webhook deliveries ID | List deliveries | API_WEBHOOKS or ALL |
webhook delete ID | Delete | API_WEBHOOKS or ALL |
--json is available on the read/create commands that return API bodies.
Defaults are production (api.amendable.io / amendable.io). Global --staging and login --staging switch to stage.api.amendable.io / stage.amendable.io.
repo create --clone creates then clones into ./NAME.
--storage-bucket-id on create binds a verified BYO bucket.