smart-aipi 1.3.0 → 1.4.1

package/README.md

@@ -4,6 +4,19 @@ CLI for [Smart AIPI](https://smartaipi.com) — OpenAI-compatible API at 75% off
 
 ## Install
 
+### Install both packages (recommended)
+
+```bash
+npm install -g smart-aipi @smart-aipi/mcp
+```
+
+What each package provides:
+
+- `smart-aipi` (CLI): programmatic control for account, keys, tokens, and usage from terminal.
+- `@smart-aipi/mcp`: easy setup for AI agents through MCP with docs + management tools.
+
+### CLI only
+
 ```bash
 npm install -g smart-aipi
 ```

package/bin/cli.js

@@ -7,6 +7,7 @@ import inquirer from 'inquirer';
 import { createRequire } from 'node:module';
 import { DOCS, TOPIC_LIST, DOC_CATEGORIES } from '../lib/docs.js';
 import { registerLoginCommand, saveAuthState } from '../lib/login.js';
+import { registerSetupCommands } from '../lib/setup.js';
 const API_BASE = process.env.SMART_AIPI_URL || 'https://api.smartaipi.com';
 const WEB_BASE = process.env.SMART_AIPI_WEB_URL || 'https://smartaipi.com';
 const require = createRequire(import.meta.url);
@@ -22,6 +23,10 @@ registerLoginCommand(program, {
     apiBase: API_BASE,
     webBase: WEB_BASE
 });
+registerSetupCommands(program, {
+    config,
+    apiBase: API_BASE
+});
 program
     .command('signup')
     .description('Create a new Smart AIPI account')

package/lib/docs.js

@@ -7,16 +7,22 @@ export const DOCS = {
 
   Smart AIPI is an OpenAI-compatible API. Set two env vars and go.
 
-  ${chalk.cyan('1. Install & sign up')}
-  ${chalk.dim('$ npm install -g smart-aipi')}
+  ${chalk.cyan('1. Install both packages')}
+  ${chalk.dim('$ npm install -g smart-aipi @smart-aipi/mcp')}
+
+  ${chalk.dim('- smart-aipi CLI: programmatic account/key/token/usage control')}
+  ${chalk.dim('- @smart-aipi/mcp: easy AI-agent setup with MCP tools')}
+
+  ${chalk.cyan('2. Create account + credentials')}
   ${chalk.dim('$ smart-aipi signup')}
   ${chalk.dim('$ smart-aipi keys create')}
+  ${chalk.dim('$ smart-aipi tokens create -n "MCP Token"')}
 
-  ${chalk.cyan('2. Set environment variables')}
+  ${chalk.cyan('3. Set environment variables')}
   ${chalk.dim('export OPENAI_BASE_URL=https://api.smartaipi.com/v1')}
   ${chalk.dim('export OPENAI_API_KEY=sk-your-api-key')}
 
-  ${chalk.cyan('3. Use with any OpenAI-compatible tool')}
+  ${chalk.cyan('4. Use with any OpenAI-compatible tool')}
   Your existing code, SDKs, and AI tools work automatically.
 
   ${chalk.cyan('Available topics:')}

package/lib/setup.js

@@ -0,0 +1,387 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import inquirer from 'inquirer';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+// ─── Shared: get or create an API key ─────────────────────────────────────────
+async function getOrCreateKey(deps) {
+    const token = deps.config.get('token');
+    if (!token) {
+        console.log(chalk.red('Not logged in. Run: smart-aipi login'));
+        return null;
+    }
+    const { source } = await inquirer.prompt([{
+            type: 'list',
+            name: 'source',
+            message: 'API key source:',
+            choices: [
+                { name: 'Create a new key (recommended)', value: 'create' },
+                { name: 'Paste an existing key', value: 'paste' }
+            ]
+        }]);
+    if (source === 'paste') {
+        const { key } = await inquirer.prompt([{
+                type: 'input',
+                name: 'key',
+                message: 'API key:',
+                validate: (v) => v.startsWith('sk-') ? true : 'Key must start with sk-'
+            }]);
+        return key;
+    }
+    const spinner = ora('Creating API key...').start();
+    try {
+        const res = await fetch(`${deps.apiBase}/api/keys/create`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({ name: 'Auto-setup key' })
+        });
+        const data = await res.json();
+        if (!res.ok || !data.key) {
+            spinner.fail(chalk.red(data.error || 'Failed to create key'));
+            return null;
+        }
+        spinner.succeed(chalk.green('API key created'));
+        console.log(chalk.yellow('  Save this key — you won\'t see it again:'));
+        console.log(`  ${chalk.bold.cyan(data.key)}\n`);
+        return data.key;
+    }
+    catch (err) {
+        spinner.fail(chalk.red(`Error: ${err.message}`));
+        return null;
+    }
+}
+function writeJSON(filePath, data) {
+    const dir = join(filePath, '..');
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n');
+}
+function readJSON(filePath) {
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+// ─── Claude Code ──────────────────────────────────────────────────────────────
+async function setupClaude(deps) {
+    console.log(chalk.bold('\n  Setting up Claude Code with Smart AIPI\n'));
+    const home = homedir();
+    const settingsPath = join(home, '.claude', 'settings.json');
+    const claudeJsonPath = join(home, '.claude.json');
+    // Check for existing Claude Code installation with OAuth
+    const claudeJson = readJSON(claudeJsonPath);
+    if (claudeJson.oauthAccount) {
+        console.log(chalk.yellow('  Warning: Claude Code is already set up with an Anthropic account.'));
+        console.log(chalk.yellow('  Writing Smart AIPI env vars to the global settings will override'));
+        console.log(chalk.yellow('  your existing Anthropic connection.\n'));
+        const { proceed } = await inquirer.prompt([{
+                type: 'list',
+                name: 'proceed',
+                message: 'How would you like to proceed?',
+                choices: [
+                    { name: 'Show manual setup instructions (safe — no files changed)', value: 'manual' },
+                    { name: 'Write to global settings anyway (replaces Anthropic connection)', value: 'write' },
+                    { name: 'Cancel', value: 'cancel' }
+                ]
+            }]);
+        if (proceed === 'cancel')
+            return;
+        if (proceed === 'manual') {
+            const key = await getOrCreateKey(deps);
+            if (!key)
+                return;
+            console.log(chalk.cyan('\n  To use Smart AIPI with Claude Code, add this to'));
+            console.log(chalk.cyan('  ~/.claude/settings.json (or a project-level .claude/settings.json):\n'));
+            console.log(chalk.dim(`  {
+    "env": {
+      "ANTHROPIC_BASE_URL": "https://api.smartaipi.com",
+      "ANTHROPIC_API_KEY": "${key}",
+      "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
+    },
+    "model": "claude-opus-4-6"
+  }\n`));
+            console.log(chalk.dim('  Or export the env vars in your shell:\n'));
+            console.log(chalk.dim(`  export ANTHROPIC_BASE_URL=https://api.smartaipi.com`));
+            console.log(chalk.dim(`  export ANTHROPIC_API_KEY=${key}\n`));
+            console.log(chalk.dim('  Tip: Use a project-level .claude/settings.json to keep your'));
+            console.log(chalk.dim('  global Anthropic connection intact.\n'));
+            return;
+        }
+        // proceed === 'write' — fall through to write the settings
+    }
+    const key = await getOrCreateKey(deps);
+    if (!key)
+        return;
+    // Write ~/.claude/settings.json
+    const settings = readJSON(settingsPath);
+    settings.env = {
+        ...(settings.env || {}),
+        ANTHROPIC_BASE_URL: 'https://api.smartaipi.com',
+        ANTHROPIC_API_KEY: key,
+        ANTHROPIC_DEFAULT_HAIKU_MODEL: 'claude-haiku-4-5-20251001'
+    };
+    if (!settings.model)
+        settings.model = 'claude-opus-4-6';
+    writeJSON(settingsPath, settings);
+    // Patch ~/.claude.json to skip setup wizard
+    claudeJson.hasCompletedOnboarding = true;
+    writeJSON(claudeJsonPath, claudeJson);
+    console.log(chalk.green('  Claude Code configured!\n'));
+    console.log(chalk.dim('  Written:'));
+    console.log(chalk.dim(`    ${settingsPath}`));
+    console.log(chalk.dim(`    ${claudeJsonPath}\n`));
+    console.log(chalk.dim('  Model:  claude-opus-4-6 (high reasoning)'));
+    console.log(chalk.dim('  Haiku:  claude-haiku-4-5-20251001 (background tasks)'));
+    console.log(chalk.dim('  Backend: gpt-5.3-codex (transparent via x-actual-model header)\n'));
+    console.log(`  Run ${chalk.cyan('claude')} to start.\n`);
+}
+// ─── Codex CLI ────────────────────────────────────────────────────────────────
+async function setupCodex(deps) {
+    console.log(chalk.bold('\n  Setting up Codex CLI with Smart AIPI\n'));
+    const key = await getOrCreateKey(deps);
+    if (!key)
+        return;
+    const home = homedir();
+    const configDir = join(home, '.codex');
+    const configPath = join(configDir, 'config.toml');
+    if (!existsSync(configDir))
+        mkdirSync(configDir, { recursive: true });
+    // Write TOML config
+    const toml = `# Smart AIPI configuration
+model = "gpt-5.3-codex"
+
+[api]
+base_url = "https://api.smartaipi.com/v1"
+api_key = "${key}"
+`;
+    writeFileSync(configPath, toml);
+    console.log(chalk.green('  Codex CLI configured!\n'));
+    console.log(chalk.dim(`  Written: ${configPath}\n`));
+    console.log(chalk.dim('  Model: gpt-5.3-codex'));
+    console.log(chalk.dim('  Base URL: https://api.smartaipi.com/v1\n'));
+    console.log(`  Run ${chalk.cyan('codex "your prompt"')} to start.\n`);
+}
+// ─── OpenCode ─────────────────────────────────────────────────────────────────
+async function setupOpenCode(deps) {
+    console.log(chalk.bold('\n  Setting up OpenCode with Smart AIPI\n'));
+    const key = await getOrCreateKey(deps);
+    if (!key)
+        return;
+    const home = homedir();
+    const configDir = join(home, '.config', 'opencode');
+    const configPath = join(configDir, 'config.json');
+    const config = readJSON(configPath);
+    config.provider = {
+        ...(config.provider || {}),
+        openai: {
+            options: {
+                baseURL: 'https://api.smartaipi.com/v1',
+                apiKey: key
+            },
+            models: {
+                'gpt-5.3-codex': {}
+            }
+        }
+    };
+    config.model = 'openai/gpt-5.3-codex';
+    writeJSON(configPath, config);
+    console.log(chalk.green('  OpenCode configured!\n'));
+    console.log(chalk.dim(`  Written: ${configPath}\n`));
+    console.log(chalk.dim('  Model: openai/gpt-5.3-codex'));
+    console.log(chalk.dim('  Base URL: https://api.smartaipi.com/v1\n'));
+    console.log(`  Run ${chalk.cyan('opencode')} to start.\n`);
+}
+// ─── Aider ────────────────────────────────────────────────────────────────────
+async function setupAider(deps) {
+    console.log(chalk.bold('\n  Setting up Aider with Smart AIPI\n'));
+    const key = await getOrCreateKey(deps);
+    if (!key)
+        return;
+    const home = homedir();
+    const configPath = join(home, '.aider.conf.yml');
+    const yaml = `# Smart AIPI configuration
+openai-api-base: https://api.smartaipi.com/v1
+openai-api-key: ${key}
+model: openai/gpt-5.3-codex
+`;
+    writeFileSync(configPath, yaml);
+    console.log(chalk.green('  Aider configured!\n'));
+    console.log(chalk.dim(`  Written: ${configPath}\n`));
+    console.log(chalk.dim('  Model: openai/gpt-5.3-codex'));
+    console.log(chalk.dim('  Base URL: https://api.smartaipi.com/v1\n'));
+    console.log(`  Run ${chalk.cyan('aider')} to start.\n`);
+}
+// ─── Cursor (GUI — instructions only) ────────────────────────────────────────
+async function setupCursor(deps) {
+    console.log(chalk.bold('\n  Setting up Cursor with Smart AIPI\n'));
+    const key = await getOrCreateKey(deps);
+    if (!key)
+        return;
+    console.log(chalk.cyan('  Open Cursor and follow these steps:\n'));
+    console.log('  1. Open Settings (Cmd+, or Ctrl+,)');
+    console.log('  2. Go to "Models"');
+    console.log(`  3. Enter your API key under "OpenAI API Key":`);
+    console.log(`     ${chalk.green(key)}`);
+    console.log('  4. Click "Override OpenAI Base URL"');
+    console.log(`  5. Enter: ${chalk.green('https://api.smartaipi.com/v1')}`);
+    console.log(`  6. Select model: ${chalk.green('gpt-5.3-codex')}\n`);
+}
+// ─── Cline (VS Code extension — instructions only) ───────────────────────────
+async function setupCline(deps) {
+    console.log(chalk.bold('\n  Setting up Cline with Smart AIPI\n'));
+    const key = await getOrCreateKey(deps);
+    if (!key)
+        return;
+    console.log(chalk.cyan('  In Cline extension settings, configure:\n'));
+    console.log(`  API Provider:  ${chalk.green('OpenAI Compatible')}`);
+    console.log(`  Base URL:      ${chalk.green('https://api.smartaipi.com/v1')}`);
+    console.log(`  API Key:       ${chalk.green(key)}`);
+    console.log(`  Model:         ${chalk.green('gpt-5.3-codex')}\n`);
+}
+// ─── Windsurf (GUI — instructions only) ──────────────────────────────────────
+async function setupWindsurf(deps) {
+    console.log(chalk.bold('\n  Setting up Windsurf with Smart AIPI\n'));
+    const key = await getOrCreateKey(deps);
+    if (!key)
+        return;
+    console.log(chalk.cyan('  In Windsurf Settings → AI Provider:\n'));
+    console.log(`  Provider:  ${chalk.green('OpenAI Compatible')}`);
+    console.log(`  Base URL:  ${chalk.green('https://api.smartaipi.com/v1')}`);
+    console.log(`  API Key:   ${chalk.green(key)}`);
+    console.log(`  Model:     ${chalk.green('gpt-5.3-codex')}\n`);
+}
+// ─── Register all setup commands ──────────────────────────────────────────────
+const AGENTS = {
+    claude: { desc: 'Set up Claude Code to use Smart AIPI', handler: setupClaude },
+    codex: { desc: 'Set up Codex CLI to use Smart AIPI', handler: setupCodex },
+    opencode: { desc: 'Set up OpenCode to use Smart AIPI', handler: setupOpenCode },
+    aider: { desc: 'Set up Aider to use Smart AIPI', handler: setupAider },
+    cursor: { desc: 'Set up Cursor to use Smart AIPI', handler: setupCursor },
+    cline: { desc: 'Set up Cline to use Smart AIPI', handler: setupCline },
+    windsurf: { desc: 'Set up Windsurf to use Smart AIPI', handler: setupWindsurf },
+};
+export function registerSetupCommands(program, deps) {
+    for (const [name, { desc, handler }] of Object.entries(AGENTS)) {
+        program
+            .command(name)
+            .description(desc)
+            .option('-k, --key <key>', 'Use an existing API key instead of creating one')
+            .action(async (options) => {
+            if (options.key) {
+                // Bypass the interactive key prompt — inject the key
+                const wrappedDeps = {
+                    ...deps,
+                    // We pass the key via a custom property; handler uses getOrCreateKey
+                };
+                // For --key flag, we override getOrCreateKey by calling the handler
+                // with an env that pre-sets the key. Simpler: just call the handler
+                // after setting the key in a closure.
+                await setupWithKey(options.key, name, deps);
+                return;
+            }
+            await handler(deps);
+        });
+    }
+    // Also register a top-level "setup" command that lists available agents
+    program
+        .command('setup [agent]')
+        .description('Set up an AI agent to use Smart AIPI')
+        .action((agent) => {
+        if (agent && AGENTS[agent]) {
+            AGENTS[agent].handler(deps);
+            return;
+        }
+        console.log(chalk.bold('\n  Quick Setup — one command to configure any AI agent\n'));
+        console.log(chalk.cyan('  Auto-configure (writes config files):'));
+        console.log(`    ${chalk.green('smart-aipi claude')}     Claude Code`);
+        console.log(`    ${chalk.green('smart-aipi codex')}      Codex CLI`);
+        console.log(`    ${chalk.green('smart-aipi opencode')}   OpenCode`);
+        console.log(`    ${chalk.green('smart-aipi aider')}      Aider`);
+        console.log();
+        console.log(chalk.cyan('  Guided setup (shows instructions + creates key):'));
+        console.log(`    ${chalk.green('smart-aipi cursor')}     Cursor IDE`);
+        console.log(`    ${chalk.green('smart-aipi cline')}      Cline (VS Code)`);
+        console.log(`    ${chalk.green('smart-aipi windsurf')}   Windsurf`);
+        console.log();
+        console.log(chalk.dim('  Each command creates an API key and configures the tool.\n'));
+        console.log(chalk.dim('  Use --key <key> to use an existing key instead.\n'));
+    });
+}
+// Handler for --key flag (skips interactive key prompt)
+async function setupWithKey(key, agent, deps) {
+    // Temporarily monkey-patch nothing — we just call the specific setup
+    // function directly with the key injected. To avoid refactoring,
+    // we'll use a simpler approach per agent.
+    const home = homedir();
+    switch (agent) {
+        case 'claude': {
+            const settingsPath = join(home, '.claude', 'settings.json');
+            const claudeJsonPath = join(home, '.claude.json');
+            const settings = readJSON(settingsPath);
+            settings.env = {
+                ...(settings.env || {}),
+                ANTHROPIC_BASE_URL: 'https://api.smartaipi.com',
+                ANTHROPIC_API_KEY: key,
+                ANTHROPIC_DEFAULT_HAIKU_MODEL: 'claude-haiku-4-5-20251001'
+            };
+            if (!settings.model)
+                settings.model = 'claude-opus-4-6';
+            writeJSON(settingsPath, settings);
+            const claudeJson = readJSON(claudeJsonPath);
+            claudeJson.hasCompletedOnboarding = true;
+            writeJSON(claudeJsonPath, claudeJson);
+            console.log(chalk.green('\n  Claude Code configured!\n'));
+            console.log(chalk.dim(`  Written: ${settingsPath}`));
+            console.log(chalk.dim(`  Written: ${claudeJsonPath}\n`));
+            console.log(`  Run ${chalk.cyan('claude')} to start.\n`);
+            break;
+        }
+        case 'codex': {
+            const configDir = join(home, '.codex');
+            const configPath = join(configDir, 'config.toml');
+            if (!existsSync(configDir))
+                mkdirSync(configDir, { recursive: true });
+            writeFileSync(configPath, `model = "gpt-5.3-codex"\n\n[api]\nbase_url = "https://api.smartaipi.com/v1"\napi_key = "${key}"\n`);
+            console.log(chalk.green('\n  Codex CLI configured!\n'));
+            console.log(chalk.dim(`  Written: ${configPath}\n`));
+            console.log(`  Run ${chalk.cyan('codex "your prompt"')} to start.\n`);
+            break;
+        }
+        case 'opencode': {
+            const configDir = join(home, '.config', 'opencode');
+            const configPath = join(configDir, 'config.json');
+            const config = readJSON(configPath);
+            config.provider = { ...(config.provider || {}), openai: { options: { baseURL: 'https://api.smartaipi.com/v1', apiKey: key }, models: { 'gpt-5.3-codex': {} } } };
+            config.model = 'openai/gpt-5.3-codex';
+            writeJSON(configPath, config);
+            console.log(chalk.green('\n  OpenCode configured!\n'));
+            console.log(chalk.dim(`  Written: ${configPath}\n`));
+            console.log(`  Run ${chalk.cyan('opencode')} to start.\n`);
+            break;
+        }
+        case 'aider': {
+            const configPath = join(home, '.aider.conf.yml');
+            writeFileSync(configPath, `openai-api-base: https://api.smartaipi.com/v1\nopenai-api-key: ${key}\nmodel: openai/gpt-5.3-codex\n`);
+            console.log(chalk.green('\n  Aider configured!\n'));
+            console.log(chalk.dim(`  Written: ${configPath}\n`));
+            console.log(`  Run ${chalk.cyan('aider')} to start.\n`);
+            break;
+        }
+        case 'cursor':
+        case 'cline':
+        case 'windsurf': {
+            // GUI tools — just show instructions with the provided key
+            console.log(chalk.bold(`\n  ${agent.charAt(0).toUpperCase() + agent.slice(1)} Setup\n`));
+            console.log(`  Base URL:  ${chalk.green('https://api.smartaipi.com/v1')}`);
+            console.log(`  API Key:   ${chalk.green(key)}`);
+            console.log(`  Model:     ${chalk.green('gpt-5.3-codex')}\n`);
+            break;
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smart-aipi",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "CLI for Smart AIPI - OpenAI-compatible API gateway",
   "type": "module",
   "files": [
@@ -13,16 +13,21 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "test:runtime": "node --check bin/cli.js && node --check lib/login.js && node --check lib/docs.js",
+    "test:runtime": "node --check bin/cli.js && node --check lib/login.js && node --check lib/docs.js && node --check lib/setup.js",
     "test": "npm run build && npm run test:runtime"
   },
   "keywords": [
     "openai",
+    "anthropic",
     "api",
     "cli",
     "ai",
     "gpt",
-    "chatgpt"
+    "claude",
+    "codex",
+    "cursor",
+    "aider",
+    "cline"
   ],
   "author": "",
   "license": "MIT",