aura-ai-agent 0.3.0

Aura – personal AI work assistant CLI

Aura CLI

Personal AI work assistant CLI for task management, workday sync, and productivity summaries.

Install

pip install aura-ai-agent

Requires Python 3.11+.

Commands

Tasks

aura tasks list                                        # active tasks grouped by priority
aura tasks list --priority high                        # filter by priority
aura tasks list --status all                           # include completed
aura tasks create "Fix login bug" --priority high --due 2026-03-28
aura tasks start "Fix login"                           # mark in progress
aura tasks complete "Fix login"                        # mark done + auto-archive check
aura tasks snooze "Fix login" --until 2026-03-25
aura tasks search "authentication"
aura tasks archive                                     # move 7+ day completed tasks to archive
aura tasks update "Fix bug" --priority high --due 2026-04-01
aura tasks update "Fix bug" --notes "waiting for design sign-off"
aura tasks update "Fix bug" --tags "bug,sprint-43"
aura tasks update "Fix bug" --due ""                   # clear due date
aura tasks start "Fix bug" --notes "starting investigation"
aura tasks complete "Fix bug" --notes "fixed in abc123, deployed"

Sources

aura sources list
aura sources add workiq --type mcp --fetch-hint "Fetch tasks since {start-date}."
aura sources add ado --type cli \
  --fetch-hint "Fetch work items since {start-date}." \
  --skill ado-cli
aura sources enable ado
aura sources disable ado
aura sources remove ado

Source names must contain only letters, digits, and underscores (no hyphens).

Dashboard

aura dashboard show              # terminal snapshot
aura dashboard show --live       # auto-refresh (Ctrl+C to stop)
aura dashboard show --interval 3 # refresh every 3 seconds
aura dashboard serve             # web UI at http://localhost:3333
aura dashboard serve --port 8080

Data files

All data is stored locally:

~/.aura/
  tasks/
    task-workiq-ABC-123.json     -- external source task
    task-manual-a3f9b2.json      -- manual task (6-char UUID)
  archive/
    task-workiq-OLD-001.json     -- completed 7+ days ago
  task-sources.json              -- configured sources
  last-sync.json                 -- written by start-workday workflow

On Windows ~ resolves to %USERPROFILE%, on macOS/Linux to $HOME.

Task sources

Two source types:

Type	How tasks are fetched
mcp	Agent calls the named MCP server using fetch_hint as instruction
cli	Agent uses the skill named in skill for fetch instructions; fetch_hint provides mapping hints

Default source (workiq) is created automatically on first use.

License

MIT