Metadata-Version: 2.4
Name: aura-ai-agent
Version: 0.3.0
Summary: Aura – personal AI work assistant CLI
Project-URL: Repository, https://github.com/HKUDS/Camp-AIR
Author: Jie Wang
License: MIT
Keywords: ai,aura,cli,productivity,tasks,work
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Scheduling
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: python-dateutil>=2.9
Requires-Dist: rich>=13
Requires-Dist: typer>=0.12
Description-Content-Type: text/markdown

# Aura CLI

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

## Install

```bash
pip install aura-ai-agent
```

Requires Python 3.11+.

## Commands

### Tasks

```bash
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

```bash
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

```bash
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
