@noeis/noeis-cli 0.1.1 → 0.1.3

package/README.md

@@ -1,17 +1,14 @@
-# @noeis/cli
+# @noeis/noeis-cli
 
 Command-line client for scripting a Noeis wiki without an MCP-speaking agent.
 
 ## Install
 
-Current internal build:
-
 ```bash
-cd ~/Documents/GitHub/note-taker-3-1
-npm i -g ./packages/cli
+npm i -g @noeis/noeis-cli
 ```
 
-Public package status: `@noeis/cli` is not published on npm yet. After publish, this becomes `npm i -g @noeis/cli`.
+This installs the `noeis` command.
 
 ## Connect an agent
 
@@ -29,6 +26,8 @@ Supported runtime names: `claude-code`, `codex`, `hermes`, `openclaw`, and `open
 
 The generated runtime MCP config calls `noeis mcp`. The raw token stays in one place: the Noeis CLI config, normally `~/.config/noeis/config.json`. Generated MCP configs should not copy `NOEIS_TOKEN`.
 
+For OpenClaw, `noeis connect openclaw` writes both the XDG MCP file and `~/.openclaw/openclaw.json`, because OpenClaw installs differ in which config path they read.
+
 For local/self-hosted API targets, pass both URLs:
 
 ```bash
@@ -62,7 +61,7 @@ noeis login --token ntk_at_... --api-url http://localhost:5500
 You can also skip stored config and use environment variables:
 
 ```bash
-NOEIS_TOKEN=ntk_at_... NOEIS_API_URL=https://api.noeis.io noeis pages list
+NOEIS_TOKEN=ntk_at_... NOEIS_API_URL=https://note-taker-3-unrg.onrender.com noeis pages list
 ```
 
 Manual environment variables are useful for scripts. Runtime MCP configs should prefer `noeis mcp` so secrets remain centralized.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noeis/noeis-cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Command-line client for scripting a Noeis wiki.",
   "type": "module",
   "bin": {
@@ -23,7 +23,7 @@
   ],
   "license": "ISC",
   "dependencies": {
-    "@noeis/wiki-mcp": "^0.1.0"
+    "@noeis/wiki-mcp": "^0.1.1"
   },
   "engines": {
     "node": ">=18.17"

package/src/cli.js

@@ -13,7 +13,7 @@ const HELP = `Noeis CLI
 Usage:
   noeis connect [claude-code|codex|hermes|openclaw|opencode] [--label name] [--no-browser]
   noeis mcp [--help]
-  noeis login [--token ntk_at_...] [--api-url https://api.noeis.io]
+  noeis login [--token ntk_at_...] [--api-url https://note-taker-3-unrg.onrender.com]
   noeis pages list [--query text] [--status draft|published|archived] [--page-type type] [--limit n] [--json]
   noeis pages get <id> [--json]
   noeis ingest <url|file> [--title title] [--json]
@@ -27,6 +27,25 @@ Environment:
   NOEIS_TOKEN, NOEIS_API_URL, NOEIS_APP_URL, NOEIS_CONFIG_DIR
 `;
 
+const CONNECT_HELP = `Noeis agent connect
+
+Usage:
+  noeis connect [claude-code|codex|hermes|openclaw|opencode] [options]
+
+Options:
+  --label <name>       Label shown on the Noeis browser approval screen
+  --api-url <url>      API URL, defaults to ${DEFAULT_API_URL}
+  --app-url <url>      Browser approval app URL, defaults to ${DEFAULT_APP_URL}
+  --no-browser         Print the approval URL without opening a browser
+  --no-config          Save Noeis CLI config but do not write runtime MCP config
+  --timeout <seconds>  Wait time for browser approval, defaults to 300
+
+Examples:
+  noeis connect openclaw
+  noeis connect hermes
+  noeis connect codex --no-browser
+`;
+
 const optionValue = (args, name, fallback = '') => {
   const index = args.indexOf(name);
   if (index === -1) return fallback;
@@ -147,8 +166,21 @@ args = ["mcp"]${envLine}
   fs.writeFileSync(filePath, `${next.trimEnd()}\n`, { mode: 0o600 });
 };
 
+const writeOpenClawRootConfig = ({ filePath, server }) => {
+  const config = safeReadJson(filePath);
+  config.mcp = {
+    ...(config.mcp || {}),
+    servers: {
+      ...(config.mcp?.servers || {}),
+      'noeis-wiki': { transport: 'stdio', ...server }
+    }
+  };
+  writeJsonFile(filePath, config);
+  return filePath;
+};
+
 const writeRuntimeMcpConfig = ({ runtime, apiUrl, configDir, env = process.env } = {}) => {
-  const home = os.homedir();
+  const home = env.HOME || os.homedir();
   const server = mcpServerConfig({ configDir, apiUrl });
   if (runtime === 'codex') {
     const filePath = path.join(home, '.codex', 'config.toml');
@@ -172,6 +204,11 @@ const writeRuntimeMcpConfig = ({ runtime, apiUrl, configDir, env = process.env }
     delete config['noeis-wiki'];
   }
   writeJsonFile(filePath, config);
+  if (runtime === 'openclaw') {
+    const rootConfigPath = path.join(home, '.openclaw', 'openclaw.json');
+    writeOpenClawRootConfig({ filePath: rootConfigPath, server });
+    return [filePath, rootConfigPath];
+  }
   return filePath;
 };
 
@@ -254,6 +291,10 @@ const runLogin = async (args, context) => {
 };
 
 const runConnect = async (args, context) => {
+  if (args.includes('--help') || args.includes('-h')) {
+    context.io.stdout.write(CONNECT_HELP);
+    return;
+  }
   const auth = resolveAuth(context);
   const positional = compactArgs(args);
   const runtime = normalizeRuntime(positional[0] || optionValue(args, '--runtime'));
@@ -326,8 +367,11 @@ const runConnect = async (args, context) => {
     io.stderr.write(`Connected, but the access check failed: ${error.message || error}\n`);
   }
   io.stdout.write(`Saved Noeis CLI config to ${configPath}\n`);
-  if (runtimeConfigPath) io.stdout.write(`Updated ${runtimeLabel(runtime)} MCP config at ${runtimeConfigPath}\n`);
-  if (runtimeConfigPath) io.stdout.write(`Runtime config reads the token from ${configPath}; no raw token was copied into MCP config.\n`);
+  const runtimeConfigPaths = Array.isArray(runtimeConfigPath) ? runtimeConfigPath : (runtimeConfigPath ? [runtimeConfigPath] : []);
+  runtimeConfigPaths.forEach((filePath) => {
+    io.stdout.write(`Updated ${runtimeLabel(runtime)} MCP config at ${filePath}\n`);
+  });
+  if (runtimeConfigPaths.length) io.stdout.write(`Runtime config reads the token from ${configPath}; no raw token was copied into MCP config.\n`);
   if (hasFlag(args, '--print-token')) io.stdout.write(`${approved.secret}\n`);
 };
 

package/src/config.js

@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 
-export const DEFAULT_API_URL = 'https://api.noeis.io';
+export const DEFAULT_API_URL = 'https://note-taker-3-unrg.onrender.com';
 export const DEFAULT_APP_URL = 'https://www.noeis.io';
 
 export const resolveConfigDir = ({ env = process.env } = {}) => (