@emesoft/tokenhub 0.5.0 → 0.6.0

package/README.md

@@ -2,13 +2,15 @@
 
 Pair Claude Code on this machine with a [TokenHub](https://tokenhub.aimpact.io.vn) pool. No dependencies, Node 18+.
 
+`connect` pairs with https://tokenhub.aimpact.io.vn by default. For another pool, pass its address: `npx @emesoft/tokenhub connect https://pool.example.com`.
+
 ```
-npx @emesoft/tokenhub connect https://tokenhub.aimpact.io.vn
-npx @emesoft/tokenhub connect https://tokenhub.aimpact.io.vn --no-statusline
+npx @emesoft/tokenhub connect
+npx @emesoft/tokenhub connect --no-statusline
 npx @emesoft/tokenhub usage
 npx @emesoft/tokenhub dashboard
 npx @emesoft/tokenhub disconnect
-npx @emesoft/tokenhub connect https://tokenhub.aimpact.io.vn --admin
+npx @emesoft/tokenhub connect --admin
 npx @emesoft/tokenhub disconnect --admin
 ```
 
@@ -26,4 +28,4 @@ Requests to the pool carry your key and one extra header, `x-tokenhub-cli: <vers
 
 If `ANTHROPIC_BASE_URL`, `ANTHROPIC_AUTH_TOKEN` or `ANTHROPIC_API_KEY` is set in your shell, it overrides `settings.json`.
 
-Sign in, manage your keys and top up at [tokenhub.aimpact.io.vn](https://tokenhub.aimpact.io.vn). The setup guide there has this command with your pool address filled in.
+Sign in, manage your keys and top up at [tokenhub.aimpact.io.vn](https://tokenhub.aimpact.io.vn).

package/bin/tokenhub.js

@@ -2,17 +2,18 @@
 import { readFileSync } from "node:fs";
 import { adminConfigPath, removeAdminConfig } from "../lib/admin.js";
 import { parseDashboardArgs, runDashboard } from "../lib/dashboard.js";
-import { runConnect } from "../lib/pair.js";
+import { DEFAULT_POOL_URL, runConnect } from "../lib/pair.js";
 import { disconnectSettings, readSettings, settingsPath } from "../lib/settings.js";
 import { fetchUsage, formatUsage, resolveCredentials } from "../lib/usage.js";
 
 const HELP = `tokenhub - pair Claude Code with a TokenHub pool
 
 Usage:
-  tokenhub connect <poolUrl> [--no-statusline]
+  tokenhub connect [poolUrl] [--no-statusline]
                                Pair this machine and write ~/.claude/settings.json, including the status line
-                               (today's spend under the prompt) unless --no-statusline
-  tokenhub connect <poolUrl> --admin
+                               (today's spend under the prompt) unless --no-statusline.
+                               poolUrl defaults to ${DEFAULT_POOL_URL}
+  tokenhub connect [poolUrl] --admin
                                Pair this machine as an admin device (for the desktop overlay's pool view): the admin
                                confirms in the console, the token is saved to ~/.tokenhub/admin.json
   tokenhub usage [--json]      Show today's and this week's spend, credit and pool health
@@ -43,10 +44,6 @@ async function main(argv) {
   }
   const file = settingsPath();
   if (command === "connect") {
-    if (!arg) {
-      console.error(`Missing pool URL.\n\n${HELP}`);
-      return 1;
-    }
     const controller = new AbortController();
     process.once("SIGINT", () => controller.abort());
     return runConnect({
@@ -62,7 +59,7 @@ async function main(argv) {
     try {
       const credentials = resolveCredentials(readSettings(file).settings);
       if (!credentials) {
-        console.error("Not connected. Run `tokenhub connect <poolUrl>` first.");
+        console.error("Not connected. Run `tokenhub connect` first.");
         return 1;
       }
       const report = await fetchUsage(credentials.baseUrl, credentials.key);
@@ -78,7 +75,7 @@ async function main(argv) {
       const options = parseDashboardArgs(argv.slice(1));
       const credentials = resolveCredentials(readSettings(file).settings);
       if (!credentials) {
-        console.error("Not connected. Run `tokenhub connect <poolUrl>` first.");
+        console.error("Not connected. Run `tokenhub connect` first.");
         return 1;
       }
       return await runDashboard(credentials, options);

package/lib/pair.d.ts

@@ -1,6 +1,8 @@
+export const DEFAULT_POOL_URL: string;
 export function openBrowser(url: string, platform?: string): void;
 export function runConnect(options: {
-  poolUrl: string;
+  /** Pool address; defaults to `DEFAULT_POOL_URL`. */
+  poolUrl?: string;
   settingsFile: string;
   log?: (line: string) => void;
   open?: (url: string) => void;

package/lib/pair.js

@@ -5,6 +5,9 @@ import { connectSettings, normalizeUrl, overridingEnvVars, readSettings } from "
 
 const MAX_WAIT_MS = 15 * 60 * 1000;
 
+/** The pool `connect` pairs with when no address is given. */
+export const DEFAULT_POOL_URL = "https://tokenhub.aimpact.io.vn";
+
 /**
  * Open a URL in the default browser; failures are ignored (the URL is printed anyway).
  * @param {string} url Address to open.
@@ -62,7 +65,7 @@ async function postJson(url, body, signal) {
 /**
  * Run the pairing flow and write the issued key into settings.json.
  * @param {object} options
- * @param {string} options.poolUrl Pool address as typed by the user.
+ * @param {string} [options.poolUrl] Pool address as typed by the user (default `DEFAULT_POOL_URL`).
  * @param {string} options.settingsFile Path of settings.json to update.
  * @param {(line: string) => void} [options.log] Output sink.
  * @param {(url: string) => void} [options.open] Browser opener.
@@ -76,7 +79,7 @@ async function postJson(url, body, signal) {
  * @returns {Promise<number>} Process exit code.
  */
 export async function runConnect({
-  poolUrl,
+  poolUrl = DEFAULT_POOL_URL,
   settingsFile,
   log = console.log,
   open = openBrowser,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emesoft/tokenhub",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Pair Claude Code on this machine with a TokenHub pool",
   "type": "module",
   "bin": {