@agentgrant.cash/cli 1.3.0 → 1.4.0

package/dist/cli/commands/onboard.js

@@ -0,0 +1,119 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync, appendFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { buildContext, emit, ui } from "../../lib/index.js";
+/**
+ * `grant onboard` — one-step setup for a fresh agent.
+ *
+ * This is the command the hosted onboarding skill (`/skill.md`) tells an agent
+ * to run after a user pastes "Set up https://<host>/skill.md". It:
+ *   1. installs the FULL Grant Cash skill (bundled in this package) into
+ *      whatever coding agent it detects (Claude Code / Cursor / Codex /
+ *      Windsurf / Continue), so the agent gains the complete command map, and
+ *   2. connects the account by running the real `login` flow, which prints the
+ *      sign-in link and waits for the user to approve.
+ *
+ * Net effect: the agent goes from "knows nothing" to "skill installed + link
+ * in front of the user" from a single command, with no `curl | sh`.
+ */
+const SKILL_NAME = "grant-cash";
+/** The full operational skill shipped inside this package. */
+function readBundledSkill() {
+    const p = fileURLToPath(new URL("../../../skills/grant-cash/SKILL.md", import.meta.url));
+    return readFileSync(p, "utf8");
+}
+/** Detect installed agents and write the skill into each one's convention. */
+function installSkill(skill) {
+    const home = homedir();
+    const installed = [];
+    const has = (rel) => existsSync(join(home, rel));
+    const writeFresh = (file) => {
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, skill);
+    };
+    if (has(".claude")) {
+        const file = join(home, ".claude", "skills", SKILL_NAME, "SKILL.md");
+        writeFresh(file);
+        installed.push({ agent: "Claude Code", path: file });
+    }
+    if (has(".cursor")) {
+        const file = join(home, ".cursor", "rules", `${SKILL_NAME}.mdc`);
+        writeFresh(file);
+        installed.push({ agent: "Cursor", path: file });
+    }
+    if (has(".codex")) {
+        // Codex reads one AGENTS.md — append (deduped) rather than overwrite.
+        const file = join(home, ".codex", "AGENTS.md");
+        const existing = existsSync(file) ? readFileSync(file, "utf8") : "";
+        if (!/^name: grant-cash$/m.test(existing)) {
+            mkdirSync(dirname(file), { recursive: true });
+            appendFileSync(file, (existing.trim() ? "\n\n---\n\n" : "") + skill);
+        }
+        installed.push({ agent: "Codex", path: file });
+    }
+    if (has(join(".codeium", "windsurf"))) {
+        const file = join(home, ".codeium", "windsurf", "memories", `${SKILL_NAME}.md`);
+        writeFresh(file);
+        installed.push({ agent: "Windsurf", path: file });
+    }
+    if (has(".continue")) {
+        const file = join(home, ".continue", "rules", `${SKILL_NAME}.md`);
+        writeFresh(file);
+        installed.push({ agent: "Continue", path: file });
+    }
+    // No known agent detected → default to the Claude Code layout so the skill
+    // still lands somewhere sane.
+    if (installed.length === 0) {
+        const file = join(home, ".claude", "skills", SKILL_NAME, "SKILL.md");
+        writeFresh(file);
+        installed.push({ agent: "Claude Code", path: file });
+    }
+    return installed;
+}
+export function registerOnboard(program) {
+    program
+        .command("onboard")
+        .description("Set up Grant Cash: install the skill into your agent and connect (one step)")
+        .option("--no-open", "do not auto-open the browser during sign-in; just print the link")
+        .option("--no-login", "only install the skill; skip sign-in")
+        .option("--timeout <seconds>", "how long to wait for the browser", "300")
+        .action(async (opts, cmd) => {
+        const ctx = buildContext(cmd);
+        const installed = installSkill(readBundledSkill());
+        if (!ctx.json) {
+            process.stdout.write(`\n${ui.title("Grant Cash — set up")}\n` +
+                installed
+                    .map((t) => `  ${ui.green("✓")} ${t.agent.padEnd(12)} ${ui.dim(t.path)}`)
+                    .join("\n") +
+                "\n");
+        }
+        // Install-only mode (e.g. CI, or re-installing the skill).
+        if (opts.login === false) {
+            emit(ctx, { installed, connected: false }, () => `\n${ui.green("✓ Skill installed.")} ${ui.dim("Run `grant login` to connect.")}\n`);
+            return;
+        }
+        // Connect by re-running the real `login` command with inherited stdio, so
+        // the sign-in link prints, the browser opens, and polling completes
+        // exactly as `grant login` would. Forward the relevant flags.
+        const passthrough = ["login"];
+        if (ctx.json)
+            passthrough.push("--json");
+        if (opts.open === false)
+            passthrough.push("--no-open");
+        if (opts.timeout)
+            passthrough.push("--timeout", String(opts.timeout));
+        const globals = cmd.optsWithGlobals();
+        if (globals.credsFile)
+            passthrough.push("--creds-file", globals.credsFile);
+        if (!ctx.json) {
+            process.stdout.write(`\n${ui.dim("Connecting your account…")}\n`);
+        }
+        const res = spawnSync(process.execPath, [process.argv[1], ...passthrough], {
+            stdio: "inherit",
+        });
+        if (res.status && res.status !== 0)
+            process.exitCode = res.status;
+    });
+}

package/dist/cli/index.js

@@ -25,6 +25,7 @@ import { registerPortfolio } from "./commands/portfolio.js";
 import { registerMoney } from "./commands/money.js";
 import { registerAgent } from "./commands/agent.js";
 import { registerMeta } from "./commands/meta.js";
+import { registerOnboard } from "./commands/onboard.js";
 // ── full investing surface ported from the standalone Perfolio CLI ──
 import { registerTrade } from "./perfolio-commands/trade.js";
 import { registerMarket } from "./perfolio-commands/market.js";
@@ -55,6 +56,7 @@ program
     .option("--json", "machine-readable JSON output")
     .option("--creds-file <path>", "override ~/.grant-cash/credentials.json");
 registerAuth(program);
+registerOnboard(program);
 registerPortfolio(program);
 registerMoney(program);
 registerAgent(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentgrant.cash/cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Grant Cash — one CLI for your money (gold) and your agent (pay-per-use services). Routes to the Perfolio backend and the Agent-mode backend behind a single, plain-language surface.",
   "type": "module",
   "bin": {