Skip to content

nanocoai/nanoclaw / .claude/skills/add-cursor

add-cursor

Flagged

Use Cursor (local Agent SDK) as a full agent provider — planning, tool orchestration, MCP tools, session resume — alongside or instead of Claude. Cursor-account sign-in or API key, held by the credential gateway. Per-group via `ncl groups config update --provider cursor`. Distinct from using Cursor as a cloud agent (those run on Cursor VMs and are not this provider).

payload/container/agent-runner/src/providers/cursor-auth.ts

View on GitHub
/**
 * Host-side Cursor SDK login helper.
 *
 * This file lives in the agent-runner package so Bun can resolve @cursor/sdk
 * without adding it to the host pnpm tree. It mints an expiring user API key
 * with Cursor.auth.login({ store: null }) and writes the key directly to a
 * caller-owned, mode-0600 file. The credential is never printed or placed in
 * argv; setup reads that file into the credential gateway and deletes it.
 */
import fs from 'fs';

import { Cursor, type SdkLoginOptions, type SdkLoginResult } from '@cursor/sdk';

import { TIMEZONE, formatLocalTime } from '../timezone.js';

type Login = (options?: SdkLoginOptions) => Promise<SdkLoginResult>;

interface LoginHelperOptions {
  outputPath: string;
  openBrowser: boolean;
  login?: Login;
  onLoginUrl?: (url: string) => void;
}

export async function mintCursorApiKey({
  outputPath,
  openBrowser,
  login = Cursor.auth.login,
  onLoginUrl = (url) => console.error(`Open this URL to connect Cursor:\n${url}`),
}: LoginHelperOptions): Promise<{ email?: string; apiKeyExpiresAtMs: number }> {
  const result = await login({
    store: null,
    openBrowser,
    onLoginUrl,
    apiKeyName: 'NanoClaw',
  });
  if (typeof result.apiKey !== 'string' || result.apiKey.length === 0) {
    throw new Error('Cursor login returned an empty API key');
  }

  fs.writeFileSync(outputPath, result.apiKey, {
    encoding: 'utf-8',
    flag: 'wx',
    mode: 0o600,
  });
  fs.chmodSync(outputPath, 0o600);

  return {
    email: result.email,
    apiKeyExpiresAtMs: result.apiKeyExpiresAtMs,
  };
}

/** Operator-facing login summary. Never includes the key. */
export function formatMintedKeyMessage(result: { email?: string; apiKeyExpiresAtMs: number }): string {
  const identity = result.email ? ` as ${result.email}` : '';
  const expiry = formatLocalTime(new Date(result.apiKeyExpiresAtMs).toISOString(), TIMEZONE);
  return `Cursor account connected${identity}; the minted key was handed to the local vault. Expires ${expiry}.`;
}

export function parseCursorAuthArgs(argv: string[]): { outputPath: string; openBrowser: boolean } {
  const outputIndex = argv.indexOf('--output');
  const outputPath = outputIndex >= 0 ? argv[outputIndex + 1] : undefined;
  if (!outputPath) {
    throw new Error('Usage: bun cursor-auth.ts --output <mode-0600-path> [--no-browser]');
  }
  return {
    outputPath,
    openBrowser: !argv.includes('--no-browser'),
  };
}

if (import.meta.main) {
  try {
    const options = parseCursorAuthArgs(process.argv.slice(2));
    const result = await mintCursorApiKey(options);
    console.log(formatMintedKeyMessage(result));
  } catch {
    // Keep this deliberately generic: SDK/filesystem errors must never echo a
    // credential into setup's inherited terminal or logs.
    console.error('Cursor sign-in failed before the credential reached the vault.');
    process.exitCode = 1;
  }
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall