asher-cli 0.1.1__tar.gz → 0.2.0__tar.gz

{asher_cli-0.1.1 → asher_cli-0.2.0}/.claude/settings.json

@@ -1,4 +1,10 @@
 {
+  "enabledPlugins": {
+    "context7@claude-plugins-official": true,
+    "github@claude-plugins-official": true,
+    "security-guidance@claude-plugins-official": true,
+    "claude-md-management@claude-plugins-official": true
+  },
   "permissions": {
     "allow": [
       "Bash(uv run *)",

{asher_cli-0.1.1 → asher_cli-0.2.0}/.github/workflows/ci.yml

@@ -12,8 +12,8 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
-      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
       - run: uv sync --dev
       - run: uv run ruff check .
       - run: uv run ruff format --check .
@@ -28,7 +28,7 @@ jobs:
         os: [ubuntu-latest, windows-latest, macos-latest]
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
-      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
       - run: uv sync --dev
       - run: uv run pytest tests/ -v --tb=short

{asher_cli-0.1.1 → asher_cli-0.2.0}/.github/workflows/claude-code-review.yml

@@ -27,13 +27,13 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
         with:
           fetch-depth: 1
 
       - name: Run Claude Code Review
         id: claude-review
-        uses: anthropics/claude-code-action@af0559ee4f514d1ef21826982bed13f7edc3c35e # v1
+        uses: anthropics/claude-code-action@be7b93b1907a4abad570368f3c74b6fe3807510b # v1
         with:
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
           plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'

{asher_cli-0.1.1 → asher_cli-0.2.0}/.github/workflows/claude.yml

@@ -26,13 +26,13 @@ jobs:
       actions: read # Required for Claude to read CI results on PRs
     steps:
       - name: Checkout repository
-        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
         with:
           fetch-depth: 1
 
       - name: Run Claude Code
         id: claude
-        uses: anthropics/claude-code-action@af0559ee4f514d1ef21826982bed13f7edc3c35e # v1
+        uses: anthropics/claude-code-action@be7b93b1907a4abad570368f3c74b6fe3807510b # v1
         with:
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
 

{asher_cli-0.1.1 → asher_cli-0.2.0}/.github/workflows/coverage.yml

@@ -12,8 +12,8 @@ jobs:
   coverage:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
-      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
       - run: uv sync --dev
       - name: Run tests with coverage
         run: uv run pytest tests/ --cov=asher --cov-report=lcov --cov-report=term-missing

{asher_cli-0.1.1 → asher_cli-0.2.0}/.github/workflows/release.yml

@@ -16,11 +16,11 @@ jobs:
     outputs:
       version: ${{ steps.version.outputs.version }}
     steps:
-      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
       - name: Extract version from branch name
         id: version
         run: echo "version=${GITHUB_REF_NAME#release/}" >> "$GITHUB_OUTPUT"
-      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
       - run: uv build
       - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         with:
@@ -44,7 +44,7 @@ jobs:
     needs: [build, publish]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
       - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
         with:
           name: dist

{asher_cli-0.1.1 → asher_cli-0.2.0}/CLAUDE.md

@@ -44,11 +44,14 @@ asher/
   mcp_config.py     Claude Desktop config read/write for the /mcp slash command
   mcp_bridge.py     asher-mcp-launch console script — keyring-backed pylitterbot MCP launcher
   faults.py         check_faults(robot) — model-scoped safety/component fault detection (status enum + per-model attr allowlist; hopper never a fault)
+  history_view.py   HistoryScreen (ModalScreen) + format_history_rows() — scrollable activity-history pager pushed by the `history` command
+  export.py         shared activity-history CSV core + headless export path: build_history_csv(), resolve_dest(), resolve_robot(), _run_headless_export(), ExportError — no Textual imports; both the TUI `export` command and `asher --export` call build_history_csv()
+  completion.py     pure helpers for command completion: slash popup (slash_matches, enter_completes, render_completion) + inline ghost text (CommandSuggester) — fed by _registry, no Textual imports except the Suggester base class
   __main__.py       main() entry point
   commands/
     base.py         Command ABC, SlashCommand, CommandRegistry
     __init__.py     CommandsMixin — all command classes + registry + dispatch
-  connection/       ConnectionMixin — keyring auth, _connect_worker, keyring helpers
+  connection/       ConnectionMixin — keyring auth, _connect_worker, keyring helpers, _connect_headless() (no-UI auth for `asher --export`)
   monitoring/       MonitoringMixin — _poll_status_interval, _refresh_status
   ui/               UIMixin — CSS, compose(), log helpers, cat helpers
   slash-commands/   Convention doc
@@ -68,6 +71,9 @@ tests/
   test_mcp_bridge.py      mcp_bridge launcher credential/subprocess handling
   test_mcp_command.py     /mcp slash command dispatch
   test_faults.py          check_faults() — safety statuses, attribute faults, graceful degradation
+  test_history_view.py    format_history_rows() + HistoryScreen structure + Pilot push/dismiss
+  test_export.py          build_history_csv/resolve_dest/resolve_robot/parse_days (pure) + headless _run_headless_export (no Pilot, mocks _connect_headless)
+  test_completion.py      slash_matches/enter_completes/render_completion (pure) + Pilot overlay visibility/navigation/accept
 
 .github/workflows/
   ci.yml            ruff + mypy + pytest on every push/PR
@@ -103,10 +109,12 @@ pylitterbot ships an optional MCP server (`pip install pylitterbot[mcp]`, run vi
 ## Command convention
 
 **Normal commands** (no prefix) — robot actions only:
-`clean`, `status`, `lock`, `unlock`, `sleep`, `wake`, `night-light on|off|auto`, `night-light-brightness <level>`, `history`, `clear`, `help`
+`clean`, `status`, `info`, `lock`, `unlock`, `sleep`, `wake`, `night-light on|off|auto`, `night-light-brightness <level>`, `wait-time <minutes>`, `power on|off`, `rename <name>`, `insight [days|month]`, `sleep-schedule`, `privacy on|off`, `volume <0-100>`, `camera-audio on|off`, `drawer-reset`, `history [count|all]`, `export [days|month]`, `clear`, `help`, `quit`
 
 **Slash commands** (`/` prefix) — app management only:
-`/login`, `/logout`, `/exit`, `/robots`, `/robot <index|name>`, `/pets`, `/pet <index|name>`, `/cat on|off|color <hex>`, `/refresh <seconds|off>`, `/config`, `/mcp on|off|status`
+`/login`, `/logout`, `/robots`, `/robot <index|name>`, `/pets`, `/pet <index|name>`, `/cat on|off|color <hex>`, `/refresh [seconds|off]`, `/config`, `/version`, `/mcp on|off|status`, `/exit`
+
+> The authoritative list is the `_registry` in `asher/commands/__init__.py`; `/help` renders it at runtime. If you add a command, update the tables in `README.md` and the list in `asher/slash-commands/__init__.py`.
 
 **Special cases** (accepted both with and without `/`):
 `exit`, `quit`, `q` — exit the app
@@ -124,6 +132,7 @@ AsherApp (textual.App)
 ├── #status-bar          top dock — two rows (top: name/online/night-light/lock; bottom: drawer/litter/weight/visit)
 ├── #main-area
 │   ├── #log             RichLog — scrollable event/command output
+│   ├── #completion-overlay  Static — floating slash-command completion list (overlay: screen; hidden unless typing /); does not reserve layout space
 │   └── #cat-panel       animated ASCII cat sidebar
 │       ├── #cat-fx      animated FX strip
 │       ├── #cat-art     the ASCII cat
@@ -149,7 +158,9 @@ LoginScreen (ModalScreen) — available in auth.py but not the primary auth path
 | `_poll_status_interval()` | `@work` — poll fallback every 300s (5 min); WebSocket is primary |
 | `_tick_cat()` | advances multi-frame cat animation every 0.4s |
 | `_dispatch_command(command, args)` | `@work` — calls `command.run(app, args)` from the registry |
-| `on_input_submitted()` | routes input to login flow or `_dispatch_command` via `CommandRegistry` |
+| `on_input_submitted()` | routes input to login flow or `_dispatch_command` via `CommandRegistry`; Enter on a partial `/cmd` completes it instead of submitting |
+| `on_input_changed()` | live-filters the `#completion-overlay` as the user types (slash commands only; hides once a space is present); also clears ghost text during the login flow |
+| `on_key()` | `↑`/`↓` history nav, plus completion nav (arrows cycle the slash popup, `Tab`/`Enter` accept, `Esc` dismisses); `Tab` also accepts the inline ghost-text suggestion when the popup is closed |
 | `_start_login_flow()` | begin inline email/password prompt in command bar |
 | `_cmd_logout()` | delete creds from keyring, disconnect |
 | `make_adapter(robot)` | factory in `robot_adapters.py` — returns correct `RobotAdapter` subclass |

{asher_cli-0.1.1 → asher_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: asher-cli
-Version: 0.1.1
+Version: 0.2.0
 Summary: Terminal dashboard for Litter Robot (LR3/LR4/LR5) via the Whisker cloud API
 License: MIT License
         
@@ -65,9 +65,12 @@ A Claude Code-style terminal dashboard for monitoring and controlling Litter Rob
 - Real-time cycling indicator with elapsed time (`⟳ Cycling  M:SS`)
 - Fault & safety monitoring — model-scoped in-panel alerts for cat detected, pinch, motor/position/gas faults (LR5: bonnet/laser/drawer); press `d` to dismiss
 - Cat panel with mode label + status badges (status chip, lock, night light, sleep, wait time) under the art
-- Scrollable activity log with timestamps
-- Commands: `clean`, `status`, `lock`, `unlock`, `sleep`, `wake`, `night-light on|off|auto`, `night-light-brightness`, `history`, `export [days|month]`, `help`, `quit`
-- Slash commands for app management: `/login`, `/logout`, `/robots`, `/robot <index|name>`, `/pets`, `/pet <index|name>`, `/cat on|off|color <hex>`, `/refresh [seconds|off]`, `/config`, `/exit`
+- Scrollable activity-history pager — `history [count|all]` opens a full-screen, paginated view (arrow keys, `Page Up`/`Page Down`, `Home`/`End`); `q`/`Esc`/`Enter` to close
+- Commands: `clean`, `status`, `info`, `lock`, `unlock`, `sleep`, `wake`, `night-light on|off|auto`, `night-light-brightness`, `wait-time`, `power on|off`, `rename`, `insight`, `sleep-schedule`, plus LR5 extras (`privacy`, `volume`, `camera-audio`, `drawer-reset`), `history [count|all]`, `export [days|month]`, `help`, `quit`
+- Slash commands for app management: `/login`, `/logout`, `/robots`, `/robot <index|name>`, `/pets`, `/pet <index|name>`, `/cat on|off|color <hex>`, `/refresh [seconds|off]`, `/config`, `/version`, `/mcp on|off|status`, `/exit`
+- Slash-command tab completion — type `/` and a Claude Code-style overlay lists matching commands; `↑`/`↓` to move, `Tab` or `Enter` to accept, `Esc` to dismiss
+- Inline ghost-text completion for bare commands — type a prefix (`cle`) and the rest (`an`) appears greyed; `Tab` or `→` to accept → `clean`
+- Headless export — `asher --export 7` writes activity history to CSV from cron / Task Scheduler / SSH without launching the TUI
 - Cat animation panel that reacts to robot state
 - Command history (↑/↓ arrows)
 - Real-time updates via WebSocket; 5-minute poll fallback
@@ -132,7 +135,16 @@ LITTER_ROBOT_PASSWORD=yourpassword
 | `sleep` / `wake` | Toggle sleep mode |
 | `night-light on\|off\|auto` | Set night light mode |
 | `night-light-brightness <level>` | Set brightness (LR5: 0-100; LR4: 25/50/100) |
-| `history` | Show last 25 activity events |
+| `wait-time <minutes>` | Set clean-cycle wait time (shows valid values / current if omitted) |
+| `power on\|off` | Hard-power the unit on or off |
+| `rename <new name>` | Rename the unit in the Whisker cloud |
+| `insight [days\|month]` | Show cycle-usage statistics (default: 30 days) |
+| `sleep-schedule` | Show the per-day sleep schedule (read-only) |
+| `privacy on\|off` | Toggle LR5 privacy mode |
+| `volume <0-100>` | Set LR5 sound volume |
+| `camera-audio on\|off` | Toggle LR5 camera audio |
+| `drawer-reset` | Reset the LR5 waste drawer level indicator |
+| `history [count\|all]` | Show recent activity in a scrollable pager (default: 50 events) |
 | `export [days\|month]` | Export activity history to CSV in `~/Downloads` (default: 30 days) |
 | `clear` | Clear the log |
 | `help` | Show command list |
@@ -152,9 +164,43 @@ LITTER_ROBOT_PASSWORD=yourpassword
 | `/cat color <hex>` | Change the cat art colour (e.g. `/cat color #ff79c6`); `/cat reset` to revert |
 | `/refresh [seconds\|off]` | Change the auto-poll interval or disable it (`/refresh 60`, `/refresh off`) |
 | `/config` | Show current runtime settings (robot, refresh rate, cat panel, active pet) |
+| `/version` | Show version info (asher-cli, Python, pylitterbot, textual) |
+| `/mcp on\|off\|status` | Toggle the Litter-Robot MCP server entry in Claude Desktop |
 | `/exit` | Exit Asher CLI |
 
-**Keyboard shortcuts:** `Ctrl+L` clears the log, `Ctrl+C` quits.
+**Keyboard shortcuts:** `Ctrl+L` clears the log, `Ctrl+C` quits. While typing a `/` slash command, `↑`/`↓` move through completions, `Tab` or `Enter` accepts, `Esc` dismisses. While typing a bare command, a greyed ghost suggestion appears — `Tab` or `→` accepts it.
+
+### Headless export (cron / Task Scheduler / SSH)
+
+`--export` writes the same CSV as the `export` command **without launching the TUI** — so you can script activity-history exports from cron, Windows Task Scheduler, or a server over SSH. No flags launches the interactive dashboard as before.
+
+```bash
+asher --export 7                         export last 7 days to ~/Downloads
+asher --export 7 --output ~/hist.csv     explicit output path
+asher --export month --robot "Asher 2"   30 days (Whisker ceiling) for a specific robot
+```
+
+`--robot` accepts an index or a partial, case-insensitive name (defaults to your saved preferred robot, else the first). Credentials use the same keyring → `.env` priority as the TUI, but with **no interactive login prompt** — a scheduled task can't type a password, so sign in once with `/login` first.
+
+Exit codes for scripting:
+
+| Code | Meaning |
+|---|---|
+| `0` | export succeeded |
+| `1` | no credentials found (keyring or `.env`) |
+| `2` | connection or API failure |
+| `3` | failed to write the CSV (permissions, disk full) |
+| `4` | `--robot` matched no robot on the account |
+
+```bash
+# crontab — nightly export at 03:00
+0 3 * * * /usr/bin/env asher --export 7 --output /home/me/litter-history.csv >> /var/log/asher-export.log 2>&1
+```
+
+```powershell
+# Windows Task Scheduler action
+asher.exe --export 7 --output C:\Users\me\litter-history.csv
+```
 
 ## Releasing
 
@@ -262,6 +308,33 @@ uv run poe check   # run all of the above + tests (same as CI)
 
 CI runs on Python 3.10 / 3.11 / 3.12 across Ubuntu, Windows, and macOS on every push.
 
+## Changelog
+
+### Unreleased
+
+### v0.2.0 — 2026-07-27
+
+- **Headless export** — `asher --export 7` writes activity history to CSV without launching the TUI, for cron / Task Scheduler / SSH. `--output` and `--robot <index|name>` flags select the destination and robot; documented exit codes for scripting.
+- **Activity-history pager** — `history` now opens a full-screen, scrollable view instead of dumping into the main log. Page through long histories with the arrow keys / `Page Up`/`Page Down` / `Home`/`End`; `q`, `Esc`, or `Enter` closes it. Accepts an optional event count (`history 100`) or `all` (default: 50).
+
+### v0.1.1
+
+- **Token persistence** — the OAuth session token is now saved to the keyring, so re-logins are skipped on subsequent launches.
+- **`/version`** — new slash command showing asher-cli, Python, pylitterbot, and textual versions.
+- **Sleep-schedule viewer** — new `sleep-schedule` command renders the per-day schedule (read-only).
+- **Cat panel badges** — mode label plus status chips (status, lock, night light, sleep, wait time) under the cat art.
+- **Fault & safety monitoring** — model-scoped, enum-aware detection with an in-panel banner; press `d` to dismiss.
+- **Cycling indicator** — real-time elapsed timer (`⟳ Cycling M:SS`).
+
+### v0.1.0
+
+- **Readable status & history** — robot status and activity events now render as plain English instead of raw enum values.
+- **Missing robot commands** — added `wait-time`, `power on|off`, `rename`, `insight`, and split `status` (summary) from `info` (full property dump).
+- **LR5 extras** — `privacy`, `volume`, `camera-audio`, and `drawer-reset` wired up via the robot adapter (gracefully refused on LR3/LR4).
+- **MCP bridge** — keyring-backed `pylitterbot[mcp]` launcher with Claude Desktop config management (`/mcp on|off|status`).
+
+Full history: see the [commit log](https://github.com/karanshukla/asher-cli/commits/main).
+
 ## Notes
 
 - Uses the unofficial [pylitterbot](https://github.com/natekspencer/pylitterbot) library — supports LR3, LR4, LR5, and other Whisker robots

{asher_cli-0.1.1 → asher_cli-0.2.0}/README.md

@@ -19,9 +19,12 @@ A Claude Code-style terminal dashboard for monitoring and controlling Litter Rob
 - Real-time cycling indicator with elapsed time (`⟳ Cycling  M:SS`)
 - Fault & safety monitoring — model-scoped in-panel alerts for cat detected, pinch, motor/position/gas faults (LR5: bonnet/laser/drawer); press `d` to dismiss
 - Cat panel with mode label + status badges (status chip, lock, night light, sleep, wait time) under the art
-- Scrollable activity log with timestamps
-- Commands: `clean`, `status`, `lock`, `unlock`, `sleep`, `wake`, `night-light on|off|auto`, `night-light-brightness`, `history`, `export [days|month]`, `help`, `quit`
-- Slash commands for app management: `/login`, `/logout`, `/robots`, `/robot <index|name>`, `/pets`, `/pet <index|name>`, `/cat on|off|color <hex>`, `/refresh [seconds|off]`, `/config`, `/exit`
+- Scrollable activity-history pager — `history [count|all]` opens a full-screen, paginated view (arrow keys, `Page Up`/`Page Down`, `Home`/`End`); `q`/`Esc`/`Enter` to close
+- Commands: `clean`, `status`, `info`, `lock`, `unlock`, `sleep`, `wake`, `night-light on|off|auto`, `night-light-brightness`, `wait-time`, `power on|off`, `rename`, `insight`, `sleep-schedule`, plus LR5 extras (`privacy`, `volume`, `camera-audio`, `drawer-reset`), `history [count|all]`, `export [days|month]`, `help`, `quit`
+- Slash commands for app management: `/login`, `/logout`, `/robots`, `/robot <index|name>`, `/pets`, `/pet <index|name>`, `/cat on|off|color <hex>`, `/refresh [seconds|off]`, `/config`, `/version`, `/mcp on|off|status`, `/exit`
+- Slash-command tab completion — type `/` and a Claude Code-style overlay lists matching commands; `↑`/`↓` to move, `Tab` or `Enter` to accept, `Esc` to dismiss
+- Inline ghost-text completion for bare commands — type a prefix (`cle`) and the rest (`an`) appears greyed; `Tab` or `→` to accept → `clean`
+- Headless export — `asher --export 7` writes activity history to CSV from cron / Task Scheduler / SSH without launching the TUI
 - Cat animation panel that reacts to robot state
 - Command history (↑/↓ arrows)
 - Real-time updates via WebSocket; 5-minute poll fallback
@@ -86,7 +89,16 @@ LITTER_ROBOT_PASSWORD=yourpassword
 | `sleep` / `wake` | Toggle sleep mode |
 | `night-light on\|off\|auto` | Set night light mode |
 | `night-light-brightness <level>` | Set brightness (LR5: 0-100; LR4: 25/50/100) |
-| `history` | Show last 25 activity events |
+| `wait-time <minutes>` | Set clean-cycle wait time (shows valid values / current if omitted) |
+| `power on\|off` | Hard-power the unit on or off |
+| `rename <new name>` | Rename the unit in the Whisker cloud |
+| `insight [days\|month]` | Show cycle-usage statistics (default: 30 days) |
+| `sleep-schedule` | Show the per-day sleep schedule (read-only) |
+| `privacy on\|off` | Toggle LR5 privacy mode |
+| `volume <0-100>` | Set LR5 sound volume |
+| `camera-audio on\|off` | Toggle LR5 camera audio |
+| `drawer-reset` | Reset the LR5 waste drawer level indicator |
+| `history [count\|all]` | Show recent activity in a scrollable pager (default: 50 events) |
 | `export [days\|month]` | Export activity history to CSV in `~/Downloads` (default: 30 days) |
 | `clear` | Clear the log |
 | `help` | Show command list |
@@ -106,9 +118,43 @@ LITTER_ROBOT_PASSWORD=yourpassword
 | `/cat color <hex>` | Change the cat art colour (e.g. `/cat color #ff79c6`); `/cat reset` to revert |
 | `/refresh [seconds\|off]` | Change the auto-poll interval or disable it (`/refresh 60`, `/refresh off`) |
 | `/config` | Show current runtime settings (robot, refresh rate, cat panel, active pet) |
+| `/version` | Show version info (asher-cli, Python, pylitterbot, textual) |
+| `/mcp on\|off\|status` | Toggle the Litter-Robot MCP server entry in Claude Desktop |
 | `/exit` | Exit Asher CLI |
 
-**Keyboard shortcuts:** `Ctrl+L` clears the log, `Ctrl+C` quits.
+**Keyboard shortcuts:** `Ctrl+L` clears the log, `Ctrl+C` quits. While typing a `/` slash command, `↑`/`↓` move through completions, `Tab` or `Enter` accepts, `Esc` dismisses. While typing a bare command, a greyed ghost suggestion appears — `Tab` or `→` accepts it.
+
+### Headless export (cron / Task Scheduler / SSH)
+
+`--export` writes the same CSV as the `export` command **without launching the TUI** — so you can script activity-history exports from cron, Windows Task Scheduler, or a server over SSH. No flags launches the interactive dashboard as before.
+
+```bash
+asher --export 7                         export last 7 days to ~/Downloads
+asher --export 7 --output ~/hist.csv     explicit output path
+asher --export month --robot "Asher 2"   30 days (Whisker ceiling) for a specific robot
+```
+
+`--robot` accepts an index or a partial, case-insensitive name (defaults to your saved preferred robot, else the first). Credentials use the same keyring → `.env` priority as the TUI, but with **no interactive login prompt** — a scheduled task can't type a password, so sign in once with `/login` first.
+
+Exit codes for scripting:
+
+| Code | Meaning |
+|---|---|
+| `0` | export succeeded |
+| `1` | no credentials found (keyring or `.env`) |
+| `2` | connection or API failure |
+| `3` | failed to write the CSV (permissions, disk full) |
+| `4` | `--robot` matched no robot on the account |
+
+```bash
+# crontab — nightly export at 03:00
+0 3 * * * /usr/bin/env asher --export 7 --output /home/me/litter-history.csv >> /var/log/asher-export.log 2>&1
+```
+
+```powershell
+# Windows Task Scheduler action
+asher.exe --export 7 --output C:\Users\me\litter-history.csv
+```
 
 ## Releasing
 
@@ -216,6 +262,33 @@ uv run poe check   # run all of the above + tests (same as CI)
 
 CI runs on Python 3.10 / 3.11 / 3.12 across Ubuntu, Windows, and macOS on every push.
 
+## Changelog
+
+### Unreleased
+
+### v0.2.0 — 2026-07-27
+
+- **Headless export** — `asher --export 7` writes activity history to CSV without launching the TUI, for cron / Task Scheduler / SSH. `--output` and `--robot <index|name>` flags select the destination and robot; documented exit codes for scripting.
+- **Activity-history pager** — `history` now opens a full-screen, scrollable view instead of dumping into the main log. Page through long histories with the arrow keys / `Page Up`/`Page Down` / `Home`/`End`; `q`, `Esc`, or `Enter` closes it. Accepts an optional event count (`history 100`) or `all` (default: 50).
+
+### v0.1.1
+
+- **Token persistence** — the OAuth session token is now saved to the keyring, so re-logins are skipped on subsequent launches.
+- **`/version`** — new slash command showing asher-cli, Python, pylitterbot, and textual versions.
+- **Sleep-schedule viewer** — new `sleep-schedule` command renders the per-day schedule (read-only).
+- **Cat panel badges** — mode label plus status chips (status, lock, night light, sleep, wait time) under the cat art.
+- **Fault & safety monitoring** — model-scoped, enum-aware detection with an in-panel banner; press `d` to dismiss.
+- **Cycling indicator** — real-time elapsed timer (`⟳ Cycling M:SS`).
+
+### v0.1.0
+
+- **Readable status & history** — robot status and activity events now render as plain English instead of raw enum values.
+- **Missing robot commands** — added `wait-time`, `power on|off`, `rename`, `insight`, and split `status` (summary) from `info` (full property dump).
+- **LR5 extras** — `privacy`, `volume`, `camera-audio`, and `drawer-reset` wired up via the robot adapter (gracefully refused on LR3/LR4).
+- **MCP bridge** — keyring-backed `pylitterbot[mcp]` launcher with Claude Desktop config management (`/mcp on|off|status`).
+
+Full history: see the [commit log](https://github.com/karanshukla/asher-cli/commits/main).
+
 ## Notes
 
 - Uses the unofficial [pylitterbot](https://github.com/natekspencer/pylitterbot) library — supports LR3, LR4, LR5, and other Whisker robots