@hardfin/cli 0.1.1-dev.59 → 0.1.1-dev.60

package/README.md

@@ -446,6 +446,7 @@ types are stale.
 ```sh
 hardfin init            # the working directory
 hardfin init --dry-run  # what it would write, writing nothing
+hardfin init --local    # set up the server this CLI runs, in place of the hosted one
 ```
 
 `hardfin init` gets a project ready for a coding agent to use Hardfin, the way EmDash's starter
@@ -465,6 +466,11 @@ by default. [Serving an agent](#serving-an-agent) says how it differs from the l
 this CLI runs. Every other server in an MCP config, and everything in `AGENTS.md` outside the
 markers, is left as it was. A config that does not hold JSON is skipped, never overwritten.
 
+`hardfin init --local` writes the local server in its place: the command `hardfin mcp`, which
+each client starts by name. It needs `hardfin` on the `PATH` of whoever opens the project, and
+it writes no address, so it works in a folder set up for a local build. Run `init` again
+without `--local` to go back to the hosted server.
+
 `init` refuses an address that `config.local.json` or `.env` in the folder chose, because the
 address goes into files every agent in the project reads. Pass `--issuer-url` to use it. The
 address must be https, or this machine.
@@ -477,16 +483,16 @@ package, so `init` writes the copy that matches the installed CLI.
 Hardfin has two MCP servers, and an agent needs only one of them. Hardfin hosts one. The
 other is this CLI, run on your machine. Read this section to choose between them.
 
-|                       | The hosted server                                                    | The local server                                       |
-| --------------------- | -------------------------------------------------------------------- | ------------------------------------------------------ |
-| Runs                  | At Hardfin, at `https://api.hardfin.com/mcp`                         | On your machine, started by the agent's client         |
-| Needs installed       | Nothing                                                              | This CLI, and Node 20.12 or later                      |
-| Set up by             | `hardfin init`                                                       | `claude mcp add hardfin -- hardfin mcp`                |
-| Signs in as           | Whoever signs in to Hardfin from the client                          | Whoever ran `hardfin login` here, or `HARDFIN_API_KEY` |
-| Tools                 | `hardfin_read`, `hardfin_create`, `hardfin_update`, `hardfin_delete` | `hardfin_read`, `hardfin_write`, `hardfin_delete`      |
-| A call names          | An operation from the API reference, with its parameters and body    | A command, as the words typed after `hardfin`          |
-| Read-only when        | The sign in was not granted `hardfin:write`                          | The same, or it was started with `--read-only`         |
-| Files on your machine | Out of reach                                                         | Uploaded and downloaded, inside the folder it runs in  |
+|                       | The hosted server                                                    | The local server                                                   |
+| --------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| Runs                  | At Hardfin, at `https://api.hardfin.com/mcp`                         | On your machine, started by the agent's client                     |
+| Needs installed       | Nothing                                                              | This CLI, and Node 20.12 or later                                  |
+| Set up by             | `hardfin init`                                                       | `hardfin init --local`, or `claude mcp add hardfin -- hardfin mcp` |
+| Signs in as           | Whoever signs in to Hardfin from the client                          | Whoever ran `hardfin login` here, or `HARDFIN_API_KEY`             |
+| Tools                 | `hardfin_read`, `hardfin_create`, `hardfin_update`, `hardfin_delete` | `hardfin_read`, `hardfin_write`, `hardfin_delete`                  |
+| A call names          | An operation from the API reference, with its parameters and body    | A command, as the words typed after `hardfin`                      |
+| Read-only when        | The sign in was not granted `hardfin:write`                          | The same, or it was started with `--read-only`                     |
+| Files on your machine | Out of reach                                                         | Uploaded and downloaded, inside the folder it runs in              |
 
 Choose the hosted server unless one of these holds.
 

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0244e0c8-4f66-5b42-b025-5f487baeab82")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7b79fe1d-6296-5c3c-a667-7257662abc80")}catch(e){}}();
 import module from "node:module";
 //#region src/cli.ts
 module.enableCompileCache?.();
@@ -14,7 +14,7 @@ process.on("unhandledRejection", (error) => void toCrash(error));
 try {
 	const answer = await toQuickAnswer(process.argv.slice(2));
 	if (answer === void 0) {
-		const { toCli, toParseExitCode, wasReportAttempted } = await import("./program-DJuADiEQ.js");
+		const { toCli, toParseExitCode, wasReportAttempted } = await import("./program-BP83nk1M.js");
 		try {
 			await toCli().parseAsync(process.argv);
 		} catch (error) {
@@ -33,7 +33,7 @@ async function toCrash(error) {
 	isCrashing = true;
 	const isJSON = process.argv.includes("--json") || !process.stdout.isTTY;
 	try {
-		const { toReported, writeCrash } = await import("./program-DJuADiEQ.js");
+		const { toReported, writeCrash } = await import("./program-BP83nk1M.js");
 		writeCrash(error, isJSON);
 		await toReported(error, isJSON, void 0, "fatal");
 	} catch {
@@ -54,4 +54,4 @@ async function toQuickAnswer(args) {
 export {};
 
 //# sourceMappingURL=cli.js.map
-//# debugId=0244e0c8-4f66-5b42-b025-5f487baeab82
+//# debugId=7b79fe1d-6296-5c3c-a667-7257662abc80

package/dist/completion-tree.json

@@ -82,6 +82,10 @@
       "summary": "Set up a project so coding agents can use Hardfin",
       "runs": true,
       "flags": [
+        {
+          "name": "local",
+          "description": "Set up the MCP server this CLI runs on this machine, in place of the one Hardfin hosts"
+        },
         {
           "name": "dry-run",
           "description": "Say what would be written, and write nothing"

package/dist/{program-DJuADiEQ.js → program-BP83nk1M.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="18a7a3bd-a2f6-52ae-87ff-4ec7cc364512")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5a81163a-f2c4-570b-9451-c1fad66921a0")}catch(e){}}();
 import { a as defineCommand, i as GLOBAL_FLAGS, r as ExitCode, t as toInvocation } from "./scrub-BZ0egWxC.js";
 import { n as toAnswer$1, r as toCompletion, t as PATH_VALUES } from "./completion-tree-DLC6ARLR.js";
 import { createRequire } from "node:module";
@@ -2795,28 +2795,43 @@ const SKILL_DIRECTORIES = [".agents/skills", ".claude/skills"];
 const initCommand = defineCommand({
 	name: "init",
 	summary: "Set up a project so coding agents can use Hardfin",
-	description: "Writes the hardfin-cli skill, a Hardfin section in AGENTS.md, and the Hardfin MCP server for Claude Code, Cursor and VS Code. Running it again updates what it wrote and leaves everything else alone.",
+	description: "Writes the hardfin-cli skill, a Hardfin section in AGENTS.md, and the Hardfin MCP server for Claude Code, Cursor and VS Code. The server is the one Hardfin hosts, or with --local the one this CLI runs. Running it again updates what it wrote and leaves everything else alone.",
 	arguments: [{
 		name: "directory",
 		description: "The project to set up, which is the working directory when omitted",
 		required: false
 	}],
-	flags: [{
-		name: "dry-run",
-		description: "Say what would be written, and write nothing",
-		schema: z.boolean()
-	}, {
-		name: "json",
-		description: "Print machine-readable output, which is the default when stdout is not a terminal",
-		schema: z.boolean()
-	}],
-	examples: [{
-		description: "Set up the project you are in",
-		command: "hardfin init"
-	}, {
-		description: "See what it would write first",
-		command: "hardfin init --dry-run"
-	}],
+	flags: [
+		{
+			name: "local",
+			description: "Set up the MCP server this CLI runs on this machine, in place of the one Hardfin hosts",
+			schema: z.boolean()
+		},
+		{
+			name: "dry-run",
+			description: "Say what would be written, and write nothing",
+			schema: z.boolean()
+		},
+		{
+			name: "json",
+			description: "Print machine-readable output, which is the default when stdout is not a terminal",
+			schema: z.boolean()
+		}
+	],
+	examples: [
+		{
+			description: "Set up the project you are in",
+			command: "hardfin init"
+		},
+		{
+			description: "See what it would write first",
+			command: "hardfin init --dry-run"
+		},
+		{
+			description: "Use the local server, which can upload and download files",
+			command: "hardfin init --local"
+		}
+	],
 	run: runInit
 });
 async function runInit(input) {
@@ -2825,7 +2840,7 @@ async function runInit(input) {
 		writeFailure("invalid_arguments", `${target} is not a folder, so there is nothing to set up`, input.isJSON);
 		return ExitCode.USAGE;
 	}
-	const mcpUrl = toMcpUrl(input.resolved);
+	const mcpUrl = input.flags["local"] === true ? void 0 : toMcpUrl(input.resolved);
 	if (mcpUrl instanceof Error) {
 		writeFailure("invalid_config", mcpUrl.message, input.isJSON);
 		return ExitCode.USAGE;
@@ -2838,7 +2853,8 @@ async function runInit(input) {
 		writeData({
 			directory: target,
 			dryRun: isDryRun,
-			mcpUrl,
+			mcp: mcpUrl === void 0 ? "local" : "hosted",
+			mcpUrl: mcpUrl ?? null,
 			changes
 		});
 		return ExitCode.OK;
@@ -2877,17 +2893,63 @@ function toPlan(target, packageDirectory, mcpUrl) {
 		const content = readFileSync(file, "utf8");
 		for (const place of SKILL_DIRECTORIES) planned.push(toFilePlan(target, join(place, skill, relative(join(skills, skill), file)), content));
 	}
-	const section = readFileSync(join(packageDirectory, "templates", "AGENTS.md"), "utf8").replaceAll("{{MCP_URL}}", mcpUrl);
+	const section = readFileSync(join(packageDirectory, "templates", "AGENTS.md"), "utf8").replaceAll("{{MCP}}", toMcpParagraph(mcpUrl));
 	planned.push(toFilePlan(target, "AGENTS.md", toAgentsFile(join(target, "AGENTS.md"), section)));
-	planned.push(toJSONPlan(target, ".mcp.json", (config) => toWithServer(config, "mcpServers", {
-		type: "http",
-		url: mcpUrl
-	})), toJSONPlan(target, ".cursor/mcp.json", (config) => toWithServer(config, "mcpServers", { url: mcpUrl })), toJSONPlan(target, ".vscode/mcp.json", (config) => toWithServer(config, "servers", {
-		type: "http",
-		url: mcpUrl
-	})));
+	const shapes = mcpUrl === void 0 ? [
+		[
+			".mcp.json",
+			"mcpServers",
+			LOCAL_SERVER
+		],
+		[
+			".cursor/mcp.json",
+			"mcpServers",
+			LOCAL_SERVER
+		],
+		[
+			".vscode/mcp.json",
+			"servers",
+			{
+				type: "stdio",
+				...LOCAL_SERVER
+			}
+		]
+	] : [
+		[
+			".mcp.json",
+			"mcpServers",
+			{
+				type: "http",
+				url: mcpUrl
+			}
+		],
+		[
+			".cursor/mcp.json",
+			"mcpServers",
+			{ url: mcpUrl }
+		],
+		[
+			".vscode/mcp.json",
+			"servers",
+			{
+				type: "http",
+				url: mcpUrl
+			}
+		]
+	];
+	for (const [path, key, server] of shapes) planned.push(toJSONPlan(target, path, (config) => toWithServer(config, key, server)));
 	return planned;
 }
+/** How a client starts the MCP server this CLI runs, which needs hardfin on the PATH. */
+const LOCAL_SERVER = {
+	command: "hardfin",
+	args: ["mcp"]
+};
+/** toMcpParagraph tells an agent which MCP server the project is set up with, and where. */
+function toMcpParagraph(mcpUrl) {
+	const where = "is configured for Claude Code in `.mcp.json`, for\nCursor in `.cursor/mcp.json`, and for VS Code in `.vscode/mcp.json`. For Codex, add\n`[mcp_servers.hardfin]` with";
+	return mcpUrl === void 0 ? `The Hardfin MCP server runs on this machine as \`hardfin mcp\`. It ${where} \`command = "hardfin"\` and \`args = ["mcp"]\` to \`~/.codex/config.toml\`.` : `The Hardfin MCP server, \`${mcpUrl}\`, ${where} \`url = "${mcpUrl}"\` to \`~/.codex/config.toml\`.`;
+}
 /** toAgentsFile puts the Hardfin section into AGENTS.md, replacing the one an earlier run wrote. */
 function toAgentsFile(path, section) {
 	const block = `${SECTION_START}\n${section.trimEnd()}\n${SECTION_END}\n`;
@@ -7358,5 +7420,5 @@ async function toReported(error, isJSON, resolved, level = "error") {
 //#endregion
 export { toCli, toParseExitCode, toReported, wasReportAttempted, writeCrash };
 
-//# sourceMappingURL=program-DJuADiEQ.js.map
-//# debugId=18a7a3bd-a2f6-52ae-87ff-4ec7cc364512
+//# sourceMappingURL=program-BP83nk1M.js.map
+//# debugId=5a81163a-f2c4-570b-9451-c1fad66921a0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hardfin/cli",
-    "version": "0.1.1-dev.59",
+    "version": "0.1.1-dev.60",
     "description": "Command line interface for the Hardfin API",
     "license": "Apache-2.0",
     "author": "Hardfin, Inc.",

package/templates/AGENTS.md

@@ -13,9 +13,7 @@ This project works with Hardfin data through the Hardfin CLI, `hardfin`.
 
 Start with the `hardfin-cli` skill in `.agents/skills/hardfin-cli/SKILL.md`.
 
-The Hardfin MCP server, `{{MCP_URL}}`, is configured for Claude Code in `.mcp.json`, for
-Cursor in `.cursor/mcp.json`, and for VS Code in `.vscode/mcp.json`. For Codex, add
-`[mcp_servers.hardfin]` with `url = "{{MCP_URL}}"` to `~/.codex/config.toml`.
+{{MCP}}
 
 Rules: