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

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

@@ -44,11 +44,26 @@ jobs:
     needs: [build, publish]
     runs-on: ubuntu-latest
     steps:
+      # 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.2.0 → asher_cli-1.0.0}/CLAUDE.md

@@ -37,13 +37,15 @@ 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
@@ -68,6 +70,8 @@ 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
@@ -109,10 +113,12 @@ pylitterbot ships an optional MCP server (`pip install pylitterbot[mcp]`, run vi
 ## Command convention
 
 **Normal commands** (no prefix) — robot actions only:
-`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`
+`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`, `/robots`, `/robot <index|name>`, `/pets`, `/pet <index|name>`, `/cat on|off|color <hex>`, `/refresh [seconds|off]`, `/config`, `/version`, `/mcp on|off|status`, `/exit`
+`/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`.
 

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

@@ -1,7 +1,11 @@
 Metadata-Version: 2.4
 Name: asher-cli
-Version: 0.2.0
+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
@@ -66,8 +71,8 @@ A Claude Code-style terminal dashboard for monitoring and controlling Litter Rob
 - 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-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`
+- 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
@@ -135,6 +140,7 @@ 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) |
+| `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 |
@@ -161,9 +167,10 @@ 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 |
@@ -202,21 +209,47 @@ Exit codes for scripting:
 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`**
@@ -310,30 +343,8 @@ CI runs on Python 3.10 / 3.11 / 3.12 across Ubuntu, Windows, and macOS on every
 
 ## 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).
+The full, maintained release history lives in [CHANGELOG.md](CHANGELOG.md),
+auto-generated from conventional commits by [git-cliff](https://git-cliff.org).
 
 ## Notes
 

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

@@ -20,8 +20,8 @@ A Claude Code-style terminal dashboard for monitoring and controlling Litter Rob
 - 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-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`
+- 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
@@ -89,6 +89,7 @@ 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) |
+| `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 |
@@ -115,9 +116,10 @@ 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 |
@@ -156,21 +158,47 @@ Exit codes for scripting:
 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`**
@@ -264,30 +292,8 @@ CI runs on Python 3.10 / 3.11 / 3.12 across Ubuntu, Windows, and macOS on every
 
 ## 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).
+The full, maintained release history lives in [CHANGELOG.md](CHANGELOG.md),
+auto-generated from conventional commits by [git-cliff](https://git-cliff.org).
 
 ## Notes
 

{asher_cli-0.2.0 → asher_cli-1.0.0}/asher/app.py

@@ -47,11 +47,16 @@ class AsherApp(UIMixin, ConnectionMixin, MonitoringMixin, CommandsMixin, App):
         self._last_cat_seen: Any = None
         self._is_loading: bool = True
         self._spinner_idx: int = 0
-        self._poll_interval: int = 300
+        from .config import load as _load_config  # noqa: PLC0415
+
+        _cfg = _load_config()
+        self._poll_interval: int = _cfg["poll_interval_seconds"]
         self._poll_timer: Timer | None = None
-        self._cat_panel_visible: bool = True
-        self._cat_color: str | None = None
-        self._active_pet_idx: int = 0
+        self._cat_panel_visible: bool = _cfg["cat_panel_visible"]
+        self._cat_color: str | None = _cfg["cat_panel_color"]
+        self._active_pet_idx: int = _cfg["active_pet_index"]
+        self._notifications_enabled: bool = _cfg["notifications"]
+        self._notification_sound: bool = _cfg["notification_sound"]
         self._prev_faults: set[str] = set()
         self._fault_dismissed: set[str] = set()
         self._cycle_start: Any = None
@@ -63,8 +68,12 @@ class AsherApp(UIMixin, ConnectionMixin, MonitoringMixin, CommandsMixin, App):
         self._refresh_title()
         self._show_welcome()
         self._show_loading_state()
+        self.query_one("#cat-panel").display = self._cat_panel_visible
         self._connect_worker()
-        self._poll_timer = self.set_interval(300, self._poll_status_interval)
+        if self._poll_interval > 0:
+            self._poll_timer = self.set_interval(self._poll_interval, self._poll_status_interval)
+        else:
+            self._poll_timer = None
         self.set_interval(0.4, self._tick_cat)
         self.query_one("#cmd-input", Input).focus()