cursor-keys 1.1.0 → 1.2.1

package/README.md

@@ -1,27 +1,42 @@
-# cursor-keys
+<div align="center">
 
-> Per-project Cursor profiles so every window automatically uses the right BYOK API key. Two windows, two projects, two keys, zero switching.
+```
+ ██████╗██╗   ██╗██████╗ ███████╗ ██████╗ ██████╗     ██╗  ██╗███████╗██╗   ██╗███████╗
+██╔════╝██║   ██║██╔══██╗██╔════╝██╔═══██╗██╔══██╗    ██║ ██╔╝██╔════╝╚██╗ ██╔╝██╔════╝
+██║     ██║   ██║██████╔╝███████╗██║   ██║██████╔╝    █████╔╝ █████╗   ╚████╔╝ ███████╗
+██║     ██║   ██║██╔══██╗╚════██║██║   ██║██╔══██╗    ██╔═██╗ ██╔══╝    ╚██╔╝  ╚════██║
+╚██████╗╚██████╔╝██║  ██║███████║╚██████╔╝██║  ██║    ██║  ██╗███████╗   ██║   ███████║
+ ╚═════╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝ ╚═════╝ ╚═╝  ╚═╝    ╚═╝  ╚═╝╚══════╝   ╚═╝   ╚══════╝
+```
 
-Cursor stores your OpenAI-compatible API key (Bonzai, LiteLLM, AI Gateway, ...) **once per profile**, not per repo. If you bill five client projects, you either babysit Settings all day or bill the wrong project. `cursor-keys` gives each project its own isolated profile and makes opening, switching, and checking keys automatic.
+**Per-project Cursor profiles so every window uses the right BYOK API key.**
 
-```
-  ╔═╗┬ ┬┬─┐┌─┐┌─┐┬─┐  ┬┌─┌─┐┬ ┬┌─┐
-  │  │ │├┬┘└─┐│ │├┬┘  ├┴┐├┤ └┬┘└─┐
-  └─┘└─┘┴└─└─┘└─┘┴└─  ┴ ┴└─┘ ┴ └─┘  per-project Cursor API keys
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%E2%89%A518-5FA04E.svg)](https://nodejs.org)
+[![Runtime dependencies](https://img.shields.io/badge/runtime%20deps-0-brightgreen.svg)](#development)
+
+[Website](https://l-ubu.github.io/cursor-keys/) · [Install](#install) · [Commands](#commands) · [Config](#config)
+
+</div>
+
+---
 
+Cursor stores your OpenAI-compatible API key (LiteLLM, Vercel AI Gateway, corporate proxy, ...) **once per profile**, not per repo. If you bill five client projects, you either babysit Settings all day or bill the wrong project. `cursor-keys` gives each project its own isolated profile and makes opening, switching, and checking keys automatic.
+
+```
 $ cursor-keys status
 
-  Project             | Color    | Windows | Key | Repo
-  --------------------+----------+---------+-----+-------------------------
-  famework-platform-1 | #339af0  | 1       | yes | ~/Projects/famework-platform-1
-  jlr_mss             | #4f8cff  | 0       | no  | ~/Projects/jlr_mss
-  nokia               | #845ef7  | 1       | yes | ~/Projects/nokia-main-cs
+  Project   | Color    | Windows | Key | Repo
+  ----------+----------+---------+-----+------------------
+  acme      | #4f8cff  | 1       | yes | ~/Projects/acme
+  client-a  | #51cf66  | 0       | no  | ~/Projects/client-a
+  client-b  | #845ef7  | 1       | yes | ~/Projects/client-b
 
-$ cursor-keys doctor nokia
+$ cursor-keys doctor acme
 
-  ✓ OpenAI/Bonzai API key row present
+  ✓ OpenAI API key row present
   ✓ Explore subagent overrides present
-  ✓ Base URL (connect.iobonzai.com/cursor) in profile state
+  ✓ Base URL (gateway.example.com/v1) in profile state
 ```
 
 ## Install
@@ -36,8 +51,8 @@ Requires Node ≥18, the Cursor CLI (`Shell Command: Install 'cursor' in PATH`),
 ## Quick start
 
 ```bash
-# one-time, only if your gateway is not the Bonzai default
-cursor-keys config baseUrl https://your-gateway.example.com/v1
+# one-time: point at your OpenAI-compatible gateway
+cursor-keys config baseUrl https://gateway.example.com/v1
 
 # one-time per project
 cursor-keys add acme --path ~/Projects/acme     # register + create profile
@@ -64,7 +79,7 @@ One window, one profile, one key. Each project gets an isolated `--user-data-dir
 
 Settings flow one way, main to profiles: `sync` re-copies your main `settings.json` into every profile and re-applies that profile's title bar color on top. `open` does this automatically before every launch, and open windows hot-reload the file, so tweaks in your main Cursor show up everywhere. Changes made inside a profile window are overwritten on the next sync.
 
-`clone` copies your main Cursor state (SQLite backup) so profiles open signed-in with your theme and model config. `set-key` encrypts your project key with Cursor's own safeStorage (Chromium OSCrypt, key from the "Cursor Safe Storage" Keychain item) and writes it into the profile's secret store, round-trip verified. macOS asks for Keychain permission once; click Always Allow.
+`clone` copies your main Cursor state (SQLite backup) so profiles open signed-in with your theme and model config. `set-key` encrypts your project key with Cursor's own safeStorage (Chromium OSCrypt, key from the "Cursor Safe Storage" macOS Keychain item) and writes it into the profile's secret store, round-trip verified. macOS asks for Keychain permission once; click Always Allow.
 
 ## "Which key am I on?" in three layers
 
@@ -83,7 +98,7 @@ Settings flow one way, main to profiles: `sync` re-copies your main `settings.js
 | `open [name]`                                  | Launch Cursor with the profile (auto-detect from cwd)        |
 | `status`                                       | Projects, colors, running windows, key configured            |
 | `current`                                      | Mapping for the current directory                            |
-| `config [baseUrl [URL]]`                       | Show or set the gateway base URL                             |
+| `config [get <key> · baseUrl [URL]]`           | Show summary, print one value, or set the gateway base URL   |
 | `sync [name]`                                  | Re-copy main Cursor settings into profiles                   |
 | `doctor [name]`                                | Health checks: key row, base URL, subagent overrides         |
 | `wrap [--install]`                             | zsh function so plain `cursor <path>` auto-picks the profile |
@@ -98,14 +113,21 @@ Settings flow one way, main to profiles: `sync` re-copies your main `settings.js
 ```json
 {
   "profilesRoot": "~/.cursor-profiles",
-  "baseUrl": "https://connect.iobonzai.com/cursor",
+  "baseUrl": "https://gateway.example.com/v1",
   "projects": {
     "acme": { "path": "~/Projects/acme", "color": "#4f8cff" }
   }
 }
 ```
 
-`baseUrl` is your gateway's OpenAI-compatible endpoint (Bonzai default; point it at LiteLLM, Vercel AI Gateway, ...). `doctor` verifies it per profile.
+`baseUrl` is your gateway's OpenAI-compatible endpoint. `doctor` verifies it per profile.
+
+Read a single value for scripts (stdout only, exit 1 on unknown keys):
+
+```bash
+cursor-keys config get baseUrl
+cursor-keys config get profilesRoot
+```
 
 ## Security
 

package/bin/cursor-keys.mjs

@@ -1,12 +1,15 @@
 #!/usr/bin/env node
 
 import { runCommand } from "../src/commands.mjs";
-import { bold, cyan, dim, reset } from "../src/ansi.mjs";
+import { bold, dim, reset, yellow } from "../src/ansi.mjs";
 
 const BANNER = `
- ${cyan}╔═╗┬ ┬┬─┐┌─┐┌─┐┬─┐  ┬┌─┌─┐┬ ┬┌─┐
- ${cyan}│  │ │├┬┘└─┐│ │├┬┘  ├┴┐├┤ └┬┘└─┐
- ${cyan}└─┘└─┘┴└─└─┘└─┘┴└─  ┴ ┴└─┘ ┴ └─┘${dim}  per-project Cursor API keys
+ ${yellow} ██████╗██╗   ██╗██████╗ ███████╗ ██████╗ ██████╗     ██╗  ██╗███████╗██╗   ██╗███████╗
+ ${yellow}██╔════╝██║   ██║██╔══██╗██╔════╝██╔═══██╗██╔══██╗    ██║ ██╔╝██╔════╝╚██╗ ██╔╝██╔════╝
+ ${yellow}██║     ██║   ██║██████╔╝███████╗██║   ██║██████╔╝    █████╔╝ █████╗   ╚████╔╝ ███████╗
+ ${yellow}██║     ██║   ██║██╔══██╗╚════██║██║   ██║██╔══██╗    ██╔═██╗ ██╔══╝    ╚██╔╝  ╚════██║
+ ${yellow}╚██████╗╚██████╔╝██║  ██║███████║╚██████╔╝██║  ██║    ██║  ██╗███████╗   ██║   ███████║
+ ${yellow} ╚═════╝ ╚═════╝ ╚═╝  ╚═╝╚══════╝ ╚═════╝ ╚═╝  ╚═╝    ╚═╝  ╚═╝╚══════╝   ╚═╝   ╚══════╝${reset}${dim}  per-project Cursor API keys
 `;
 
 function printHelp() {
@@ -31,7 +34,7 @@ function printHelp() {
   );
   console.log("  current                     Show mapping for cwd");
   console.log(
-    "  config [baseUrl [URL]]      Show or set config (gateway base URL)",
+    "  config [get <key>|baseUrl [URL]]  Show, read, or set config values",
   );
   console.log(
     "  sync [name]                 Re-copy main Cursor settings into profiles",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cursor-keys",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "Per-project Cursor profiles so each window uses the correct BYOK API key. Zero dependencies.",
   "type": "module",
   "bin": {
@@ -19,7 +19,6 @@
     "cursor",
     "cli",
     "api-key",
-    "bonzai",
     "byok",
     "developer-tools",
     "productivity"

package/src/commands.mjs

@@ -8,8 +8,10 @@ import {
   baseUrlFragment,
   collapseHome,
   CONFIG_FILE,
+  CONFIG_GETTABLE_KEYS,
   expandHome,
   findProjectByPath,
+  getConfigValue,
   getProject,
   loadConfig,
   pickColorForName,
@@ -177,12 +179,30 @@ function ask(question) {
 async function cmdConfig(args) {
   const { flags, positional } = parseFlags(args);
   if (flags.help) {
-    console.log("Usage: cursor-keys config [baseUrl [URL]]");
+    console.log(
+      "Usage: cursor-keys config                      Show config summary",
+    );
+    console.log(
+      "       cursor-keys config get <key>            Print one value (baseUrl, profilesRoot)",
+    );
+    console.log(
+      "       cursor-keys config baseUrl <URL>        Set gateway base URL",
+    );
     return;
   }
   const config = loadConfig();
   const [key, value] = positional;
 
+  if (key === "get") {
+    if (!value) {
+      throw new Error(
+        `Missing config key. Usage: cursor-keys config get <${CONFIG_GETTABLE_KEYS.join("|")}>`,
+      );
+    }
+    console.log(getConfigValue(config, value));
+    return;
+  }
+
   if (!key) {
     const count = Object.keys(config.projects).length;
     console.log(
@@ -295,7 +315,7 @@ async function cmdInit(args) {
   }
   saveConfig(config);
   console.log(
-    `\nNext: cursor-keys add <name> --clone main   (creates profile + copies Bonzai settings)`,
+    `\nNext: cursor-keys add <name> --clone main   (creates profile + copies main Cursor settings)`,
   );
 }
 
@@ -516,7 +536,7 @@ async function cmdDoctor(args) {
     if (fs.existsSync(db)) {
       const hasKey = stateDbHasKey(db, SECRET_OPENAI_KEY);
       console.log(
-        `  ${hasKey ? ok("✓") : warn("✗")} OpenAI/Bonzai API key row present`,
+        `  ${hasKey ? ok("✓") : warn("✗")} OpenAI API key row present`,
       );
       if (hasKey) {
         const mainDb = path.join(

package/src/config.mjs

@@ -98,6 +98,21 @@ export function baseUrlFragment(config) {
   return String(config.baseUrl || "").replace(/^https?:\/\//, "");
 }
 
+export const CONFIG_GETTABLE_KEYS = ["baseUrl", "profilesRoot"];
+
+/**
+ * @param {ReturnType<typeof loadConfig>} config
+ * @param {string} key
+ */
+export function getConfigValue(config, key) {
+  if (!CONFIG_GETTABLE_KEYS.includes(key)) {
+    throw new Error(
+      `Unknown config key: ${key}. Known keys: ${CONFIG_GETTABLE_KEYS.join(", ")}`,
+    );
+  }
+  return config[key];
+}
+
 const COLOR_PALETTE = [
   "#4f8cff",
   "#ff6b6b",

package/src/profile.mjs

@@ -143,22 +143,50 @@ export function needsFirstRunChecklist(profileDir) {
   return !fs.existsSync(path.join(profileDir, SETUP_MARKER));
 }
 
+/**
+ * @param {string} projectName
+ * @param {string} baseUrl
+ * @param {string} platform Node process.platform
+ */
+export function buildFirstRunChecklist(
+  projectName,
+  baseUrl = "https://gateway.example.com/v1",
+  platform = process.platform,
+) {
+  if (platform === "darwin") {
+    return `
+First-time setup for "${projectName}" · copy-paste in order:
+
+  cursor-keys clone ${projectName}    # inherit sign-in, settings, model config from main Cursor
+  cursor-keys set-key ${projectName}  # inject the project API key (encrypted, hidden prompt)
+  cursor-keys doctor ${projectName}   # verify the profile
+
+Manual alternative: Cursor Settings → Models → API keys, paste the key under
+OpenAI API Key, enable "Override OpenAI Base URL" with: ${baseUrl}
+
+Already inside this profile's window? Close it before running clone or set-key.
+`;
+  }
+
+  return `
+First-time setup for "${projectName}" · copy-paste in order:
+
+  cursor-keys clone ${projectName}    # inherit sign-in, settings, model config from main Cursor
+  cursor-keys open ${projectName}     # open once so Cursor creates its state
+  cursor-keys doctor ${projectName}   # verify the profile
+
+Then in that window: Cursor Settings → Models → API keys, paste the key under
+OpenAI API Key, enable "Override OpenAI Base URL" with: ${baseUrl}
+
+Already inside this profile's window? Close it before running clone.
+`;
+}
+
 export function printFirstRunChecklist(
   projectName,
-  baseUrl = "https://connect.iobonzai.com/cursor",
+  baseUrl = "https://gateway.example.com/v1",
 ) {
-  console.log(`
-First-time setup for "${projectName}" in this Cursor profile:
-
-  1. Cursor Settings → Models → API keys
-  2. Paste your project Bonzai API key under OpenAI API Key
-  3. Enable "Use OpenAI API Key" and "Override OpenAI Base URL"
-  4. Base URL: ${baseUrl}
-  5. Explore Subagent Model: Composer 2.5
-  6. Add custom Bonzai models and disable non-Bonzai models
-
-Then run: cursor-keys doctor ${projectName}
-`);
+  console.log(buildFirstRunChecklist(projectName, baseUrl, process.platform));
 }
 
 export function createProfile({ profileDir, projectName, color, cloneFrom }) {