incremnt 0.1.13 → 0.1.16

package/README.md

@@ -2,13 +2,15 @@
 
 Command-line tool and MCP server for querying your [incremnt](https://incremnt.app) strength training data.
 
-## Install
+## Setup
 
 ```bash
 npm install -g incremnt
+incremnt login
+incremnt mcp install   # registers with Claude Desktop and Claude Code
 ```
 
-This gives you two commands: `incremnt` (CLI) and `incremnt-mcp` (MCP server).
+This gives you two commands: `incremnt` (CLI) and `incremnt-mcp` (MCP server). The `mcp install` step auto-registers the MCP server — restart Claude for it to take effect.
 
 ## CLI
 
@@ -44,6 +46,8 @@ If `--input` is omitted, the CLI checks `INCREMNT_SNAPSHOT`, then `ONEMORE_SNAPS
 | `sessions show --id <id>` | Details for a single session |
 | `programs current` | Active program state |
 | `programs list` | All programs |
+| `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) |
 | `login` | Authenticate with the hosted sync service |
@@ -58,6 +62,7 @@ If `--input` is omitted, the CLI checks `INCREMNT_SNAPSHOT`, then `ONEMORE_SNAPS
 | `--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`) |
+| `--program-id <id>` | Filter cycle summaries to a program |
 
 ### Exercise matching
 
@@ -65,26 +70,23 @@ If `--input` is omitted, the CLI checks `INCREMNT_SNAPSHOT`, then `ONEMORE_SNAPS
 
 ## MCP Server
 
-The package includes an [MCP](https://modelcontextprotocol.io) server that exposes the same queries as tools for AI assistants like Claude.
+The package includes an [MCP](https://modelcontextprotocol.io) server that exposes the same read queries and program proposal commands as tools for AI assistants like Claude.
 
-### Setup
+Run `incremnt mcp install` to auto-register the server with Claude Desktop and Claude Code (see [Setup](#setup) above).
 
-Add to your Claude Code project config (`.mcp.json`):
+To register manually instead, add to your Claude Code project config (`.mcp.json`):
 
 ```json
 {
   "mcpServers": {
     "incremnt": {
       "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "incremnt-mcp"]
+      "command": "incremnt-mcp"
     }
   }
 }
 ```
 
-Or run directly: `npx incremnt-mcp`
-
 The MCP server uses the same auth session as the CLI — run `incremnt login` first.
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "incremnt",
-  "version": "0.1.13",
+  "version": "0.1.16",
   "description": "Command-line tool for querying your incremnt strength training data",
   "license": "MIT",
   "type": "module",
@@ -13,7 +13,8 @@
   ],
   "scripts": {
     "test": "node --test",
-    "dev:sync-fixture": "node ./scripts/dev-sync-fixture-server.js"
+    "dev:sync-fixture": "node ./scripts/dev-sync-fixture-server.js",
+    "postinstall": "node -e \"process.stdout.write('\\n  incremnt MCP server installed.\\n  Run: incremnt mcp install\\n  to register it with Claude.\\n\\n')\""
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",

package/src/contract.js

@@ -115,6 +115,31 @@ export const commandSchema = [
     options: [
       { name: 'id', type: 'string', required: true, description: 'Cycle summary ID' }
     ]
+  },
+  {
+    command: 'health summary',
+    id: 'health-summary',
+    description: 'Health metrics summary (resting HR, HRV, VO2 Max, sleep, cardio)',
+    options: [
+      { name: 'days', type: 'number', required: false, description: 'Last N days (default: 14)' }
+    ]
+  },
+  {
+    command: 'ask history',
+    id: 'ask-history',
+    description: 'List past AI coach conversations',
+    options: [
+      { name: 'limit', type: 'number', required: false, description: 'Max conversations to return (default: 20)' }
+    ]
+  },
+  {
+    command: 'ask show',
+    id: 'ask-show',
+    description: 'Show a full AI coach conversation',
+    usage: 'ask show --id <conversation-id>',
+    options: [
+      { name: 'id', type: 'string', required: true, description: 'Conversation ID' }
+    ]
   }
 ];
 

package/src/lib.js

@@ -1,5 +1,7 @@
 import fs from 'node:fs/promises';
-import { spawn } from 'node:child_process';
+import path from 'node:path';
+import os from 'node:os';
+import { spawn, execFileSync } from 'node:child_process';
 import { capabilities, commandSchema, contractVersion, officialCommands, proposalSchema, readCommands, writeCommands, writeCommandSchema } from './contract.js';
 import {
   bootstrapSessionFromRemoteBaseUrl,
@@ -139,6 +141,40 @@ export async function runCli(argv, stdout, stderr) {
     }
   }
 
+  if (normalizedCommand === 'mcp install') {
+    try {
+      const mcpBin = resolveMcpBin();
+      const installed = [];
+
+      // Claude Desktop
+      const desktopPath = claudeDesktopConfigPath();
+      let desktopConfig = {};
+      try {
+        desktopConfig = JSON.parse(await fs.readFile(desktopPath, 'utf8'));
+      } catch { /* file doesn't exist yet */ }
+      desktopConfig.mcpServers = { ...desktopConfig.mcpServers, incremnt: { command: mcpBin } };
+      await fs.mkdir(path.dirname(desktopPath), { recursive: true });
+      await fs.writeFile(desktopPath, JSON.stringify(desktopConfig, null, 2) + '\n');
+      installed.push(`  Claude Desktop: ${desktopPath}`);
+
+      // Claude Code CLI
+      const cliPath = path.join(os.homedir(), '.claude.json');
+      let cliConfig = {};
+      try {
+        cliConfig = JSON.parse(await fs.readFile(cliPath, 'utf8'));
+      } catch { /* file doesn't exist yet */ }
+      cliConfig.mcpServers = { ...cliConfig.mcpServers, incremnt: { type: 'stdio', command: mcpBin } };
+      await fs.writeFile(cliPath, JSON.stringify(cliConfig, null, 2) + '\n');
+      installed.push(`  Claude Code:    ${cliPath}`);
+
+      stdout.write(`Registered incremnt MCP server in:\n${installed.join('\n')}\n\nRestart Claude for the changes to take effect.\n`);
+      return 0;
+    } catch (error) {
+      stderr.write(`${error.message}\n`);
+      return 1;
+    }
+  }
+
   if (normalizedCommand === 'login') {
     if (options.snapshot) {
       try {
@@ -380,6 +416,26 @@ function browserCommandForPlatform() {
   return null;
 }
 
+function claudeDesktopConfigPath() {
+  if (process.platform === 'darwin') {
+    return path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+  }
+  if (process.platform === 'win32') {
+    return path.join(process.env.APPDATA ?? path.join(os.homedir(), 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+  }
+  return path.join(os.homedir(), '.config', 'Claude', 'claude_desktop_config.json');
+}
+
+function resolveMcpBin() {
+  try {
+    return execFileSync('which', ['incremnt-mcp'], { encoding: 'utf8' }).trim();
+  } catch {
+    // fall back to sibling binary next to the current incremnt binary
+    const dir = path.dirname(process.argv[1]);
+    return path.join(dir, 'incremnt-mcp');
+  }
+}
+
 function configuredAuthProviders(auth) {
   const providers = auth?.providers ?? {};
   const labels = [];

package/src/mcp.js

@@ -1,18 +1,15 @@
 #!/usr/bin/env node
 
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
-import { commandSchema } from './contract.js';
+import { commandSchema, writeCommands, writeCommandSchema } from './contract.js';
 import { readSessionState } from './state.js';
 import { createTransport } from './transport.js';
 
-const server = new McpServer({
-  name: 'incremnt',
-  version: '0.1.0'
-});
-
-for (const cmd of commandSchema) {
+function commandShape(cmd) {
   const shape = {};
 
   for (const opt of cmd.options) {
@@ -22,39 +19,69 @@ for (const cmd of commandSchema) {
     shape[opt.name] = field;
   }
 
-  server.tool(cmd.id, cmd.description, shape, async (args) => {
-    try {
-      const sessionState = await readSessionState();
-      const transport = await createTransport({}, sessionState);
+  return shape;
+}
+
+export function registerMcpTools(server, {
+  readSessionStateFn = readSessionState,
+  createTransportFn = createTransport
+} = {}) {
+  for (const cmd of [...commandSchema, ...writeCommandSchema]) {
+    server.tool(cmd.id, cmd.description, commandShape(cmd), async (args) => {
+      try {
+        const sessionState = await readSessionStateFn();
+        const transport = await createTransportFn({}, sessionState);
+
+        if (transport.expired) {
+          return {
+            content: [{ type: 'text', text: 'Session expired. Run `incremnt login` to re-authenticate.' }],
+            isError: true
+          };
+        }
+
+        const result = writeCommands.has(cmd.id)
+          ? await transport.executeWriteCommand(cmd.id, args)
+          : await transport.executeReadCommand(cmd.id, args);
 
-      if (transport.expired) {
         return {
-          content: [{ type: 'text', text: 'Session expired. Run `incremnt login` to re-authenticate.' }],
-          isError: true
+          content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
         };
-      }
+      } catch (error) {
+        const message = error?.message ?? String(error);
 
-      const result = await transport.executeReadCommand(cmd.id, args);
-      return {
-        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
-      };
-    } catch (error) {
-      const message = error?.message ?? String(error);
+        if (error?.code === 'SNAPSHOT_NOT_FOUND') {
+          return {
+            content: [{ type: 'text', text: 'Not logged in. Run `incremnt login` first.' }],
+            isError: true
+          };
+        }
 
-      if (error?.code === 'SNAPSHOT_NOT_FOUND') {
         return {
-          content: [{ type: 'text', text: 'Not logged in. Run `incremnt login` first.' }],
+          content: [{ type: 'text', text: message }],
           isError: true
         };
       }
+    });
+  }
+
+  return server;
+}
 
-      return {
-        content: [{ type: 'text', text: message }],
-        isError: true
-      };
-    }
+export function createMcpServer(deps) {
+  const server = new McpServer({
+    name: 'incremnt',
+    version: '0.1.0'
   });
+
+  return registerMcpTools(server, deps);
 }
 
-const transport = new StdioServerTransport();
-await server.connect(transport);
+async function main() {
+  const transport = new StdioServerTransport();
+  const server = createMcpServer();
+  await server.connect(transport);
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  await main();
+}