incremnt 0.1.18 → 0.2.0

package/README.md

@@ -2,6 +2,8 @@
 
 Command-line tool and MCP server for querying your [incremnt](https://incremnt.app) strength training data.
 
+Requires the [incremnt iOS app](https://www.incremnt.app/) — all workout data originates there.
+
 ## Setup
 
 ```bash
@@ -10,7 +12,11 @@ incremnt login
 incremnt mcp install   # registers with Claude Desktop, Claude Code, and Codex CLI
 ```
 
-This gives you two commands: `incremnt` (CLI) and `incremnt-mcp` (MCP server). The `mcp install` step auto-registers the MCP server with Claude Desktop, Claude Code, and Codex CLI — restart your AI assistant for it to take effect.
+This installs two binaries:
+- `incremnt` (CLI)
+- `incremnt-mcp` (MCP server over stdio)
+
+`incremnt mcp install` auto-registers the MCP server with Claude Desktop, Claude Code, and Codex CLI. Restart your assistant app after installing.
 
 ## CLI
 
@@ -22,21 +28,25 @@ After connecting with Apple in the iOS app (Settings > Cloud Sync), your workout
 incremnt login
 incremnt sessions list --limit 5
 incremnt records
-incremnt records --pretty
 incremnt programs current
 incremnt exercises history --name "Bench Press"
+incremnt browse
 ```
 
 ### Local snapshot
 
-If you prefer to work offline, export a snapshot from the app and point the CLI at it:
+If you prefer to work offline, import a snapshot into the local session:
 
 ```bash
-incremnt sessions list --input ~/Downloads/export.onemore.json --limit 5
-incremnt records --input ~/Downloads/export.onemore.json --pretty
+incremnt login --snapshot ~/Downloads/export.onemore.json
+incremnt sessions list --limit 5
 ```
 
-If `--input` is omitted, the CLI checks `INCREMNT_SNAPSHOT`, then `ONEMORE_SNAPSHOT`, then common local paths, then the most recent `.onemore.json` in `~/Downloads`.
+Or import a session file:
+
+```bash
+incremnt login --session-file ~/Downloads/session.json
+```
 
 ### Commands
 
@@ -44,12 +54,25 @@ If `--input` is omitted, the CLI checks `INCREMNT_SNAPSHOT`, then `ONEMORE_SNAPS
 |---------|-------------|
 | `sessions list` | Recent sessions with duration and exercise count |
 | `sessions show --id <id>` | Details for a single session |
+| `sessions compare --session-id <id>` | Compare planned vs actual |
+| `sessions explain --session-id <id>` | Explain session context |
 | `programs current` | Active program state |
 | `programs list` | All programs |
+| `programs show --id <id>` | Full program detail |
 | `cycles list [--program-id <id>]` | Completed cycle summaries |
 | `cycles show --id <id>` | Details for a completed cycle summary |
 | `exercises history --name <name>` | Set-by-set history for an exercise |
 | `records` | Personal records (best e1RM per exercise) |
+| `goals list` / `goals show --id <id>` | Strength plan goals |
+| `health summary` / `health ai` | Health metrics and AI summary |
+| `training load` | ATL/CTL/TSB and workload context |
+| `ask history` / `ask show --id <id>` | Coach conversation history |
+| `programs propose --file <file>` | Submit a program proposal |
+| `programs proposals` | List proposals |
+| `programs proposal dismiss --id <id>` | Dismiss a proposal |
+| `browse` | Interactive Ink browser for sessions, programs, records, goals, cycles, and health |
+| `tui` | Alias for `browse` |
+| `mcp install` | Register `incremnt-mcp` with Claude Desktop, Claude Code, and Codex CLI |
 | `login` | Authenticate with the hosted sync service |
 | `logout` | Clear stored session |
 | `status` | Show current mode, auth state, and config paths |
@@ -59,10 +82,31 @@ If `--input` is omitted, the CLI checks `INCREMNT_SNAPSHOT`, then `ONEMORE_SNAPS
 
 | Flag | Description |
 |------|-------------|
-| `--pretty` | Human-readable formatted output (default is JSON) |
-| `--input <path>` | Path to a local `.onemore.json` snapshot |
-| `--limit <n>` | Limit number of results (for `sessions list`) |
+| `--json` | Force JSON output for command responses |
+| `--limit <n>` | Limit number of results (`sessions list`, `ask history`) |
+| `--days <n>` | Day window (`health summary`) |
 | `--program-id <id>` | Filter cycle summaries to a program |
+| `--base-url <url>` | Override remote sync service URL for login/bootstrap |
+| `--snapshot <file>` | Bootstrap login from a local snapshot |
+| `--session-file <file>` | Import an existing session file |
+| `--token <token>` / `--email <email>` | Non-interactive bootstrap login options |
+
+### Browse mode key bindings
+
+`incremnt browse` (or `incremnt tui`) launches an interactive TUI.
+
+- `Tab` / `Shift+Tab`: cycle pane focus (`sections` → `items` → `detail`)
+- `1` / `2` / `3`: jump focus directly to `sections` / `items` / `detail`
+- `h/l` or `←/→`: move pane focus
+- `j/k` or `↑/↓`: navigate rows in focused list pane
+- `/`: enter search mode for current list pane
+- `Esc`: exit search or move focus back
+- `Ctrl-U`: clear search query (in search mode)
+- `Ctrl-L`: clear query and exit search mode
+- `Enter`: open/select in focused pane
+- `PgUp/PgDn`, `g/G`, `Home/End`: list navigation shortcuts
+- `r`: refresh detail for selected item
+- `q` or `Ctrl-C`: quit
 
 ### Exercise matching
 
@@ -89,6 +133,16 @@ To register manually instead, add to your Claude Code project config (`.mcp.json
 
 The MCP server uses the same auth session as the CLI — run `incremnt login` first.
 
+### MCP tool surface
+
+The MCP server exposes the same read/write contract as the CLI command surface, including sessions, programs, cycles, goals, health, training load, ask history/show, and program proposal workflows.
+
+You can inspect the exact machine-readable contract at any time:
+
+```bash
+incremnt contract
+```
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "incremnt",
-  "version": "0.1.18",
+  "version": "0.2.0",
   "description": "Command-line tool for querying your incremnt strength training data",
   "license": "MIT",
   "type": "module",
@@ -19,6 +19,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
     "chalk": "^5.6.2",
+    "ink": "^5.2.1",
+    "react": "^18.3.1",
     "zod": "^3.24.0"
   }
 }