AutoMax
ReferenceCLI commands

automax users, tokens, schedule, integrations

Platform administration commands.

users

automax users create --username <name> --password <password> [--admin] [--role viewer|editor|admin] [--email <email>] [--org-owner]
automax users list
automax users set-role <username> <viewer|editor|admin>
automax users grant <username> --org <slug> --role owner|admin|member
automax users grant <username> --workspace <slug> --role admin|editor|viewer
automax users deactivate <username>

--admin creates a platform admin who also becomes owner of every organization without an owner. grant manages membership roles; a user's effective role in a workspace is the stronger of the explicit workspace role and the one implied by the organization role (member → viewer, admin/owner → admin).

tokens

automax tokens create --user <username> --name <label> [--scopes <list>] [--expires <days>]
automax tokens list [--user <username>]
automax tokens revoke <id>

Tokens are free, unlimited, scoped and revocable. create prints the value once; scopes default to every scope of the owner's role and may only be a subset of it. Tokens authenticate MCP over HTTP and CI ingest.

schedule

automax schedule add -p <slug> --name <name> --cron <expr> [--tz <timezone>] [-e <env>] [-t <expr>] [-l <layer>]... [-b <browser>]...
                     [--process <name>] [--overlap skip|queue|cancel-previous] [--jitter <seconds>] [--notify <list>] [--disabled]
automax schedule list [-p <slug>]
automax schedule next --cron <expr> [--tz <timezone>] [--count <n>]
automax schedule pause|resume|remove <name> -p <slug>
automax schedule run-now <name> -p <slug>
automax schedule history <name> -p <slug>
automax schedule sync
automax schedule install --target crontab|launchd|systemd|github [-p <slug>] [--out <dir>]
automax schedule export

Schedules live in the project YAML (schedules[] and processes with a schedule) and in the database; sync mirrors YAML into the database, the server executes them, and install writes OS or GitHub Actions entries for server-less setups.

integrations

automax integrations test -p <slug> [--provider github|jira]
automax integrations notify --run-id <id> [-p <slug>] [--from-files] [--provider <name>] [--dry-run] [--report-url <url>] [--artifacts-dir <dir>]
automax integrations sync -p <slug> [--provider <name>]
automax integrations links -p <slug> [--provider <name>]

notify publishes a run to the enabled providers (GitHub check run and PR comment, GitHub or Jira issues deduplicated by scenario fingerprint); --from-files builds the summary from the run directory so it works without a database. sync scans features for @jira:KEY and @github:N tags, creates links and refreshes their status.

On this page