@memfork/cli 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,109 @@
+# @memfork/cli
+
+Command-line interface for [MemForks](https://github.com/memfork/memforks) — on-chain, branch-aware agent memory.
+
+Initialize a memory tree, commit facts, branch and merge, onboard teammates, and install IDE plugins.
+
+## Install
+
+```bash
+npm install -g @memfork/cli
+# or run without installing
+npx @memfork/cli init
+```
+
+## Quick start
+
+```bash
+# One-shot setup on mainnet (gas sponsored — no SUI required)
+memfork init
+
+# Verify everything works
+memfork doctor
+
+# Install Cursor plugin (MemWal MCP + MemForks rules)
+memfork install cursor
+```
+
+Restart your IDE. The agent recalls and commits memory scoped to your Git branch.
+
+## Commands
+
+### Setup
+
+| Command | Description |
+|---------|-------------|
+| `memfork init` | Interactive setup — create or link a memory tree |
+| `memfork init --quick` | Auto-provision key, MemWal account, and tree (testnet) |
+| `memfork join` | Onboard to an existing tree (team member) |
+| `memfork doctor` | Verify config, RPC, credentials, and on-chain state |
+| `memfork install cursor` | Install Cursor MCP + rules |
+| `memfork install codex` | Install Codex plugin scaffold |
+
+### Memory operations
+
+| Command | Description |
+|---------|-------------|
+| `memfork status` | Tree, network, branch, signer |
+| `memfork log` | Recent commits on a branch |
+| `memfork recall <query>` | Semantic recall from CLI |
+| `memfork commit -m "…" --facts "…"` | Anchor facts on-chain |
+| `memfork branch <name>` | Create a new branch |
+| `memfork checkout <name>` | Switch active branch |
+| `memfork diff <a> <b>` | Fact diff between branches |
+| `memfork merge <from> <into> --resolver <id>` | Propose a merge |
+| `memfork proposals` | List open merge proposals |
+
+### Access control
+
+| Command | Description |
+|---------|-------------|
+| `memfork grant --agent <addr>` | Grant on-chain delegate access |
+| `memfork grant-memwal --agent <addr> --pubkey <hex>` | Register MemWal decrypt key |
+| `memfork revoke --agent <addr>` | Revoke delegate |
+| `memfork delegates` | List current delegates |
+
+## Config files
+
+| File | Committable? | Contents |
+|------|--------------|----------|
+| `.memfork/config.json` | Yes | `treeId`, `network`, `defaultBranch` |
+| `~/.memfork/credentials.json` | No | Private keys, MemWal delegate key |
+
+Never commit credentials. Share `.memfork/config.json` via git so teammates can `memfork join`.
+
+## Team onboarding
+
+**Teammate:**
+
+```bash
+git clone <repo>   # .memfork/config.json is already there
+memfork join
+```
+
+**Tree owner** (runs the printed commands):
+
+```bash
+memfork grant --agent <teammate-address>
+memfork grant-memwal --agent <teammate-address> --pubkey <hex>
+```
+
+## Environment variables
+
+| Variable | Description |
+|----------|-------------|
+| `MEMFORK_TREE_ID` | MemoryTree object ID |
+| `MEMFORK_PRIVATE_KEY` | Sui private key (`suiprivkey1…`) |
+| `MEMFORK_NETWORK` | `mainnet` (default) or `testnet` |
+| `MEMFORK_SPONSOR_URL` | Gas sponsor service URL |
+| `MEMFORK_PACKAGE_ID` | Override Move package ID |
+
+## Links
+
+- [@memfork/core](https://www.npmjs.com/package/@memfork/core) — TypeScript SDK
+- [Developer guide](https://github.com/memfork/memforks/blob/main/docs/developer-guide.md)
+- [Git comparison](https://github.com/memfork/memforks/blob/main/docs/git-comparison.md)
+
+## License
+
+Apache-2.0

package/dist/cli.js

@@ -21,7 +21,7 @@
 import { Command } from "commander";
 import chalk from "chalk";
 import { cmdInit } from "./commands/init.js";
-import { cmdDoctor } from "./commands/doctor.js";
+import { cmdDoctor, cmdDoctorEnv } from "./commands/doctor.js";
 import { cmdInstall } from "./commands/install.js";
 import { cmdStatus, cmdLog, cmdRecall, cmdCommit, cmdMerge, cmdProposals, cmdUi, cmdShow, cmdDiff, cmdDelegates, cmdGrant, cmdGrantMemwal, cmdRevoke, cmdBranch, cmdCheckout, } from "./commands/ops.js";
 import { cmdJoin } from "./commands/join.js";
@@ -39,7 +39,8 @@ program
 program
     .command("doctor")
     .description("verify config, credentials, Sui connection, and MemWal")
-    .action(wrap(cmdDoctor));
+    .option("--env", "print MEMFORK_* env vars ready to paste into .env.local")
+    .action(wrap((opts) => opts.env ? cmdDoctorEnv() : cmdDoctor()));
 program
     .command("join")
     .description("onboard to an existing tree (team member setup)")

package/dist/commands/doctor.d.ts

@@ -9,4 +9,5 @@
  *   ✓ / ✗  Signer address matches tree owner (or has delegate)
  *   ✓ / ✗  MemWal account reachable
  */
+export declare function cmdDoctorEnv(): Promise<void>;
 export declare function cmdDoctor(): Promise<void>;

package/dist/commands/doctor.js

@@ -22,6 +22,31 @@ function printCheck(c) {
         console.log(`      ${chalk.cyan("→")} ${c.fix}`);
     }
 }
+export async function cmdDoctorEnv() {
+    let cfg;
+    try {
+        cfg = resolveConfig();
+    }
+    catch (e) {
+        console.error(chalk.red("✗  Could not resolve config: " + e.message));
+        console.error(chalk.dim("   Run `memfork init` first."));
+        process.exit(1);
+    }
+    console.log("");
+    console.log(chalk.dim("# MemForks environment variables — paste into .env.local"));
+    console.log(chalk.yellow("# Keep these private. Do not commit or share this output."));
+    console.log("");
+    console.log(`MEMFORK_TREE_ID=${cfg.treeId}`);
+    console.log(`MEMFORK_PRIVATE_KEY=${cfg.privateKey}`);
+    console.log(`MEMFORK_MEMWAL_ACCOUNT=${cfg.memwalAccountId}`);
+    console.log(`MEMFORK_MEMWAL_KEY=${cfg.memwalKey}`);
+    console.log(`MEMFORK_NETWORK=${cfg.network}`);
+    if (cfg.rpcUrl)
+        console.log(`MEMFORK_RPC_URL=${cfg.rpcUrl}`);
+    if (cfg.packageId)
+        console.log(`MEMFORK_PACKAGE_ID=${cfg.packageId}`);
+    console.log("");
+}
 export async function cmdDoctor() {
     console.log("");
     console.log(chalk.bold("memfork doctor"));

package/dist/commands/install.js

@@ -21,7 +21,8 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { readCredentials, readProjectConfig, MEMWAL_CONSTANTS } from "../config.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const PLUGIN_ROOT = path.resolve(__dirname, "..", "..", "..", "plugins");
+// dist/commands/install.js → packages/cli → packages → repo root → plugins/
+const PLUGIN_ROOT = path.resolve(__dirname, "..", "..", "..", "..", "plugins");
 function ok(s) { return chalk.green("✓") + " " + s; }
 function warn(s) { return chalk.yellow("⚠") + " " + s; }
 function tip(s) { return chalk.cyan("→") + " " + s; }

package/dist/commands/ops.js

@@ -165,7 +165,7 @@ export async function cmdUi(opts = {}) {
     const appDir = findAppDir();
     if (!appDir) {
         console.log(chalk.yellow("Could not find the MemForks app directory."));
-        console.log(chalk.dim("Build the app manually: cd app && npm run build"));
+        console.log(chalk.dim("Build the app manually: cd apps/visualizer && npm run build"));
         return;
     }
     const distDir = path.join(appDir, "dist");
@@ -427,9 +427,10 @@ function extractFacts(response) {
 }
 // ─── Helpers ──────────────────────────────────────────────────────────────────
 function findAppDir() {
+    // dist/commands/ops.js → packages/cli → packages → repo root → apps/visualizer
     const candidates = [
-        new URL("../../../app", import.meta.url).pathname,
-        new URL("../../../../app", import.meta.url).pathname,
+        new URL("../../../../apps/visualizer", import.meta.url).pathname,
+        new URL("../../../../../apps/visualizer", import.meta.url).pathname,
     ];
     for (const c of candidates) {
         try {

package/dist/commands/ui-server.d.ts

@@ -1,7 +1,7 @@
 /**
  * `memfork ui` — local HTTP server.
  *
- * Serves the pre-built React app from app/dist/ as static files and
+ * Serves the pre-built React app from apps/visualizer/dist/ as static files and
  * exposes two API routes so the React app can discover the current tree
  * config and recall MemWal facts without exposing credentials in the
  * browser bundle.

package/dist/commands/ui-server.js

@@ -1,7 +1,7 @@
 /**
  * `memfork ui` — local HTTP server.
  *
- * Serves the pre-built React app from app/dist/ as static files and
+ * Serves the pre-built React app from apps/visualizer/dist/ as static files and
  * exposes two API routes so the React app can discover the current tree
  * config and recall MemWal facts without exposing credentials in the
  * browser bundle.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memfork/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MemForks CLI — init, commit, recall, merge, install plugins",
   "type": "module",
   "bin": {
@@ -24,7 +24,7 @@
   ],
   "dependencies": {
     "@inquirer/prompts": "^8.5.2",
-    "@memfork/core": "^0.1.0",
+    "@memfork/core": "^0.1.1",
     "chalk": "^5.6.2",
     "commander": "^15.0.0"
   },