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

{asher_cli-0.1.1 → asher_cli-1.0.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-1.0.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-1.0.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-1.0.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-1.0.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-1.0.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,11 +44,26 @@ jobs:
     needs: [build, publish]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
+      # Full history (fetch-depth: 0) so git-cliff can walk commits/tags.
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 0
       - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8
         with:
           name: dist
           path: dist/
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+      - name: Install git-cliff
+        run: uv tool install git-cliff
+      - name: Generate release notes with git-cliff
+        env:
+          VERSION: ${{ needs.build.outputs.version }}
+        run: |
+          # Explicit -c cliff.toml avoids auto-discovering pyproject.toml.
+          # Pin the just-released version so git-cliff groups its commits under
+          # the right heading even before the tag is fetched, then emit only
+          # that section (--latest) with the header stripped.
+          git cliff -c cliff.toml --tag "v${VERSION}" --latest --strip header -o RELEASE_NOTES.md
       - name: Create release
         env:
           GH_TOKEN: ${{ github.token }}
@@ -56,5 +71,5 @@ jobs:
         run: |
           gh release create "v${VERSION}" dist/* \
             --title "v${VERSION}" \
-            --generate-notes \
+            --notes-file RELEASE_NOTES.md \
             --verify-tag=false

asher_cli-1.0.0/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+All notable changes to asher-cli are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Generated by [git-cliff](https://git-cliff.org) from conventional commits.
+
+## [Unreleased]
+
+### 🚀 Features
+
+- *(robot)* Complete LR3/LR4 non-destructive support
+- *(notify)* Desktop toast notifications for fault events + /notify command
+- *(commands)* Accept /cat colour spelling (color as alias)
+- *(config)* Persist runtime settings to ~/.asher-cli/config.json
+
+### 📚 Documentation
+
+- *(roadmap)* Archive completed sections to docs/roadmap-archive/
+
+### 🔧 Miscellaneous
+
+- *(release)* Move ROADMAP to docs/, add git-cliff CHANGELOG automation
+
+## [0.2.0] - 2026-07-27
+
+### 🚀 Features
+
+- *(export)* Headless --export for cron/automation (ROADMAP §25)
+- *(completion)* Inline ghost-text suggestions for bare commands
+- *(completion)* Claude Code-style slash-command tab completion
+- *(history)* Aligned timestamps + rich pager header/footer
+- *(history)* Scrollable pager sub-view for activity history
+
+### 📚 Documentation
+
+- *(changelog)* Cut v0.2.0
+- *(commands)* Sync stale command lists in CLAUDE.md and slash-commands docstring
+- *(readme)* Sync command tables with code, add changelog
+
+### 🔧 Miscellaneous
+
+- Declare repo-level Claude Code plugins
+
+## [0.1.1] - 2026-07-21
+
+### 🚀 Features
+
+- *(commands)* Add /version slash command and sleep-schedule viewer
+- *(connection)* Persist OAuth session token in keyring
+- *(ui)* Cat panel badges, fault banner, cycling elapsed timer
+
+### 🐛 Bug Fixes
+
+- *(faults,panel)* Model-scoped detection; aligned complementary badges
+- *(faults)* Enum-aware detection; restore top rows; banner in cat panel
+
+### 📚 Documentation
+
+- *(roadmap)* Mark token persistence, /version, sleep-schedule done
+
+## [0.1.0] - 2026-07-20
+
+### 🚀 Features
+
+- *(lr5)* Wire up privacy, volume, camera-audio, drawer-reset
+- *(commands)* Split status/info, add info; fix flaky export test
+- *(commands)* Add wait-time, power, rename, insight
+- *(history)* Render readable, colour-coded event labels
+
+### 🐛 Bug Fixes
+
+- *(status)* Render readable status text, not enum repr
+
+### 📚 Documentation
+
+- *(roadmap)* Mark testing/coverage/versioning/CI as done
+- *(roadmap)* Mark LR5 extras (privacy/volume/camera-audio/drawer-reset) done
+- *(roadmap)* Mark wait-time/power/rename/insight + status/info split done
+
+### 🔧 Miscellaneous
+
+- Add CODEOWNERS to auto-request review on PRs
+
+<!-- generated by git-cliff -->

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

@@ -37,18 +37,23 @@ asher/
   auth.py           LoginScreen modal (ModalScreen[tuple[str,str]]) — available, not primary flow
   helpers.py        fmt_ago(), drawer_bar(), ts(), robot_model()  (pure, testable)
   constants.py      STATUS_COLORS, ROBOT_MODELS
+  config.py         runtime settings persistence — load()/save()/update() over ~/.asher-cli/config.json; holds poll interval, cat-panel visibility/colour, active pet index, notification settings (non-secret UI prefs only; credentials stay in keyring)
+  notifications.py  desktop toast + audible alert façade over plyer (fire/beep, always-safe no-op on failure/headless)
   cats.py           CATS dict (ASCII art)
   login_flow.py     LoginFlow state machine — inline email/password prompt in command bar
   robot_protocol.py RobotProtocol structural Protocol for pylitterbot robot objects
   robot_adapters.py RobotAdapter ABC + LR3/LR4/LR5 subclasses + make_adapter() factory
   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)
+  faults.py         check_faults(robot) — model-scoped safety/component fault detection (status enum + per-model attr allowlist incl. LR4 USB power fault; 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
@@ -65,9 +70,14 @@ tests/
   test_monitoring.py      MonitoringMixin async methods
   test_ui.py              UIMixin constants, CSS, helper existence
   test_mcp_config.py      Claude Desktop config read/write
+  test_config.py          runtime settings persistence — load/save/update over defaults
+  test_notifications.py   plyer toast + beep façade — always-safe no-op paths
   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 +113,14 @@ 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>`, `panel-brightness <low|medium|high>`, `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|colour <hex>`, `/refresh [seconds|off]`, `/config`, `/notify on|off|sound on|off|test`, `/version`, `/mcp on|off|status`, `/exit`
+
+`/refresh`, `/cat`, `/pet`, and `/notify` persist their settings to `~/.asher-cli/config.json` (via `asher.config.update()`), so they survive restarts. Credentials and the preferred-robot serial stay in the OS keyring; the config file holds only non-secret UI preferences.
+
+> 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 +138,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 +164,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-1.0.0}/PKG-INFO

@@ -1,7 +1,11 @@
 Metadata-Version: 2.4
 Name: asher-cli
-Version: 0.1.1
+Version: 1.0.0
 Summary: Terminal dashboard for Litter Robot (LR3/LR4/LR5) via the Whisker cloud API
+Project-URL: Homepage, https://github.com/karanshukla/asher-cli
+Project-URL: Repository, https://github.com/karanshukla/asher-cli
+Project-URL: Issues, https://github.com/karanshukla/asher-cli/issues
+Project-URL: Changelog, https://github.com/karanshukla/asher-cli/blob/main/CHANGELOG.md
 License: MIT License
         
         Copyright (c) 2026 Karz
@@ -35,6 +39,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Home Automation
 Requires-Python: >=3.10
 Requires-Dist: keyring>=24.0.0
+Requires-Dist: plyer>=2.1.0
 Requires-Dist: pylitterbot==2025.6.2
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: rich>=13.0.0
@@ -65,9 +70,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`, `panel-brightness <low|medium|high>` (LR4/LR5), `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|colour <hex>`, `/refresh [seconds|off]`, `/config`, `/notify on|off|sound on|off|test`, `/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 +140,17 @@ 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 |
+| `panel-brightness <low\|medium\|high>` | Set control-panel brightness (LR4/LR5 only; shows current if omitted) |
+| `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 |
@@ -149,28 +167,89 @@ LITTER_ROBOT_PASSWORD=yourpassword
 | `/pets` | List all pets on the account |
 | `/pet <index\|name>` | Switch which pet's name/weight shows in the status bar |
 | `/cat on\|off` | Show or hide the cat animation panel |
-| `/cat color <hex>` | Change the cat art colour (e.g. `/cat color #ff79c6`); `/cat reset` to revert |
+| `/cat colour <hex>` | Change the cat art colour (e.g. `/cat colour #ff79c6`); `color` also accepted; `/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) |
+| `/config` | Show current runtime settings (robot, refresh rate, cat panel, active pet, notifications) |
+| `/notify on\|off\|sound on\|off\|test` | Toggle desktop toast notifications for fault events (cat detected, pinch, motor fault, drawer full); `test` fires a sample toast |
+| `/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
+```
+
+## Configuration
+
+Runtime settings persist across restarts in `~/.asher-cli/config.json`, so you don't have to re-apply `/refresh 60`, `/cat colour #ff79c6`, or `/pet 1` every launch. The file is auto-created on first change and holds six non-secret UI preferences:
+
+| Setting | Slash command | Default |
+|---|---|---|
+| `poll_interval_seconds` | `/refresh <seconds\|off>` | `300` |
+| `cat_panel_visible` | `/cat on\|off` | `true` |
+| `cat_panel_color` | `/cat colour <hex>\|reset` | `null` (default palette) |
+| `active_pet_index` | `/pet <index\|name>` | `0` |
+| `notifications` | `/notify on\|off` | `true` |
+| `notification_sound` | `/notify sound on\|off` | `false` |
+
+Credentials and the preferred-robot serial stay in the OS keyring; `.env` vars stay as env vars. You generally don't need to edit the file by hand — just use the slash commands — but it's plain JSON and safe to inspect or delete (deleting it restores defaults).
 
 ## Releasing
 
 ```bash
-# bump version, commit, and tag in one step, then push with tags
-uv run bump-my-version bump patch    # 0.0.1 → 0.0.2
-uv run bump-my-version bump minor    # 0.0.2 → 0.1.0
-uv run bump-my-version bump major    # 0.1.0 → 1.0.0
+# 1. regenerate CHANGELOG.md from conventional commits (idempotent), then commit it
+uv run poe changelog
+git add CHANGELOG.md
+git commit -m "docs(changelog): update for next release"
+
+# 2. bump version, commit, and tag in one step, then push with tags
+uv run bump-my-version bump patch    # 0.2.0 → 0.2.1
+uv run bump-my-version bump minor    # 0.2.0 → 0.3.0
+uv run bump-my-version bump major    # 0.2.0 → 1.0.0
 
 git push && git push --tags
 
-# then push the release branch to trigger PyPI publish with the new semver
-git checkout -b release/0.0.2
-git push origin release/0.0.2
+# 3. push the release branch to trigger PyPI publish (OIDC) + GitHub Release
+#    (release notes auto-generated by git-cliff from the same cliff.toml)
+git checkout -b release/X.Y.Z
+git push origin release/X.Y.Z
 ```
 
+`CHANGELOG.md` is generated by [git-cliff](https://git-cliff.org) from
+conventional commits — see [`cliff.toml`](cliff.toml). Commit messages must use
+`feat:`/`fix:`/`docs:`/etc. prefixes (optionally scoped, e.g. `feat(robot):`)
+to appear in the changelog.
+
 ## Troubleshooting
 
 **`asher` not found after `pip install asher-cli`**
@@ -262,6 +341,11 @@ 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
+
+The full, maintained release history lives in [CHANGELOG.md](CHANGELOG.md),
+auto-generated from conventional commits by [git-cliff](https://git-cliff.org).
+
 ## 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-1.0.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`, `panel-brightness <low|medium|high>` (LR4/LR5), `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|colour <hex>`, `/refresh [seconds|off]`, `/config`, `/notify on|off|sound on|off|test`, `/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,17 @@ 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 |
+| `panel-brightness <low\|medium\|high>` | Set control-panel brightness (LR4/LR5 only; shows current if omitted) |
+| `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 |
@@ -103,28 +116,89 @@ LITTER_ROBOT_PASSWORD=yourpassword
 | `/pets` | List all pets on the account |
 | `/pet <index\|name>` | Switch which pet's name/weight shows in the status bar |
 | `/cat on\|off` | Show or hide the cat animation panel |
-| `/cat color <hex>` | Change the cat art colour (e.g. `/cat color #ff79c6`); `/cat reset` to revert |
+| `/cat colour <hex>` | Change the cat art colour (e.g. `/cat colour #ff79c6`); `color` also accepted; `/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) |
+| `/config` | Show current runtime settings (robot, refresh rate, cat panel, active pet, notifications) |
+| `/notify on\|off\|sound on\|off\|test` | Toggle desktop toast notifications for fault events (cat detected, pinch, motor fault, drawer full); `test` fires a sample toast |
+| `/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
+```
+
+## Configuration
+
+Runtime settings persist across restarts in `~/.asher-cli/config.json`, so you don't have to re-apply `/refresh 60`, `/cat colour #ff79c6`, or `/pet 1` every launch. The file is auto-created on first change and holds six non-secret UI preferences:
+
+| Setting | Slash command | Default |
+|---|---|---|
+| `poll_interval_seconds` | `/refresh <seconds\|off>` | `300` |
+| `cat_panel_visible` | `/cat on\|off` | `true` |
+| `cat_panel_color` | `/cat colour <hex>\|reset` | `null` (default palette) |
+| `active_pet_index` | `/pet <index\|name>` | `0` |
+| `notifications` | `/notify on\|off` | `true` |
+| `notification_sound` | `/notify sound on\|off` | `false` |
+
+Credentials and the preferred-robot serial stay in the OS keyring; `.env` vars stay as env vars. You generally don't need to edit the file by hand — just use the slash commands — but it's plain JSON and safe to inspect or delete (deleting it restores defaults).
 
 ## Releasing
 
 ```bash
-# bump version, commit, and tag in one step, then push with tags
-uv run bump-my-version bump patch    # 0.0.1 → 0.0.2
-uv run bump-my-version bump minor    # 0.0.2 → 0.1.0
-uv run bump-my-version bump major    # 0.1.0 → 1.0.0
+# 1. regenerate CHANGELOG.md from conventional commits (idempotent), then commit it
+uv run poe changelog
+git add CHANGELOG.md
+git commit -m "docs(changelog): update for next release"
+
+# 2. bump version, commit, and tag in one step, then push with tags
+uv run bump-my-version bump patch    # 0.2.0 → 0.2.1
+uv run bump-my-version bump minor    # 0.2.0 → 0.3.0
+uv run bump-my-version bump major    # 0.2.0 → 1.0.0
 
 git push && git push --tags
 
-# then push the release branch to trigger PyPI publish with the new semver
-git checkout -b release/0.0.2
-git push origin release/0.0.2
+# 3. push the release branch to trigger PyPI publish (OIDC) + GitHub Release
+#    (release notes auto-generated by git-cliff from the same cliff.toml)
+git checkout -b release/X.Y.Z
+git push origin release/X.Y.Z
 ```
 
+`CHANGELOG.md` is generated by [git-cliff](https://git-cliff.org) from
+conventional commits — see [`cliff.toml`](cliff.toml). Commit messages must use
+`feat:`/`fix:`/`docs:`/etc. prefixes (optionally scoped, e.g. `feat(robot):`)
+to appear in the changelog.
+
 ## Troubleshooting
 
 **`asher` not found after `pip install asher-cli`**
@@ -216,6 +290,11 @@ 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
+
+The full, maintained release history lives in [CHANGELOG.md](CHANGELOG.md),
+auto-generated from conventional commits by [git-cliff](https://git-cliff.org).
+
 ## Notes
 
 - Uses the unofficial [pylitterbot](https://github.com/natekspencer/pylitterbot) library — supports LR3, LR4, LR5, and other Whisker robots