grounder 0.0.1 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Grounder contributors
+
+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

@@ -1,3 +1,170 @@
-# grounder
+# Grounder
 
-Setting up Git connections for Obsidian vaults to play nice with AI agents.
+Connect project folders to a personal Obsidian vault so AI agents (Cursor, Claude Code, etc.) get persistent memory without committing personal docs to the repo.
+
+**Requirements:** Node.js 18+ and an Obsidian vault on disk. Git is optional but used when present (project id detection and link lookup bounds).
+
+## Install
+
+```bash
+npm install -g grounder
+```
+
+Or run without installing:
+
+```bash
+npx grounder --help
+```
+
+## Quickstart
+
+```bash
+# Once per machine — set vault location + install agent slash commands
+grounder vault init ~/Documents/obsidian/dev
+
+# Once per folder — link project id to vault notes/ + logs/
+cd your-project
+grounder init
+
+# Write a note (or use /grounder-note in Cursor / Claude Code)
+grounder note "Investigate auth middleware"
+
+# End a session with a structured handoff (or use /grounder-task-handoff)
+grounder handoff "$(cat <<'EOF'
+# Handoff: auth middleware
+
+## Done
+- Mapped middleware order
+
+## Next
+1. Add tests for 401 path
+
+## Blockers
+- None
+
+## Decisions
+- Keep cookie session for now
+
+## Files
+- src/middleware/auth.ts
+EOF
+)"
+
+# Next session — hydrate from newest handoff (or use /grounder-task)
+grounder handoff list
+```
+
+Notes land in `<vault>/10-Projects/{projectId}/notes/`.  
+Handoffs land in `<vault>/10-Projects/{projectId}/logs/` (one file per close; newest wins).
+
+### Session loop
+
+```text
+/grounder-task → work → /grounder-task-handoff → next /grounder-task
+```
+
+| Slash command | CLI | Role |
+| --- | --- | --- |
+| `/grounder-note` | `grounder note` | Ad-hoc vault note |
+| `/grounder-task-handoff` | `grounder handoff` | Write session checkpoint to `logs/` |
+| `/grounder-task` | `grounder handoff list` + read newest | Read-only hydrate from newest handoff + `AGENTS.md` |
+
+## Setup overview
+
+Three steps — vault once per machine, then link each project folder:
+
+1. **`grounder vault init <path>`** (once per machine)
+   - Writes `~/.grounder/config.json` with the vault root
+   - Creates `<vault>/10-Projects/` if missing
+   - Installs agent slash commands for detected agents (or `--agent=<id>`):
+     - Cursor → `~/.cursor/commands/grounder-{note,task,task-handoff}.md`
+     - Claude Code → `~/.claude/commands/grounder-{note,task,task-handoff}.md`
+
+2. **`grounder init`** (once per project folder)
+   - Writes `.grounder.json` in the current directory (`projectId` — safe to commit)
+   - Creates `<vault>/10-Projects/{projectId}/notes/` and `logs/`
+
+3. **Daily use** — notes, handoffs, and recall via CLI or slash commands; no further install.
+
+Nothing is written into the repo except the small `.grounder.json` marker. Agent artifacts stay under the user’s home directory; vault notes stay outside the project tree.
+
+## Commands
+
+```text
+grounder vault init <path>   Initialize vault + home config (once per machine)
+grounder init                Connect the current folder to your vault
+grounder note <text>         Write a note to the vault
+grounder handoff <text>      Write a session handoff to vault logs/
+grounder handoff list        Print recent handoff paths (newest first)
+grounder path notes          Print resolved notes directory
+grounder path logs           Print resolved logs directory
+```
+
+### Init flags
+
+| Flag | Commands | Description |
+| --- | --- | --- |
+| `--yes` | `vault init`, `init` | Skip confirmation prompts |
+| `--force` | `vault init`, `init` | Overwrite existing generated files |
+| `--id <id>` | `init` | Override detected project id |
+| `--vault <path>` | `init` | Override home vault root for this run |
+| `--agent <id>` | `vault init` | Install for a specific agent (repeatable; default: auto-detect). Supported: `cursor`, `claude` |
+
+### Note / handoff flags
+
+| Flag | Commands | Description |
+| --- | --- | --- |
+| `--title <slug>` | `note`, `handoff` | Filename slug (default: slugified text / first line) |
+| `--limit <n>` | `handoff list` | Max paths to print (default: 5) |
+
+Run `grounder --help` for the full reference.
+
+## Configuration
+
+**Machine config** — `~/.grounder/config.json`:
+
+```json
+{ "vaultRoot": "/path/to/your/vault" }
+```
+
+Written by `grounder vault init`. Holds the vault path for this machine only.
+
+**Link marker** — `.grounder.json` in the folder where you run `grounder init` (safe to commit):
+
+```json
+{ "version": 1, "projectId": "your-project" }
+```
+
+Written by `grounder init` in the **current working directory**. Project id detection (when `--id` is omitted): `package.json` name in that folder → git `origin` remote (if inside a git repo) → folder basename.
+
+`grounder note`, `grounder handoff`, and `grounder path *` walk up from the current directory to find the nearest `.grounder.json`, stopping at the git root when one exists (or at the filesystem root otherwise).
+
+**Environment variables**
+
+| Variable | Description |
+| --- | --- |
+| `GROUNDER_VAULT` | Override vault root for the current session |
+| `GROUNDER_HOME` | Override home directory (default: `~`) for config resolution |
+
+## Agents
+
+The vault layout is agent-agnostic. `grounder vault init` installs thin glue artifacts per detected agent via a pluggable adapter registry (`src/agents/`).
+
+| Agent | Detection | Artifacts |
+| --- | --- | --- |
+| Cursor | `~/.cursor` exists | `~/.cursor/commands/grounder-{note,task,task-handoff}.md` |
+| Claude Code | `~/.claude` exists | `~/.claude/commands/grounder-{note,task,task-handoff}.md` |
+
+No `--agent` flag: auto-detect installed agents. Explicit install:
+
+```bash
+grounder vault init ~/Documents/obsidian/dev --agent=cursor --agent=claude
+```
+
+Slash commands tell the agent to run `npx grounder …` from the linked project folder (no global install required). Re-run with `--force` to refresh existing installs.
+
+Templates live under `templates/agents/{id}/`. Adding another agent means one adapter file + one template directory — `vault init` stays agent-blind.
+
+## Development
+
+Source, tests, and contribution workflow live in the [Grounder monorepo](https://github.com/andrej-kolic/grounder).

package/dist/agents/claude.d.ts

@@ -0,0 +1,7 @@
+import type { AgentAdapter } from "./types.js";
+export declare function claudeCommandsDir(homeDir?: string): string;
+export declare function grounderNoteCommandPath(homeDir?: string): string;
+export declare function grounderTaskHandoffCommandPath(homeDir?: string): string;
+export declare function grounderTaskCommandPath(homeDir?: string): string;
+export declare const claude: AgentAdapter;
+//# sourceMappingURL=claude.d.ts.map

package/dist/agents/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/agents/claude.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AAOpB,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,8BAA8B,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAkBD,eAAO,MAAM,MAAM,EAAE,YAgBpB,CAAC"}

package/dist/agents/claude.js

@@ -0,0 +1,46 @@
+import { copyFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveHomeDir } from "../connector/home.js";
+import { fileExists } from "../util/fs.js";
+const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const templateDir = path.join(pkgRoot, "templates", "agents", "claude", "commands");
+const COMMANDS = ["grounder-note.md", "grounder-task-handoff.md", "grounder-task.md"];
+export function claudeCommandsDir(homeDir) {
+    return path.join(resolveHomeDir(homeDir), ".claude", "commands");
+}
+export function grounderNoteCommandPath(homeDir) {
+    return path.join(claudeCommandsDir(homeDir), "grounder-note.md");
+}
+export function grounderTaskHandoffCommandPath(homeDir) {
+    return path.join(claudeCommandsDir(homeDir), "grounder-task-handoff.md");
+}
+export function grounderTaskCommandPath(homeDir) {
+    return path.join(claudeCommandsDir(homeDir), "grounder-task.md");
+}
+async function installCommand(filename, opts) {
+    const dest = path.join(claudeCommandsDir(opts.homeDir), filename);
+    const existed = await fileExists(dest);
+    if (existed && !opts.force) {
+        return { dest, status: "skipped" };
+    }
+    await mkdir(path.dirname(dest), { recursive: true });
+    await copyFile(path.join(templateDir, filename), dest);
+    return { dest, status: existed ? "overwritten" : "created" };
+}
+export const claude = {
+    id: "claude",
+    name: "Claude Code",
+    async isInstalled() {
+        return fileExists(path.join(resolveHomeDir(), ".claude"));
+    },
+    async install(opts) {
+        const artifacts = {};
+        for (const filename of COMMANDS) {
+            const { dest, status } = await installCommand(filename, opts);
+            artifacts[dest] = status;
+        }
+        return { artifacts };
+    },
+};
+//# sourceMappingURL=claude.js.map

package/dist/agents/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/agents/claude.ts"],"names":[],"mappings":"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"}

package/dist/agents/cursor.d.ts

@@ -0,0 +1,7 @@
+import type { AgentAdapter } from "./types.js";
+export declare function cursorCommandsDir(homeDir?: string): string;
+export declare function grounderNoteCommandPath(homeDir?: string): string;
+export declare function grounderTaskHandoffCommandPath(homeDir?: string): string;
+export declare function grounderTaskCommandPath(homeDir?: string): string;
+export declare const cursor: AgentAdapter;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/agents/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/agents/cursor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AAOpB,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,8BAA8B,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAkBD,eAAO,MAAM,MAAM,EAAE,YAgBpB,CAAC"}

package/dist/agents/cursor.js

@@ -0,0 +1,46 @@
+import { copyFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveHomeDir } from "../connector/home.js";
+import { fileExists } from "../util/fs.js";
+const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const templateDir = path.join(pkgRoot, "templates", "agents", "cursor", "commands");
+const COMMANDS = ["grounder-note.md", "grounder-task-handoff.md", "grounder-task.md"];
+export function cursorCommandsDir(homeDir) {
+    return path.join(resolveHomeDir(homeDir), ".cursor", "commands");
+}
+export function grounderNoteCommandPath(homeDir) {
+    return path.join(cursorCommandsDir(homeDir), "grounder-note.md");
+}
+export function grounderTaskHandoffCommandPath(homeDir) {
+    return path.join(cursorCommandsDir(homeDir), "grounder-task-handoff.md");
+}
+export function grounderTaskCommandPath(homeDir) {
+    return path.join(cursorCommandsDir(homeDir), "grounder-task.md");
+}
+async function installCommand(filename, opts) {
+    const dest = path.join(cursorCommandsDir(opts.homeDir), filename);
+    const existed = await fileExists(dest);
+    if (existed && !opts.force) {
+        return { dest, status: "skipped" };
+    }
+    await mkdir(path.dirname(dest), { recursive: true });
+    await copyFile(path.join(templateDir, filename), dest);
+    return { dest, status: existed ? "overwritten" : "created" };
+}
+export const cursor = {
+    id: "cursor",
+    name: "Cursor",
+    async isInstalled() {
+        return fileExists(path.join(resolveHomeDir(), ".cursor"));
+    },
+    async install(opts) {
+        const artifacts = {};
+        for (const filename of COMMANDS) {
+            const { dest, status } = await installCommand(filename, opts);
+            artifacts[dest] = status;
+        }
+        return { artifacts };
+    },
+};
+//# sourceMappingURL=cursor.js.map

package/dist/agents/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/agents/cursor.ts"],"names":[],"mappings":"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"}

package/dist/agents/index.d.ts

@@ -0,0 +1,11 @@
+import type { AgentAdapter } from "./types.js";
+export { claude } from "./claude.js";
+export { cursor } from "./cursor.js";
+export type { AgentAdapter, AgentInstallOptions, AgentInstallResult, ArtifactStatus, } from "./types.js";
+/**
+ * Resolve which adapters to run:
+ *  - If `ids` is provided, return those adapters (throws on unknown id).
+ *  - Otherwise, auto-detect by checking isInstalled() for each adapter.
+ */
+export declare function resolveAgents(ids?: string[]): Promise<AgentAdapter[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAC;AAIpB;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAc3E"}

package/dist/agents/index.js

@@ -0,0 +1,23 @@
+import { claude } from "./claude.js";
+import { cursor } from "./cursor.js";
+export { claude } from "./claude.js";
+export { cursor } from "./cursor.js";
+const ALL_ADAPTERS = [cursor, claude];
+/**
+ * Resolve which adapters to run:
+ *  - If `ids` is provided, return those adapters (throws on unknown id).
+ *  - Otherwise, auto-detect by checking isInstalled() for each adapter.
+ */
+export async function resolveAgents(ids) {
+    if (ids && ids.length > 0) {
+        const found = ALL_ADAPTERS.filter((a) => ids.includes(a.id));
+        const unknown = ids.filter((id) => !ALL_ADAPTERS.some((a) => a.id === id));
+        if (unknown.length > 0) {
+            throw new Error(`Unknown agent id(s): ${unknown.join(", ")}`);
+        }
+        return found;
+    }
+    const results = await Promise.all(ALL_ADAPTERS.map(async (a) => ({ adapter: a, ok: await a.isInstalled() })));
+    return results.filter((r) => r.ok).map((r) => r.adapter);
+}
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAQrC,MAAM,YAAY,GAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAc;IAChD,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAC3E,CAAC;IACF,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAC3D,CAAC"}

package/dist/agents/types.d.ts

@@ -0,0 +1,20 @@
+export type ArtifactStatus = "created" | "skipped" | "overwritten";
+export interface AgentInstallOptions {
+    force?: boolean;
+    homeDir?: string;
+}
+export interface AgentInstallResult {
+    /** Map of installed file path → what happened to it. */
+    artifacts: Record<string, ArtifactStatus>;
+}
+export interface AgentAdapter {
+    /** Stable lowercase id used in config and flags, e.g. "cursor". */
+    readonly id: string;
+    /** Human-readable display name, e.g. "Cursor". */
+    readonly name: string;
+    /** Returns true when this agent appears to be installed on the machine. */
+    isInstalled(): Promise<boolean>;
+    /** Install all agent-specific artifacts (commands, rules, etc.). */
+    install(opts: AgentInstallOptions): Promise<AgentInstallResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,oEAAoE;IACpE,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACjE"}

package/dist/agents/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":""}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { runHandoffList } from "./commands/handoff/list.js";
+import { runHandoff } from "./commands/handoff.js";
+import { runNote } from "./commands/note.js";
+import { runPathLogs } from "./commands/path/logs.js";
+import { runPathNotes } from "./commands/path/notes.js";
+import { runRepoInit } from "./commands/repo/init.js";
+import { runVaultInit } from "./commands/vault/init.js";
+const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const pkg = JSON.parse(readFileSync(path.join(pkgRoot, "package.json"), "utf8"));
+const USAGE = `grounder — connect git projects to Obsidian dev vaults for AI agents
+
+Usage:
+  grounder vault init <path>   Initialize vault + home config (once per machine)
+  grounder init                Connect the current repo to your vault
+  grounder note <text>         Write a note to the vault
+  grounder handoff <text>      Write a session handoff to vault logs/
+  grounder handoff list        Print recent handoff paths (newest first)
+  grounder path notes          Print resolved notes directory
+  grounder path logs           Print resolved logs directory
+
+Options:
+  -h, --help     Show this help
+  -v, --version  Show version
+
+Init flags:
+  --yes          Skip confirmation prompts
+  --force        Overwrite existing generated files
+  --id <id>      Override detected project id (grounder init)
+  --vault <path> Override home vault root for this run (grounder init)
+  --agent <id>   Install for a specific agent (repeatable; default: auto-detect)
+                 Supported: cursor, claude
+
+Note / handoff flags:
+  --title <slug> Short slug in filename (default: slugified first line)
+  --limit <n>    Max paths for handoff list (default: 5)
+
+Quickstart:
+  grounder vault init ~/Documents/obsidian/dev
+  grounder init
+  grounder note "my first note"
+  grounder handoff "# Handoff\\n\\n## Next\\n1. …"
+  grounder handoff list
+`;
+function printHelp() {
+    process.stdout.write(USAGE);
+}
+function printVersion() {
+    process.stdout.write(`${pkg.version}\n`);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args[0] === "-h" || args[0] === "--help") {
+        printHelp();
+        process.exit(0);
+    }
+    if (args[0] === "-v" || args[0] === "--version") {
+        printVersion();
+        return;
+    }
+    const [command, ...rest] = args;
+    if (command === "vault" && rest[0] === "init") {
+        process.exit(await runVaultInit(rest.slice(1)));
+    }
+    if (command === "init") {
+        process.exit(await runRepoInit(rest));
+    }
+    if (command === "note") {
+        process.exit(await runNote(rest));
+    }
+    if (command === "handoff" && rest[0] === "list") {
+        process.exit(await runHandoffList(rest.slice(1)));
+    }
+    if (command === "handoff") {
+        process.exit(await runHandoff(rest));
+    }
+    if (command === "path" && rest[0] === "notes") {
+        process.exit(await runPathNotes(rest.slice(1)));
+    }
+    if (command === "path" && rest[0] === "logs") {
+        process.exit(await runPathLogs(rest.slice(1)));
+    }
+    process.stderr.write(`Unknown command: ${args.join(" ")}\n\n`);
+    printHelp();
+    process.exit(1);
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/handoff/list.d.ts

@@ -0,0 +1,23 @@
+/** Options for {@link runHandoffListWithOptions} (CLI parsing and tests). */
+export interface HandoffListOptions {
+    /** Directory used to find the linked repo (default: `process.cwd()`). */
+    cwd?: string;
+    /** Max paths to print, newest first (default: 5). */
+    limit?: number;
+    /** Override home dir / `GROUNDER_HOME` (tests). */
+    homeDir?: string;
+}
+/**
+ * CLI entry for `grounder handoff list [--limit <n>]`.
+ * `--limit` must be a positive integer when provided.
+ * @returns Exit code (`0` on success, `1` on usage or config errors).
+ */
+export declare function runHandoffList(argv: string[]): Promise<number>;
+/**
+ * Resolves the linked project, lists recent handoff paths under `logs/` (newest first).
+ * Prints one absolute path per line; empty when no handoffs. Same vault/link
+ * prerequisites as `grounder handoff`.
+ * @returns Exit code (`0` on success, `1` when vault/link is missing).
+ */
+export declare function runHandoffListWithOptions(options?: HandoffListOptions): Promise<number>;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/handoff/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/handoff/list.ts"],"names":[],"mappings":"AAQA,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AASD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BpE;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBjG"}

package/dist/commands/handoff/list.js

@@ -0,0 +1,64 @@
+import { withHomeDir } from "../../connector/home.js";
+import { resolveLogsDir } from "../../connector/vault.js";
+import { parseArgs } from "../../util/parse-args.js";
+import { listHandoffs } from "../../vault/list-handoffs.js";
+import { requireLinkedProject } from "../require-linked.js";
+const DEFAULT_LIMIT = 5;
+const USAGE = "Usage: grounder handoff list [--limit <n>]\n";
+function usageError() {
+    process.stderr.write(USAGE);
+    return 1;
+}
+/**
+ * CLI entry for `grounder handoff list [--limit <n>]`.
+ * `--limit` must be a positive integer when provided.
+ * @returns Exit code (`0` on success, `1` on usage or config errors).
+ */
+export async function runHandoffList(argv) {
+    const { positional, flags } = parseArgs(argv);
+    if (positional.length > 0) {
+        return usageError();
+    }
+    for (const key of flags.keys()) {
+        if (key !== "limit") {
+            return usageError();
+        }
+    }
+    const limitRaw = flags.get("limit");
+    let limit = DEFAULT_LIMIT;
+    if (limitRaw !== undefined) {
+        if (typeof limitRaw !== "string") {
+            return usageError();
+        }
+        const trimmed = limitRaw.trim();
+        const parsed = Number.parseInt(trimmed, 10);
+        if (!/^\d+$/.test(trimmed) || Number.isNaN(parsed) || parsed < 1) {
+            return usageError();
+        }
+        limit = parsed;
+    }
+    return runHandoffListWithOptions({ limit });
+}
+/**
+ * Resolves the linked project, lists recent handoff paths under `logs/` (newest first).
+ * Prints one absolute path per line; empty when no handoffs. Same vault/link
+ * prerequisites as `grounder handoff`.
+ * @returns Exit code (`0` on success, `1` when vault/link is missing).
+ */
+export async function runHandoffListWithOptions(options = {}) {
+    return withHomeDir(options.homeDir, async () => {
+        const linked = await requireLinkedProject(options.cwd ?? process.cwd());
+        if (!linked) {
+            return 1;
+        }
+        const logsDir = resolveLogsDir(linked.home, linked.repo);
+        const paths = await listHandoffs(logsDir, {
+            limit: options.limit ?? DEFAULT_LIMIT,
+        });
+        for (const filePath of paths) {
+            process.stdout.write(`${filePath}\n`);
+        }
+        return 0;
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/handoff/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/handoff/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,aAAa,GAAG,CAAC,CAAC;AAYxB,MAAM,KAAK,GAAG,8CAA8C,CAAC;AAE7D,SAAS,UAAU;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc;IACjD,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/B,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,OAAO,UAAU,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,KAAK,GAAG,aAAa,CAAC;IAC1B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,UAAU,EAAE,CAAC;QACtB,CAAC;QACD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACjE,OAAO,UAAU,EAAE,CAAC;QACtB,CAAC;QACD,KAAK,GAAG,MAAM,CAAC;IACjB,CAAC;IAED,OAAO,yBAAyB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,UAA8B,EAAE;IAC9E,OAAO,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE;YACxC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,aAAa;SACtC,CAAC,CAAC;QAEH,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/handoff.d.ts

@@ -0,0 +1,25 @@
+/** Options for {@link runHandoffWithOptions} (CLI parsing and tests). */
+export interface HandoffOptions {
+    /** Directory used to find the linked repo (default: `process.cwd()`). */
+    cwd?: string;
+    /** Markdown body stored under the project `logs/` folder. */
+    text: string;
+    /** Optional filename + frontmatter title slug (`--title`). */
+    title?: string;
+    /** Override home dir / `GROUNDER_HOME` (tests). */
+    homeDir?: string;
+    /** Fixed clock for deterministic filenames and `created` (tests). */
+    now?: Date;
+}
+/**
+ * CLI entry for `grounder handoff <text> [--title <slug>]`.
+ * @returns Exit code (`0` on success, `1` on usage or config errors).
+ */
+export declare function runHandoff(argv: string[]): Promise<number>;
+/**
+ * Resolves the linked project, writes a new handoff under `logs/`, prints `Wrote <path>`.
+ * Same vault/link prerequisites as `grounder note`.
+ * @returns Exit code (`0` on success, `1` when vault/link is missing).
+ */
+export declare function runHandoffWithOptions(options: HandoffOptions): Promise<number>;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/commands/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/commands/handoff.ts"],"names":[],"mappings":"AAOA,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAahE;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBpF"}