@adithya-13/cc-switch 1.0.0 → 1.0.1

package/README.md

@@ -12,7 +12,7 @@ cc-switch use openrouter # → OpenRouter (320+ models)
 ## Install
 
 ```bash
-npm install -g cc-switch
+npm install -g @adithya-13/cc-switch
 ```
 
 Or via curl:

package/bin/cc-switch.js

@@ -8,7 +8,33 @@ import { addCommand } from "../src/commands/add.js";
 import { doctorCommand } from "../src/commands/doctor.js";
 import { readSettings, getCurrentProvider } from "../src/settings.js";
 import { PRESETS } from "../src/presets.js";
-import { loadProfiles } from "../src/profiles.js";
+import { loadProfiles, isFirstRun } from "../src/profiles.js";
+
+if (isFirstRun()) {
+  const settings = readSettings()
+  const current = getCurrentProvider(settings)
+  const preset = PRESETS[current] || loadProfiles()[current]
+  const name = preset?.name || current
+
+  console.log()
+  console.log(chalk.cyan('  ╔══════════════════════════════════════════════╗'))
+  console.log(chalk.cyan('  ║          Welcome to cc-switch! 🎉            ║'))
+  console.log(chalk.cyan('  ║   Switch Claude Code between providers       ║'))
+  console.log(chalk.cyan('  ╚══════════════════════════════════════════════╝'))
+  console.log()
+  console.log(chalk.white('  Quick start:'))
+  console.log()
+  console.log(chalk.gray('  1. See all providers:     cc-switch list'))
+  console.log(chalk.gray('  2. Switch provider:       cc-switch use zai'))
+  console.log(chalk.gray('  3. Add your API key:      cc-switch use kimi   (prompts for key)'))
+  console.log(chalk.gray('  4. Save for next time:    keys saved in ~/.cc-switch/keys.json'))
+  console.log()
+  console.log(chalk.gray('  Hit a rate limit? Use cclaude instead of claude —'))
+  console.log(chalk.gray('  it detects limits and shows fallback options.'))
+  console.log()
+  console.log(chalk.white(`  Active: ${chalk.green.bold(name)}`))
+  console.log()
+}
 
 const program = new Command();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adithya-13/cc-switch",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Switch Claude Code between providers (Claude Pro, z.ai, Kimi, OpenRouter, DeepSeek, and more)",
   "keywords": [
     "claude",

package/src/commands/list.js

@@ -2,6 +2,7 @@ import chalk from 'chalk'
 import { PRESETS } from '../presets.js'
 import { loadProfiles, loadKeys } from '../profiles.js'
 import { readSettings, getCurrentProvider } from '../settings.js'
+import { maskKey } from '../utils.js'
 
 export function listCommand() {
   const settings = readSettings()
@@ -18,7 +19,7 @@ export function listCommand() {
     const label = isActive ? chalk.green.bold(preset.name) : chalk.white(preset.name)
     const keyStatus = preset.requiresKey === false
       ? chalk.gray('OAuth')
-      : hasKey ? chalk.green('key ✓') : chalk.yellow('no key')
+      : hasKey ? chalk.green(`key ${maskKey(keys[name])}`) : chalk.yellow('no key')
 
     console.log(`  ${marker} ${label.padEnd(isActive ? 33 : 25)} ${keyStatus}`)
     if (preset.description) {

package/src/profiles.js

@@ -5,11 +5,21 @@ import { join } from 'path'
 const DIR = join(homedir(), '.cc-switch')
 const KEYS_PATH = join(DIR, 'keys.json')
 const PROFILES_PATH = join(DIR, 'profiles.json')
+const INIT_FLAG = join(DIR, '.initialized')
 
 function ensureDir() {
   if (!existsSync(DIR)) mkdirSync(DIR, { recursive: true })
 }
 
+export function isFirstRun() {
+  ensureDir()
+  if (!existsSync(INIT_FLAG)) {
+    writeFileSync(INIT_FLAG, '')
+    return true
+  }
+  return false
+}
+
 export function loadKeys() {
   if (!existsSync(KEYS_PATH)) return {}
   return JSON.parse(readFileSync(KEYS_PATH, 'utf8'))