autonag 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andrew Morris
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,159 @@
+# autonag
+
+A recurring-task tracker with a persistent alarm. Timers count down; when one expires, the alarm rings on any device you have open to the alarm page. It doesn't stop until you mark the task done, snooze it, or silence it. Recurring tasks reschedule automatically.
+
+**[autonag.com](https://autonag.com)** — [hosted app](https://app2.autonag.com) — [self-host](https://github.com/voltrevo/autonag)
+
+## Install
+
+```bash
+npm install -g autonag
+```
+
+## First-time setup
+
+Point the CLI at your server and register this device:
+
+```bash
+autonag --server https://your-server.example register mydevice
+```
+
+Your token is saved to `~/.config/autonag/client.json5`. The device starts in PENDING state — an admin must approve it on the server before you can use it. Check your status:
+
+```bash
+autonag status
+```
+
+## Getting an instance
+
+Timers live in an *instance*. Create one:
+
+```bash
+autonag instances request home
+```
+
+Once approved, set it as your default:
+
+```bash
+autonag instances list
+autonag instances select <id>
+```
+
+To join an instance someone else owns, ask them to run `autonag instances invite`, then join with the code they share:
+
+```bash
+autonag instances join <code>
+```
+
+## Adding timers
+
+One-shot reminder due in 2 days:
+
+```bash
+autonag timers add "Doctor follow-up" 2d
+```
+
+Recurring task every 7 days at 9 AM:
+
+```bash
+autonag timers add "Weekly review" 7d --days 7 --anchor 09:00
+```
+
+The first argument is the initial expiry. `--days` makes it recurring; `--anchor` sets the time of day; `--tz` overrides the timezone.
+
+## Checking timers
+
+```bash
+autonag timers list
+```
+
+```
+ID          Name                      Remaining         Recur
+------------------------------------------------------------
+a1b2c3d4…   Doctor follow-up          in 1d 23h
+e5f6a7b8…   Weekly review             in 6d 23h         ↻
+```
+
+The ↻ symbol marks recurring timers.
+
+## Completing a timer
+
+```bash
+autonag timers complete e5f6 pass
+```
+
+For a recurring timer this schedules the next occurrence:
+
+```
+Timer "Weekly review" recurred — next: 4/24/2026, 9:00:00 AM
+```
+
+For a one-shot timer it removes it. Reason can be `pass`, `fail`, or any custom string.
+
+## Snoozing and silencing
+
+Push a timer's deadline out:
+
+```bash
+autonag timers snooze e5f6 3d
+```
+
+Silence the alarm temporarily (default 30 min):
+
+```bash
+autonag shush
+autonag shush 2h
+autonag unshush
+```
+
+## Notes and history
+
+Attach a description to a timer:
+
+```bash
+autonag timers describe e5f6 "Prep the agenda first"
+```
+
+Add timestamped comments:
+
+```bash
+autonag comments add e5f6 "Done, flagged for follow-up"
+```
+
+See completion history for a recurring timer:
+
+```bash
+autonag timers history e5f6
+```
+
+## Event log
+
+Every action is recorded and replayable:
+
+```bash
+autonag events list
+autonag events skip <event-id>   # undo: recompute state as if this event never happened
+```
+
+## SDK usage
+
+The package also exports a typed API client for use in scripts and agents:
+
+```typescript
+import { createApiClient } from "autonag";
+
+const api = createApiClient("https://your-server.example", token);
+
+const state = await api.getState(instanceId, token);
+const { timer } = await api.addTimer(instanceId, token, "Take medication", Date.now() + 8 * 3600_000);
+await api.completeTimer(instanceId, token, timer.id, "done");
+```
+
+All types (`Timer`, `InstanceState`, `StoredEvent`, etc.) are exported from the package root.
+
+## Full reference
+
+```bash
+autonag --help
+autonag tutorial
+```

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }