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 | API_REPOS_READ or ALL |
repo create NAME |
Create | API_REPOS_WRITE or ALL |
repo get NAME |
Show one | API_REPOS_READ or ALL |
repo url NAME |
Print clone URL | API_REPOS_READ if username is not already stored |
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.
login --hostname sets the grant-page label (defaults to this machine). login --poll-seconds sets how often to poll (default 2). See CLI login.
Defaults are api.amendable.io and amendable.io.
repo create --clone creates then clones into ./NAME.
repo create --storage-bucket-id UUID is optional. Git objects default to Amendable platform S3. Pass a UUID only to store this repo’s layer tarballs in a verified bring-your-own S3 bucket. Copy the id from Settings → Bring-your-own storage or GET /v1/storage-buckets. Omit it to use the account default bucket, or platform storage if you have no default. Binding cannot change later.