Skip to content

CLI Commands

Global Options

FlagDescription
--config <path>Use a custom config file path
--helpShow help for any command
--versionPrint Airupt version

airupt setup

Run the interactive setup wizard. Creates ~/.airupt/config.yml.

bash
airupt setup

airupt start

Start the assistant process.

bash
airupt start
airupt start --daemon          # run in background
airupt start --config ~/my-config.yml

airupt stop

Stop the background daemon.

bash
airupt stop

airupt status

Show running status, connected channels, and today's cost.

bash
airupt status

airupt cost

Show cost usage.

bash
airupt cost                    # today
airupt cost --month            # current month
airupt cost --days 30          # last 30 days
airupt cost --by-skill         # breakdown by skill
airupt cost override --daily   # override daily limit
airupt cost override --monthly # override monthly limit

airupt memory

Manage the memory store.

bash
airupt memory list
airupt memory search <query>
airupt memory add "<fact>"
airupt memory delete <id>
airupt memory clear

airupt tasks

Manage scheduled tasks.

bash
airupt tasks list
airupt tasks add --cron "<expr>" --prompt "<prompt>"
airupt tasks add --cron "<expr>" --prompt "<prompt>" --channel telegram
airupt tasks run <id>          # run immediately
airupt tasks delete <id>

airupt skills

Inspect and manage loaded skills.

bash
airupt skills list             # list all skills and their tools
airupt skills reload           # reload custom skills without restart

airupt auth

Authenticate third-party integrations.

bash
airupt auth gmail              # OAuth flow for Gmail
airupt auth google-calendar    # OAuth flow for Google Calendar
airupt auth status             # show auth status for all integrations
airupt auth revoke gmail       # remove stored credentials

airupt logs

Tail the log file.

bash
airupt logs                    # tail last 50 lines
airupt logs --follow           # follow in real time
airupt logs --lines 200
airupt logs --level error      # filter by level

Released under the MIT License.