Skip to content

CLI reference

amendable --help
CommandWhat it doesGrant needed
loginDevice grant, store tokennone (creates a session)
logoutDrop stored tokennone
whoami / usageUsername + /v1/account/usageany token
git-credentialGit get helpertoken in config
oidc-exchange --id-tokenPOST /v1/oidc/tokennone on the request
repo listList reposany token
repo create NAMECreateAPI_REPOS_WRITE or ALL
repo get NAMEShow oneany token that can see it
repo url NAMEPrint clone URLany token (resolves username)
repo clone NAME [DIR]git clone with token, then clean originGIT_HTTP_READ
repo delete NAME --yesDeleteAPI_REPOS_WRITE or ALL
token listList tokensALL + ALL_REPO
token create --grants ...Mint token, print secret onceALL + ALL_REPO
token delete IDDelete tokenALL + ALL_REPO
webhook listListAPI_WEBHOOKS or ALL
webhook create URLCreate, print secret onceAPI_WEBHOOKS or ALL
webhook ping IDQueue pingAPI_WEBHOOKS or ALL
webhook deliveries IDList deliveriesAPI_WEBHOOKS or ALL
webhook delete IDDeleteAPI_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.