CLI Reference

aias provides nine commands. All are available via aias help at the terminal.

aias help

Command Summary

Command	Purpose
aias install [PATTERN...]	Capture PATH, API keys, and env vars into env.sh. Run once before scheduling any prompts.
aias update	Scan prompts, validate, install all scheduled jobs. Primary command.
aias add PATH	Add or replace a single prompt's cron job without touching others.
aias remove PROMPT_ID	Remove a single prompt's cron job. Aliases: rm, delete.
aias check	Diff view: what is scheduled vs what is installed.
aias list	Print all currently installed jobs.
aias dry-run	Preview update output without writing the crontab.
aias show PROMPT_ID	Inspect a single installed job.
aias next [N]	Show next scheduled run time for installed jobs.
aias last [N]	Show last-run time for installed jobs.
aias clear	Remove all aias-managed crontab entries.
aias uninstall	Remove the managed env block from env.sh.

Global Option

--prompts-dir PATH (alias -p) overrides the AIA_PROMPTS__DIR / AIA_PROMPTS_DIR environment variables for any command that reads prompt files. It has no effect on commands that only read from the crontab (list, show, next, last, clear).

aias --prompts-dir ~/work/prompts update
aias --prompts-dir ~/work/prompts add ~/work/prompts/standup.md
aias -p ~/work/prompts dry-run
aias -p ~/work/prompts check

The lookup order for the prompts directory is:

1. --prompts-dir CLI option (highest priority)
2. AIA_PROMPTS__DIR environment variable (AIA >= 0.8.0)
3. AIA_PROMPTS_DIR environment variable (AIA < 0.8.0)
4. Error — neither option nor env var is set

Exit Codes

Code	Meaning
0	Success
1	Error (bad prompts directory, crontab write failure, prompt not found)

Validation failures during update do not cause a non-zero exit — invalid prompts are warned and skipped while valid ones are installed.