@finic-ai/finic 0.0.2

package/README.md

@@ -0,0 +1,67 @@
+# finic-agent
+
+The Finic agent runtime, distributed as a self-contained binary named `finic`.
+It runs the Finic agent in three shapes from a single codebase: an embedded
+subprocess, a long-running daemon, and an interactive terminal UI.
+
+## Install
+
+```sh
+npm install -g @finic-ai/finic
+```
+
+This installs the `finic` binary for your platform (macOS and Linux, arm64 and
+x64).
+
+## Usage
+
+```sh
+finic                 # start the interactive TUI
+finic whoami          # check authentication against the configured backend
+finic mcp             # list available MCP tools
+finic --help          # full command list
+```
+
+## Configuration
+
+`finic` needs the URL of a Finic backend. It is resolved in this order, highest
+priority first:
+
+1. `--finic-url <url>` — CLI flag
+2. `FINIC_URL` — environment variable
+3. `finic_url` under `[runtime]` in `~/.finic/config.toml`
+
+Set it persistently:
+
+```sh
+finic config runtime --finic-url <url>
+finic config show     # show the resolved configuration
+```
+
+The MCP endpoint defaults to `<finic-url>/mcp/finic` and can be overridden with
+`--mcp-url`, `FINIC_MCP_URL`, or `mcp_url` in the same config file.
+
+### AI endpoint
+
+`finic` does not assume an AI provider — you must point it at one explicitly,
+or it will refuse to run. Resolved with the same precedence as the backend URL:
+
+1. `--anthropic-base-url <url>` — CLI flag
+2. `ANTHROPIC_BASE_URL` — environment variable
+3. `anthropic_base_url` under `[runtime]` in `~/.finic/config.toml`
+
+```sh
+finic config runtime --anthropic-base-url <url>
+```
+
+To call Anthropic directly, set it to `https://api.anthropic.com`.
+
+## Authentication
+
+```sh
+finic login           # browser-based login; stores a token under ~/.finic/
+```
+
+## License
+
+See the `LICENSE` file.

package/dist/index.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+// @finic-ai/finic — JS wrapper. Resolves the platform binary from
+// the matching @finic-ai/finic-<os>-<cpu> optional dependency.
+const { spawnSync } = require("node:child_process");
+const target = process.platform + "-" + (process.arch === "x64" ? "x64" : "arm64");
+const subpkg = "@finic-ai/finic-" + target;
+let binPath;
+try {
+  binPath = require.resolve(subpkg + "/dist/finic");
+} catch (e) {
+  console.error("Unable to find the finic binary for " + target + ". Did the install pull in " + subpkg + "?");
+  process.exit(1);
+}
+const result = spawnSync(binPath, process.argv.slice(2), { stdio: "inherit" });
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@finic-ai/finic",
+  "version": "0.0.2",
+  "description": "Finic agent — Bun-compiled local runtime. Dispatches to the platform-specific binary at runtime.",
+  "bin": { "finic": "./dist/index.js" },
+  "files": ["dist/**/*", "README.md"],
+  "optionalDependencies": {
+    "@finic-ai/finic-darwin-arm64": "0.0.2",
+    "@finic-ai/finic-darwin-x64":   "0.0.2",
+    "@finic-ai/finic-linux-arm64":  "0.0.2",
+    "@finic-ai/finic-linux-x64":    "0.0.2"
+  }
+}