@higrowth/cli 0.1.0 → 0.2.0

package/README.md

@@ -1,15 +1,17 @@
 # @higrowth/cli
 
 Log in to a Higrowth workspace from your terminal and install the
-Claude Code skills that drive it. The replacement for `cp -r skills/
-higrowth ~/.claude/skills/` and copy-paste tokens.
+Higrowth playbook skills into your AI agent of choice. Supports
+**Claude Code**, **Claude Desktop**, **Cursor**, and **Codex**
+(CLI + Desktop + IDE extension share one config). Replaces the old
+`cp -r skills/higrowth ~/.claude/skills/` + copy-paste-token dance.
 
 ## Install
 
 ```bash
 npm install -g @higrowth/cli
 # or, for the curl-piped flow:
-curl -fsSL https://hg-engine.app/install.sh | sh
+curl -fsSL https://app.higrowth.ai/install.sh | sh
 ```
 
 ## Quick start
@@ -33,7 +35,7 @@ higrowth skills install
 | `higrowth login [--host URL] [--device]` | Browser-auth handshake (PKCE by default; `--device` for SSH/containers). Writes the MCP entry into `~/.claude/mcp.json`. |
 | `higrowth whoami` | Show the currently-configured workspace + token name. |
 | `higrowth logout` | Remove the higrowth entry from `~/.claude/mcp.json`. Local-only — does NOT revoke the token (do that in Settings). |
-| `higrowth skills install [--target TARGET]` | Copy the five skill files into your agent's skills dir. Auto-detects Claude Code, Cursor, Claude Desktop; pass `--target claude\|cursor\|claude-desktop\|all` to override. |
+| `higrowth skills install [--target TARGET]` | Copy the five skill files into your agent's skills dir. Auto-detects Claude Code / Cursor / Claude Desktop / Codex; pass `--target claude\|cursor\|claude-desktop\|codex\|all` to override. |
 | `higrowth skills list` | Show installed skills + which are out of date relative to the bundle. |
 | `higrowth skills update` | Re-install (overwrite) the latest skill versions. |
 
@@ -41,19 +43,30 @@ higrowth skills install
 
 | Flag | Default | What it does |
 |------|---------|--------------|
-| `--host URL` | `https://hg-engine.app` | Override the Higrowth host (for self-hosted or staging). |
+| `--host URL` | `https://app.higrowth.ai` | Override the Higrowth host (for self-hosted or staging). |
 | `--device` | off | Use OAuth 2.0 device-code flow instead of PKCE. For SSH / containers. |
-| `--target TARGET` | auto-detect | `claude` / `cursor` / `claude-desktop` / `all`. |
+| `--target TARGET` | auto-detect | `claude` / `cursor` / `claude-desktop` / `codex` / `all`. `codex` covers Codex CLI + Desktop + IDE extension via one shared `~/.codex/config.toml`. |
 | `--config PATH` | platform default | Override the MCP config file path. |
 
+## Where things land
+
+| Target | MCP config | Skills dir |
+|--------|------------|------------|
+| `claude` (Claude Code) | `~/.claude/mcp.json` | `~/.claude/skills/<slug>/SKILL.md` |
+| `cursor` | `~/.cursor/mcp.json` | `~/.cursor/skills/<slug>/SKILL.md` |
+| `claude-desktop` | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) | `~/Library/Application Support/Claude/skills/<slug>/SKILL.md` |
+| `codex` | `~/.codex/config.toml` (TOML, not JSON) | `~/.agents/skills/<slug>/SKILL.md` |
+
+For Codex specifically: one write covers Codex CLI, Codex Desktop, and the Codex IDE extension because all three read the same `~/.codex/config.toml`. No per-app duplication.
+
 ## What it does NOT do
 
 - Doesn't manage tokens server-side. Token rotation / revocation
   happens in the Higrowth UI under Settings → API tokens.
 - Doesn't restart Claude Code for you. After `login` or `skills
   install`, restart manually so the new config takes effect.
-- Doesn't store secrets outside `~/.claude/mcp.json` (mode 600 where
-  possible).
+- Doesn't store secrets outside the per-target config file you're
+  installing into (mode 600 where the filesystem supports it).
 
 ## License
 

package/dist/index.js

@@ -74,12 +74,14 @@ function base64UrlEncode(buf) {
 import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from "fs";
 import { dirname, join } from "path";
 import { homedir, platform } from "os";
+import TOML from "@iarna/toml";
 function configPaths() {
   const home = homedir();
   return [
-    { target: "claude", path: join(home, ".claude", "mcp.json") },
-    { target: "cursor", path: join(home, ".cursor", "mcp.json") },
-    { target: "claude-desktop", path: claudeDesktopPath(home) }
+    { target: "claude", path: join(home, ".claude", "mcp.json"), format: "json", label: "Claude Code" },
+    { target: "cursor", path: join(home, ".cursor", "mcp.json"), format: "json", label: "Cursor" },
+    { target: "claude-desktop", path: claudeDesktopPath(home), format: "json", label: "Claude Desktop" },
+    { target: "codex", path: join(home, ".codex", "config.toml"), format: "toml", label: "Codex (CLI + Desktop + IDE)" }
   ];
 }
 function claudeDesktopPath(home) {
@@ -118,55 +120,73 @@ function resolveConfigPath(target) {
   if (!found) throw new Error(`Unknown target: ${resolved}`);
   return found;
 }
-function readConfig(path) {
+function serversKey(format) {
+  return format === "toml" ? "mcp_servers" : "mcpServers";
+}
+function headersKey(format) {
+  return format === "toml" ? "http_headers" : "headers";
+}
+function readConfig(path, format) {
   if (!existsSync(path)) return {};
+  const raw = readFileSync(path, "utf-8");
   try {
-    const raw = readFileSync(path, "utf-8");
-    return JSON.parse(raw);
+    return format === "toml" ? TOML.parse(raw) : JSON.parse(raw);
   } catch (err) {
     throw new Error(
       `Could not parse existing MCP config at ${path}: ${err instanceof Error ? err.message : String(err)}`
     );
   }
 }
+function serialize(cfg, format) {
+  if (format === "toml") {
+    return TOML.stringify(cfg);
+  }
+  return `${JSON.stringify(cfg, null, 2)}
+`;
+}
 function writeHigrowthEntry(input) {
-  const existing = readConfig(input.path);
+  const existing = readConfig(input.path, input.format);
+  const sk = serversKey(input.format);
+  const hk = headersKey(input.format);
+  const existingServers = existing[sk] ?? {};
   const next = {
     ...existing,
-    mcpServers: {
-      ...existing.mcpServers ?? {},
+    [sk]: {
+      ...existingServers,
       higrowth: {
         url: `${input.host}/api/mcp`,
-        headers: {
+        [hk]: {
           Authorization: `Bearer ${input.token}`
         }
       }
     }
   };
   mkdirSync(dirname(input.path), { recursive: true });
-  writeFileSync(input.path, `${JSON.stringify(next, null, 2)}
-`, "utf-8");
+  writeFileSync(input.path, serialize(next, input.format), "utf-8");
   tryChmod600(input.path);
 }
-function removeHigrowthEntry(path) {
+function removeHigrowthEntry(path, format) {
   if (!existsSync(path)) return false;
-  const existing = readConfig(path);
-  if (!existing.mcpServers || !existing.mcpServers.higrowth) return false;
-  const { higrowth: _, ...rest } = existing.mcpServers;
-  const next = { ...existing, mcpServers: rest };
+  const existing = readConfig(path, format);
+  const sk = serversKey(format);
+  const servers = existing[sk];
+  if (!servers || !servers.higrowth) return false;
+  const { higrowth: _drop, ...rest } = servers;
+  const next = { ...existing, [sk]: rest };
   if (Object.keys(rest).length === 0) {
-    delete next.mcpServers;
+    delete next[sk];
   }
-  writeFileSync(path, `${JSON.stringify(next, null, 2)}
-`, "utf-8");
+  writeFileSync(path, serialize(next, format), "utf-8");
   return true;
 }
-function readHigrowthEntry(path) {
+function readHigrowthEntry(path, format) {
   if (!existsSync(path)) return null;
-  const cfg = readConfig(path);
-  const entry = cfg.mcpServers?.higrowth;
+  const cfg = readConfig(path, format);
+  const servers = cfg[serversKey(format)];
+  const entry = servers?.higrowth;
   if (!entry?.url) return null;
-  const authHeader = entry.headers?.Authorization ?? "";
+  const headers = entry[headersKey(format)] ?? {};
+  const authHeader = headers.Authorization ?? "";
   const match = authHeader.match(/^Bearer\s+(\S+)$/);
   if (!match) return null;
   return { url: entry.url, token: match[1] };
@@ -196,8 +216,14 @@ async function loginCommand(opts) {
   } else {
     ({ token, organizationId } = await runPkceFlow(api, client));
   }
-  const cfg = opts.configOverride !== void 0 ? { target: opts.target === "auto" ? "claude" : opts.target, path: opts.configOverride } : resolveConfigPath(opts.target);
-  writeHigrowthEntry({ path: cfg.path, host, token });
+  const cfg = opts.configOverride !== void 0 ? {
+    target: opts.target === "auto" ? "claude" : opts.target,
+    path: opts.configOverride,
+    // Infer format from extension when the user supplied a custom path.
+    // `.toml` → codex-style; anything else (.json by convention) → JSON.
+    format: opts.configOverride.toLowerCase().endsWith(".toml") ? "toml" : "json"
+  } : resolveConfigPath(opts.target);
+  writeHigrowthEntry({ path: cfg.path, format: cfg.format, host, token });
   process.stdout.write(`
 \u2713 Logged in to ${host}
 `);
@@ -306,7 +332,7 @@ function tryHostname() {
 async function logoutCommand() {
   let removed = 0;
   for (const cfg of configPaths()) {
-    if (removeHigrowthEntry(cfg.path)) {
+    if (removeHigrowthEntry(cfg.path, cfg.format)) {
       process.stdout.write(`\u2713 Removed higrowth entry from ${cfg.path}
 `);
       removed += 1;
@@ -325,24 +351,25 @@ async function logoutCommand() {
 async function whoamiCommand() {
   let foundAny = false;
   for (const cfg of configPaths()) {
-    const entry = readHigrowthEntry(cfg.path);
+    const entry = readHigrowthEntry(cfg.path, cfg.format);
     if (!entry) continue;
     foundAny = true;
-    process.stdout.write(`${cfg.target.padEnd(15)}  ${entry.url}
+    const heading = cfg.label.padEnd(28);
+    process.stdout.write(`${heading}  ${entry.url}
 `);
-    process.stdout.write(`${"".padEnd(15)}  ${maskToken(entry.token)}
+    process.stdout.write(`${"".padEnd(28)}  ${maskToken(entry.token)}
 `);
-    process.stdout.write(`${"".padEnd(15)}  ${cfg.path}
+    process.stdout.write(`${"".padEnd(28)}  ${cfg.path}
 
 `);
     const summary = await probeToken(entry.url, entry.token);
     if (summary) {
-      process.stdout.write(`${"".padEnd(15)}  \u2713 ${summary}
+      process.stdout.write(`${"".padEnd(28)}  \u2713 ${summary}
 
 `);
     } else {
       process.stdout.write(
-        `${"".padEnd(15)}  \u2717 token did not authenticate (revoked or stale?)
+        `${"".padEnd(28)}  \u2717 token did not authenticate (revoked or stale?)
 
 `
       );
@@ -1027,7 +1054,7 @@ async function skillsInstallCommand(opts) {
   const targets = resolveTargets(opts.target);
   if (targets.length === 0) {
     process.stdout.write(
-      "No supported skills directory detected. Pass --target claude|cursor|claude-desktop|all.\n"
+      "No supported skills directory detected. Pass --target claude|cursor|claude-desktop|codex|all.\n"
     );
     process.exitCode = 1;
     return;
@@ -1089,7 +1116,8 @@ function resolveTargets(t) {
   const all = [
     "claude",
     "cursor",
-    "claude-desktop"
+    "claude-desktop",
+    "codex"
   ];
   if (t === "all") return all;
   if (t === "auto") {
@@ -1102,6 +1130,7 @@ function skillsDir(t) {
   const home = homedir2();
   if (t === "claude") return join2(home, ".claude", "skills");
   if (t === "cursor") return join2(home, ".cursor", "skills");
+  if (t === "codex") return join2(home, ".agents", "skills");
   if (platform3() === "darwin") {
     return join2(home, "Library", "Application Support", "Claude", "skills");
   }
@@ -1129,8 +1158,8 @@ function compareSkill(path, skill) {
 }
 
 // src/index.ts
-var VERSION = "0.1.0";
-var DEFAULT_HOST = "https://hg-engine.app";
+var VERSION = "0.1.1";
+var DEFAULT_HOST = "https://app.higrowth.ai";
 var USAGE = `higrowth \u2014 Connect your agent to a Higrowth workspace
 
 USAGE
@@ -1167,13 +1196,15 @@ FLAGS
   --host URL          Override Higrowth host (default: ${DEFAULT_HOST}).
   --device            Use OAuth device-code flow instead of PKCE.
   --target TARGET     One of: auto (default) | claude | cursor |
-                      claude-desktop | all.
+                      claude-desktop | codex | all.
+                      codex covers Codex CLI, Codex Desktop, and the
+                      Codex IDE extension \u2014 they share one config.
   --config PATH       Override the MCP config file path.
 
 EXAMPLES
   higrowth login
   higrowth login --device
-  higrowth login --host https://staging.hg-engine.app
+  higrowth login --host https://staging.app.higrowth.ai
   higrowth skills install --target all
   higrowth whoami
 `;
@@ -1207,11 +1238,11 @@ function resolveTarget(raw) {
   if (raw === void 0) return "auto";
   if (raw === true) return "auto";
   const s = String(raw).toLowerCase();
-  if (s === "auto" || s === "claude" || s === "cursor" || s === "claude-desktop" || s === "all") {
+  if (s === "auto" || s === "claude" || s === "cursor" || s === "claude-desktop" || s === "codex" || s === "all") {
     return s;
   }
   throw new Error(
-    `Unknown target "${s}". Use auto | claude | cursor | claude-desktop | all.`
+    `Unknown target "${s}". Use auto | claude | cursor | claude-desktop | codex | all.`
   );
 }
 async function main() {
@@ -1236,7 +1267,7 @@ async function main() {
     case "login":
       if (target === "all") {
         process.stderr.write(
-          "login writes to a single config file. Use --target claude | cursor | claude-desktop (or omit for auto-detect). To install skills across all agents, use `higrowth skills install --target all` after login.\n"
+          "login writes to a single config file. Use --target claude | cursor | claude-desktop | codex (or omit for auto-detect). To install skills across all agents, use `higrowth skills install --target all` after login.\n"
         );
         process.exitCode = 2;
         return;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@higrowth/cli",
-  "version": "0.1.0",
-  "description": "Higrowth CLI — log in via browser, install Claude Code skills, manage the MCP connection.",
+  "version": "0.2.0",
+  "description": "Higrowth CLI — log in via browser, install Claude Code / Codex skills, manage the MCP connection.",
   "type": "module",
   "license": "Apache-2.0",
   "bin": {
@@ -23,6 +23,7 @@
     "access": "public"
   },
   "devDependencies": {
+    "@types/iarna__toml": "^2.0.5",
     "@types/node": "^22.10.5",
     "tsup": "^8.5.0",
     "typescript": "^5.6.3"
@@ -33,5 +34,8 @@
     "type": "git",
     "url": "git+https://github.com/higrowth-ai/hg-engine.git",
     "directory": "cli"
+  },
+  "dependencies": {
+    "@iarna/toml": "^2.2.5"
   }
 }