v1.0.0
CLI reference
Every times command and flag.
Global flags work with every command.
| Flag | Notes |
|---|---|
--org <slug> | Override the active organization. |
--json | Print machine-readable JSON. |
--yes | Skip confirmations. Required in non-interactive shells. |
--api-url <url> | Defaults to https://api.times.et. Also TIMES_API_URL. |
--profile <name> | Use this credential profile for one command. Also TIMES_PROFILE. |
TIMES_TOKEN overrides stored credentials.
Profiles live in ~/.config/times/config.toml. times auth login and times auth use set the current profile. --profile and TIMES_PROFILE only apply to that invocation.
Auth
| Command | What it does |
|---|---|
times auth login | Device flow sign in. Opens the browser to approve a code. Saves the current profile. |
times auth login --token <tdk_...> | Store a personal access token instead. |
times auth logout | Sign out of the current profile. |
times auth whoami | Show the signed-in user, profile, active organization and role. |
times auth refresh | Refresh the stored browser session. Developer tokens and TIMES_TOKEN cannot refresh. |
times auth list | List saved profiles. |
times auth use <name> | Switch the current profile. |
times auth delete <name> | Sign out and remove a profile. |
Organizations
| Command | What it does |
|---|---|
times org list | List your organizations. |
times org use <slug> | Set the active organization. |
Project
| Command | What it does |
|---|---|
times init [dir] --kind <kind> --framework <fw> | Scaffold a new AIP. Creates a folder named after the slug unless dir is .. Prompts when flags are missing. |
times manifest validate | Validate times.aip.json against the schema and check catalogs. |
times manifest bump <major|minor|patch> | Bump the manifest version. |
times dev [--port 4321] | Serve the build locally for a sandbox workspace. |
AIPs
| Command | What it does |
|---|---|
times aip list | AIPs in the active organization. |
times aip create | Register the slug from the local manifest. |
times aip info [slug] | Details and latest versions. |
times aip push [--dir dist] | Zip the build, upload it and create a draft version. |
times aip submit [--notes <text>] | Submit the latest draft for review. |
times aip status [slug] | Review state and reviewer notes. |
times aip withdraw <version> | Withdraw a version. |
times aip logs [slug] | Recent review and publish events. |
Money
| Command | What it does |
|---|---|
times stats [--slug <slug>] [--range 30d] | Installs, active installs and revenue. |
times earnings [--from <date>] [--to <date>] | Earnings ledger. |
times payout list | Withdrawal history. |
times payout request --amount <etb> --account <id> | Request a withdrawal. |
Tokens
| Command | What it does |
|---|---|
times token create --name <name> [--expires 90d] | Create a personal access token. Shown once. |
times token list | List tokens. |
times token revoke <id> | Revoke a token. |
Other
| Command | What it does |
|---|---|
times completions <bash|zsh|fish|powershell> | Print shell completions. |
times setup-shell | Disable the POSIX times builtin in your shell config. --print writes the snippet to stdout. |
times upgrade | Install the latest CLI. Alias: self-upgrade. Changelog: /docs/cli-changelog. |