cursor-keys 1.2.3 → 1.2.4

package/README.md

@@ -91,23 +91,24 @@ Settings flow one way, main to profiles: `sync` re-copies your main `settings.js
 
 ## Commands
 
-| Command                                        | What it does                                                 |
-| ---------------------------------------------- | ------------------------------------------------------------ |
-| `init [--root DIR] [--all]`                    | Discover git repos and register them                         |
-| `add <name> [--path] [--color] [--clone main]` | Create a project profile                                     |
-| `clone <name> [--from main]`                   | Copy sign-in + settings + model config from a donor profile  |
-| `set-key <name> [--key sk-...]`                | Inject the project API key (encrypted, verified)             |
-| `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 [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 |
+| Command                                        | What it does                                                    |
+| ---------------------------------------------- | --------------------------------------------------------------- |
+| `init [--root DIR] [--all]`                    | Discover git repos and register them                            |
+| `add <name> [--path] [--color] [--clone main]` | Create a project profile                                        |
+| `clone <name> [--from main]`                   | Copy sign-in + settings + model config from a donor profile     |
+| `set-key <name> [--key sk-...]`                | Inject the project API key (encrypted, verified)                |
+| `color <name> [#hex]`                          | Show or set the project title bar color                         |
+| `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 [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    |
 | `aliases [--install]`                          | Per-project shell aliases (also `ck` shortcut + tab completion) |
-| `completion`                                   | Print zsh tab completion (auto-sourced by `aliases --install`) |
-| `install-extension`                            | Link the Cursor extension (auto-linked on global npm install) |
-| `rm <name> [--delete]`                         | Unregister (optionally delete the profile)                   |
+| `completion`                                   | Print zsh tab completion (auto-sourced by `aliases --install`)  |
+| `install-extension`                            | Link the Cursor extension (auto-linked on global npm install)   |
+| `rm <name> [--delete]`                         | Unregister (optionally delete the profile)                      |
 
 `cursor-keys ls` prints registered project names one per line for scripts and tab completion; it is hidden from `--help`.
 

package/bin/cursor-keys.mjs

@@ -27,6 +27,9 @@ function printHelp() {
   console.log(
     "  set-key <name>              Inject the project API key (encrypted)",
   );
+  console.log(
+    "  color <name> [#hex]         Show or set the project title bar color",
+  );
   console.log(
     "  open [name]                 Open Cursor with this project's profile",
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cursor-keys",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "Per-project Cursor profiles so each window uses the correct BYOK API key. Zero dependencies.",
   "type": "module",
   "bin": {

package/src/commands.mjs

@@ -13,6 +13,7 @@ import {
   findProjectByPath,
   getConfigValue,
   getProject,
+  isHexColor,
   loadConfig,
   pickColorForName,
   pickUnusedColor,
@@ -89,6 +90,8 @@ export async function runCommand(argv) {
       return cmdInstallExtension(rest);
     case "set-key":
       return cmdSetKey(rest);
+    case "color":
+      return cmdColor(rest);
     case "clone":
       return cmdClone(rest);
     case "rm":
@@ -637,7 +640,7 @@ function shellEscapeName(name) {
 }
 
 const COMPLETION_COMMANDS =
-  "init add clone set-key open status current config sync doctor aliases wrap install-extension completion ls rm";
+  "init add clone set-key color open status current config sync doctor aliases wrap install-extension completion ls rm";
 
 /**
  * Pure builder for the zsh completion script. Sourced via
@@ -648,7 +651,7 @@ export function completionScript() {
   return `#compdef cursor-keys ckeys ck
 _cursor_keys() {
   local -a projects
-  if (( CURRENT == 3 )) && [[ \${words[2]} == (open|clone|set-key|doctor|sync|rm) ]]; then
+  if (( CURRENT == 3 )) && [[ \${words[2]} == (open|clone|set-key|color|doctor|sync|rm) ]]; then
     projects=(\${(f)"$(cursor-keys ls 2>/dev/null)"})
     _describe 'project' projects
   else
@@ -843,6 +846,39 @@ async function cmdInstallExtension() {
   console.log(`Look for ${bold}$(key) <project>${reset} in the status bar.`);
 }
 
+async function cmdColor(args) {
+  const { flags, positional } = parseFlags(args);
+  if (flags.help) {
+    console.log("Usage: cursor-keys color <name> [#RRGGBB]");
+    console.log("Show or set the project's title bar color.");
+    return;
+  }
+  const name = positional[0];
+  if (!name) throw new Error("Usage: cursor-keys color <name> [#RRGGBB]");
+  const config = loadConfig();
+  const project = getProject(config, name);
+  if (!project) throw new Error(`Unknown project: ${name}. Run cursor-keys init or add.`);
+
+  const hex = positional[1];
+  if (!hex) {
+    console.log(`${blockSwatch(project.color)} ${project.color}`);
+    return;
+  }
+  if (!isHexColor(hex)) {
+    throw new Error(`Invalid color: ${hex} (expected #RRGGBB, e.g. #852e00)`);
+  }
+
+  updateConfig((c) => {
+    if (!c.projects[name]) throw new Error(`Unknown project: ${name}`);
+    c.projects[name].color = hex;
+  });
+  if (fs.existsSync(project.profileDir)) {
+    writeProfileSettings(project.profileDir, name, hex);
+  }
+  console.log(ok(`Color for ${name}: `) + `${blockSwatch(hex)} ${hex}`);
+  console.log(`${dim}Open Cursor windows reload settings automatically.${reset}`);
+}
+
 function promptHidden(question) {
   return new Promise((resolve) => {
     const rl = readline.createInterface({

package/src/config.mjs

@@ -24,6 +24,11 @@ export const DEFAULT_PROFILES_ROOT = path.join(
 
 const HEX_COLOR = /^#[0-9a-fA-F]{6}$/;
 
+/** @param {unknown} s */
+export function isHexColor(s) {
+  return typeof s === "string" && HEX_COLOR.test(s);
+}
+
 /** @param {string} p */
 export function expandHome(p) {
   if (!p || typeof p !== "string") return p;