@heyditto/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ditto AI
+
+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,136 @@
+# Ditto CLI
+
+`@heyditto/cli` — save, search, fetch, and traverse the [Ditto](https://heyditto.ai) memory graph from the shell.
+
+```bash
+npm install -g @heyditto/cli
+export DITTO_API_KEY=ditto_mcp_…   # https://app.heyditto.ai/mcp/newkey
+
+ditto save "I prefer TypeScript over JS for new projects"
+ditto search "language preferences"
+ditto subjects "memory architecture" --top-k 5
+```
+
+## Install
+
+```bash
+npm install -g @heyditto/cli
+# or one-shot via npx
+npx -y @heyditto/cli search "what did I say about X"
+```
+
+## Auth
+
+Set `DITTO_API_KEY` in your environment. Get a key at **https://app.heyditto.ai/mcp/newkey**.
+
+```bash
+export DITTO_API_KEY=ditto_mcp_…
+# add to ~/.zshrc / ~/.bashrc to persist
+```
+
+## Commands
+
+```
+ditto save <content> [--source <s>] [--source-context <c>]
+ditto search <query>...
+ditto fetch <pair-id>...
+ditto subjects <query> [--top-k <n>]
+ditto memories <subject-id>...
+ditto network <pair-id> [--limit <n>]
+ditto status
+ditto config
+ditto help
+```
+
+### `save`
+
+Persist a memory pair from an external source.
+
+```bash
+ditto save "Project X uses Bun + SolidJS, deployed to Cloud Run"
+ditto save "$(cat note.md)" --source document --source-context note.md
+```
+
+### `search`
+
+Semantic search across memories. Multiple positional args become an array of queries.
+
+```bash
+ditto search "typescript preferences"
+ditto search "typescript" "language choices"
+```
+
+### `fetch`
+
+Fetch the full conversation text for memory pair ids (output of `search`).
+
+```bash
+ditto fetch 3a1084ae-235a-433d-9493-2335a0dfeb57
+```
+
+### `subjects`
+
+Search the subject (topic) graph. Returns subject ids you can pass to `memories` or `network`.
+
+```bash
+ditto subjects "memory architecture"
+ditto subjects "performance" --top-k 5
+```
+
+### `memories`
+
+Fetch memory previews scoped to specific subjects.
+
+```bash
+ditto memories <subject-id>
+```
+
+### `network`
+
+Traverse a memory's network (related memories via shared subjects).
+
+```bash
+ditto network <pair-id> --limit 30
+```
+
+### `status`
+
+Print whether `DITTO_API_KEY` is set and the configured MCP endpoint resolves.
+
+### `config`
+
+Print a Claude Desktop / Cursor / generic-MCP-client config snippet for the Ditto memory server.
+
+## Environment
+
+- `DITTO_API_KEY` (required) — MCP API key. https://app.heyditto.ai/mcp/newkey
+- `DITTO_API_BASE` (optional) — API base URL. Defaults to `https://api.heyditto.ai`. Useful for local dev (`http://localhost:3400`).
+
+## Output
+
+Defaults to JSON. Pipe through `jq` for filtering:
+
+```bash
+ditto search "X" | jq '.results[] | {id, similarity, preview: .userPreview}'
+```
+
+## Related
+
+- **[`@heyditto/mcp`](https://github.com/ditto-assistant/ditto-mcp)** — local stdio MCP bridge with OAuth (different surface; pair with Claude Desktop / Cursor).
+- **[ditto-clawhub](https://github.com/ditto-assistant/ditto-clawhub)** — the ClawHub / OpenClaw skill that ships alongside this CLI.
+- **Web app:** https://app.heyditto.ai
+
+## Development
+
+```bash
+just install
+just check       # tsc --noEmit
+just build       # tsc to dist/
+just verify      # check + build + pack --dry-run
+```
+
+Releases are automated via [semantic-release](https://github.com/semantic-release/semantic-release) on push to `main`. npm provenance is enabled — every published version is signed by the GitHub Actions OIDC identity. Trusted publishing is configured at the npm registry.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,234 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { apiBaseURL, apiKey, mcpServerURL, newKeyURL, packageName, packageVersion, } from "./config.js";
+function usage() {
+    return `${packageName} ${packageVersion}
+
+Usage:
+  ditto save <content> [--source <s>] [--source-context <c>]
+  ditto search <query>...
+  ditto fetch <pair-id>...
+  ditto subjects <query> [--top-k <n>]
+  ditto memories <subject-id>...
+  ditto network <pair-id> [--limit <n>]
+  ditto status
+  ditto config
+  ditto help
+
+Environment:
+  DITTO_API_KEY    Required. Get one at ${newKeyURL()}.
+  DITTO_API_BASE   Optional. Defaults to https://api.heyditto.ai.
+`;
+}
+async function getClient() {
+    const key = apiKey();
+    if (!key) {
+        process.stderr.write(`error: DITTO_API_KEY is not set.\nGet a key at ${newKeyURL()}, then export DITTO_API_KEY=ditto_mcp_…\n`);
+        process.exit(1);
+    }
+    const client = new Client({ name: packageName, version: packageVersion });
+    const transport = new StreamableHTTPClientTransport(new URL(mcpServerURL()), {
+        requestInit: {
+            headers: { Authorization: `Bearer ${key}` },
+        },
+    });
+    await client.connect(transport);
+    return client;
+}
+async function callAndPrint(name, args) {
+    const client = await getClient();
+    try {
+        const result = await client.callTool({ name, arguments: args });
+        const block = Array.isArray(result.content) ? result.content[0] : undefined;
+        if (block && typeof block === "object" && "type" in block && block.type === "text" && "text" in block) {
+            process.stdout.write(`${block.text}\n`);
+        }
+        else {
+            process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        }
+    }
+    finally {
+        await client.close();
+    }
+}
+function requirePositionals(positionals, minimum, label) {
+    if (positionals.length < minimum) {
+        throw new Error(`${label}: expected at least ${minimum} argument(s), got ${positionals.length}`);
+    }
+}
+async function cmdSave(rest) {
+    const { values, positionals } = parseArgs({
+        args: rest,
+        options: {
+            source: { type: "string", default: "cli" },
+            "source-context": { type: "string" },
+        },
+        allowPositionals: true,
+    });
+    requirePositionals(positionals, 1, "save");
+    await callAndPrint("save_memory", {
+        content: positionals.join(" "),
+        source: values.source,
+        sourceContext: values["source-context"],
+    });
+}
+async function cmdSearch(rest) {
+    const { positionals } = parseArgs({
+        args: rest,
+        options: {},
+        allowPositionals: true,
+    });
+    requirePositionals(positionals, 1, "search");
+    await callAndPrint("search_memories", { queries: positionals });
+}
+async function cmdFetch(rest) {
+    const { positionals } = parseArgs({
+        args: rest,
+        options: {},
+        allowPositionals: true,
+    });
+    requirePositionals(positionals, 1, "fetch");
+    await callAndPrint("fetch_memories", { pairIds: positionals });
+}
+async function cmdSubjects(rest) {
+    const { values, positionals } = parseArgs({
+        args: rest,
+        options: {
+            "top-k": { type: "string" },
+        },
+        allowPositionals: true,
+    });
+    requirePositionals(positionals, 1, "subjects");
+    const args = { query: positionals.join(" ") };
+    if (values["top-k"]) {
+        const n = Number.parseInt(values["top-k"], 10);
+        if (!Number.isFinite(n))
+            throw new Error("--top-k must be an integer");
+        args.topK = n;
+    }
+    await callAndPrint("search_subjects", args);
+}
+async function cmdMemories(rest) {
+    const { positionals } = parseArgs({
+        args: rest,
+        options: {},
+        allowPositionals: true,
+    });
+    requirePositionals(positionals, 1, "memories");
+    await callAndPrint("search_memories_in_subjects", { subjectIds: positionals });
+}
+async function cmdNetwork(rest) {
+    const { values, positionals } = parseArgs({
+        args: rest,
+        options: {
+            limit: { type: "string" },
+        },
+        allowPositionals: true,
+    });
+    requirePositionals(positionals, 1, "network");
+    const args = { pairId: positionals[0] };
+    if (values.limit) {
+        const n = Number.parseInt(values.limit, 10);
+        if (!Number.isFinite(n))
+            throw new Error("--limit must be an integer");
+        args.limit = n;
+    }
+    await callAndPrint("get_memory_network", args);
+}
+async function cmdStatus() {
+    const key = apiKey();
+    const lines = [
+        `${packageName} ${packageVersion}`,
+        `endpoint:  ${mcpServerURL()}`,
+        `api key:   ${key ? "set" : "MISSING (export DITTO_API_KEY)"}`,
+    ];
+    if (!key) {
+        lines.push(`new key:   ${newKeyURL()}`);
+        process.stdout.write(`${lines.join("\n")}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        const client = await getClient();
+        try {
+            const tools = await client.listTools();
+            lines.push(`tools:     ${tools.tools.map((t) => t.name).join(", ")}`);
+        }
+        finally {
+            await client.close();
+        }
+    }
+    catch (err) {
+        lines.push(`connect:   FAILED — ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 1;
+    }
+    process.stdout.write(`${lines.join("\n")}\n`);
+}
+function cmdConfig() {
+    const config = {
+        mcpServers: {
+            ditto: {
+                url: mcpServerURL(),
+                headers: {
+                    Authorization: "Bearer ${DITTO_API_KEY}",
+                },
+            },
+        },
+        notes: {
+            apiBase: apiBaseURL(),
+            newKey: newKeyURL(),
+        },
+    };
+    process.stdout.write(`${JSON.stringify(config, null, 2)}\n`);
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    const command = argv[0];
+    const rest = argv.slice(1);
+    switch (command) {
+        case "save":
+            await cmdSave(rest);
+            return;
+        case "search":
+            await cmdSearch(rest);
+            return;
+        case "fetch":
+            await cmdFetch(rest);
+            return;
+        case "subjects":
+            await cmdSubjects(rest);
+            return;
+        case "memories":
+            await cmdMemories(rest);
+            return;
+        case "network":
+            await cmdNetwork(rest);
+            return;
+        case "status":
+            await cmdStatus();
+            return;
+        case "config":
+            cmdConfig();
+            return;
+        case undefined:
+        case "help":
+        case "--help":
+        case "-h":
+            process.stdout.write(usage());
+            return;
+        case "--version":
+        case "-v":
+            process.stdout.write(`${packageVersion}\n`);
+            return;
+        default:
+            process.stderr.write(`Unknown command: ${command}\n\n${usage()}`);
+            process.exitCode = 2;
+    }
+}
+main().catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 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/config.d.ts

@@ -0,0 +1,6 @@
+export declare const packageName = "@heyditto/cli";
+export declare const packageVersion = "0.1.0";
+export declare function apiBaseURL(): string;
+export declare function mcpServerURL(): string;
+export declare function apiKey(): string | undefined;
+export declare function newKeyURL(): string;

package/dist/config.js

@@ -0,0 +1,15 @@
+export const packageName = "@heyditto/cli";
+export const packageVersion = "0.1.0";
+export function apiBaseURL() {
+    return (process.env.DITTO_API_BASE || "https://api.heyditto.ai").replace(/\/+$/, "");
+}
+export function mcpServerURL() {
+    return `${apiBaseURL()}/mcp`;
+}
+export function apiKey() {
+    return process.env.DITTO_API_KEY;
+}
+export function newKeyURL() {
+    return "https://app.heyditto.ai/mcp/newkey";
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,yBAAyB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,GAAG,UAAU,EAAE,MAAM,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,oCAAoC,CAAC;AAC9C,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@heyditto/cli",
+  "version": "0.1.0",
+  "description": "Ditto Memory CLI — save, search, fetch, and traverse the Ditto memory graph from the shell.",
+  "type": "module",
+  "bin": {
+    "ditto": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "prepack": "npm run build",
+    "release": "semantic-release"
+  },
+  "keywords": [
+    "ditto",
+    "heyditto",
+    "memory",
+    "cli",
+    "mcp",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ditto-assistant/ditto-cli.git"
+  },
+  "homepage": "https://github.com/ditto-assistant/ditto-cli",
+  "bugs": "https://github.com/ditto-assistant/ditto-app/issues/1212",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  },
+  "devDependencies": {
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/github": "^11.0.6",
+    "@semantic-release/npm": "^13.1.5",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@types/node": "^22.15.3",
+    "semantic-release": "^25.0.3",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}