@syphin/cli 0.1.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syphin/cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Syphin CLI — centralized AI agent context",
   "license": "MIT",
   "type": "module",

package/src/commands/init.js

@@ -3,21 +3,20 @@
  */
 
 import ora from 'ora'
+import prompts from 'prompts'
 import { basename } from 'path'
 import { readFileSync, writeFileSync, existsSync } from 'fs'
 import { loadToken, saveProjectConfig } from '../lib/config.js'
 import { createApiClient } from '../lib/api.js'
-import { success, fail, info, teal } from '../lib/output.js'
+import { success, fail, info, teal, dim } from '../lib/output.js'
 
 function detectProjectName() {
-  // Try package.json
   if (existsSync('package.json')) {
     try {
       const pkg = JSON.parse(readFileSync('package.json', 'utf-8'))
       if (pkg.name) return pkg.name.replace(/^@[^/]+\//, '')
     } catch {}
   }
-  // Fall back to directory name
   return basename(process.cwd())
 }
 
@@ -33,15 +32,96 @@ function updateMcpJson() {
 
   if (!mcp.mcpServers) mcp.mcpServers = {}
 
-  mcp.mcpServers.syphin = {
-    command: 'npx',
-    args: ['@syphin/mcp'],
-    type: 'stdio',
-  }
+  const isWindows = process.platform === 'win32'
+
+  mcp.mcpServers.syphin = isWindows
+    ? { command: 'cmd', args: ['/c', 'npx', '@syphin/mcp'], type: 'stdio' }
+    : { command: 'npx', args: ['@syphin/mcp'], type: 'stdio' }
 
   writeFileSync(mcpPath, JSON.stringify(mcp, null, 2))
 }
 
+async function pickProject(api, skipPrompts) {
+  const spinner = ora('Fetching your projects...').start()
+  let projects
+
+  try {
+    projects = await api.listProjects()
+    spinner.stop()
+  } catch (err) {
+    spinner.fail('Failed to fetch projects')
+    fail(err.message)
+    process.exit(1)
+  }
+
+  if (projects.length === 0) {
+    console.log('')
+    info('No projects found. Creating one from this directory.')
+    return null
+  }
+
+  if (skipPrompts) {
+    // --yes: match by directory name
+    const detected = detectProjectName().toLowerCase().replace(/[^a-z0-9-]/g, '-')
+    const match = projects.find(p => p.slug === detected)
+    if (match) return match
+    info(`No project matching "${detected}" — creating it.`)
+    return null
+  }
+
+  console.log('')
+  const choices = [
+    ...projects.map(p => ({
+      title: `${p.name} ${dim(`(${p.slug})`)}`,
+      value: p,
+    })),
+    { title: teal('+ Create new project'), value: null },
+  ]
+
+  const { project } = await prompts({
+    type: 'select',
+    name: 'project',
+    message: 'Connect to a project',
+    choices,
+  })
+
+  if (project === undefined) {
+    // User cancelled
+    process.exit(0)
+  }
+
+  return project
+}
+
+async function createNewProject(api, skipPrompts) {
+  const detected = detectProjectName()
+  let name = detected
+
+  if (!skipPrompts) {
+    const response = await prompts({
+      type: 'text',
+      name: 'name',
+      message: 'Project name',
+      initial: detected,
+    })
+    if (!response.name) process.exit(0)
+    name = response.name
+  }
+
+  const slug = name.toLowerCase().replace(/[^a-z0-9-]/g, '-')
+  const spinner = ora('Creating project...').start()
+
+  try {
+    const project = await api.createProject(name, slug)
+    spinner.succeed(`Created ${teal(name)}`)
+    return project
+  } catch (err) {
+    spinner.fail('Failed to create project')
+    fail(err.message)
+    process.exit(1)
+  }
+}
+
 export function registerInit(program) {
   program
     .command('init')
@@ -55,49 +135,46 @@ export function registerInit(program) {
         process.exit(1)
       }
 
-      const projectName = detectProjectName()
-      const slug = projectName.toLowerCase().replace(/[^a-z0-9-]/g, '-')
-      const env = opts.env
-
-      info(`Project: ${teal(projectName)} (${slug})`)
-      info(`Environment: ${env}`)
-
-      const spinner = ora('Connecting to Syphin...').start()
+      const api = createApiClient(token)
 
+      // Verify auth
+      const spinner = ora('Authenticating...').start()
       try {
-        const api = createApiClient(token)
-
-        // Verify auth first
         await api.verify()
+        spinner.stop()
+      } catch (err) {
+        spinner.fail('Authentication failed')
+        fail(err.message)
+        process.exit(1)
+      }
 
-        // Save project config
-        saveProjectConfig({
-          projectSlug: slug,
-          environment: env,
-        })
-
-        // Update .mcp.json
-        updateMcpJson()
+      // Pick or create project
+      let project = await pickProject(api, opts.yes)
+      if (!project) {
+        project = await createNewProject(api, opts.yes)
+      }
 
-        spinner.succeed('Connected!')
+      const env = opts.env
 
-        // Try to fetch manifest as connection test
-        try {
-          const manifest = await api.getManifest(slug, env)
-          console.log('')
-          info(`Always-on skills: ${teal(manifest.alwaysOn.length.toString())}`)
-          info(`Available skills: ${teal(manifest.available.length.toString())}`)
-          info(`Total always-on tokens: ${teal('~' + manifest.totalTokens)}`)
-        } catch {
-          info('No manifest yet — the project may need skills bound to it.')
-        }
+      // Save config
+      saveProjectConfig({
+        projectSlug: project.slug,
+        environment: env,
+      })
+      updateMcpJson()
 
+      // Show manifest summary
+      try {
+        const manifest = await api.getManifest(project.slug, env)
         console.log('')
-        success('Project connected. Restart Claude Code to activate Syphin.')
-      } catch (err) {
-        spinner.fail('Connection failed')
-        fail(err.message)
-        process.exit(1)
+        info(`Always-on skills: ${teal(manifest.alwaysOn.length.toString())}`)
+        info(`Available skills: ${teal(manifest.available.length.toString())}`)
+        info(`Total always-on tokens: ${teal('~' + manifest.totalTokens)}`)
+      } catch {
+        info('No manifest yet — bind skills to this project in the dashboard.')
       }
+
+      console.log('')
+      success(`Connected to ${teal(project.name || project.slug)} (${env}). Restart Claude Code to activate Syphin.`)
     })
 }

package/src/commands/login.js

@@ -1,11 +1,18 @@
 /**
  * syphin login [--token <t>] [--force]
+ *
+ * Without --token: starts OAuth device flow (opens browser).
+ * With --token: direct token authentication.
  */
 
 import ora from 'ora'
+import open from 'open'
 import { saveToken, loadToken } from '../lib/config.js'
 import { createApiClient } from '../lib/api.js'
-import { success, fail, info, teal } from '../lib/output.js'
+import { success, fail, info, teal, dim } from '../lib/output.js'
+
+const POLL_INTERVAL = 5000 // 5 seconds
+const MAX_POLLS = 120      // 10 minutes / 5s
 
 export function registerLogin(program) {
   program
@@ -20,30 +27,110 @@ export function registerLogin(program) {
         return
       }
 
-      const token = opts.token
-      if (!token) {
-        fail('Token required. Use: syphin login --token <your-token>')
-        info('Get a token from the Syphin dashboard at https://app.syphin.dev/settings/tokens')
-        process.exit(1)
+      // Direct token mode
+      if (opts.token) {
+        return directLogin(opts.token)
       }
 
-      const spinner = ora('Verifying token...').start()
+      // Device flow
+      return deviceFlowLogin()
+    })
+}
+
+async function directLogin(token) {
+  const spinner = ora('Verifying token...').start()
+
+  try {
+    const api = createApiClient(token)
+    const result = await api.verify()
+
+    saveToken(token)
+    spinner.succeed('Authenticated successfully!')
+
+    console.log('')
+    info(`Organization: ${teal(result.orgName)} (${result.orgSlug})`)
+    info(`Plan: ${result.orgPlan}`)
+    console.log('')
+  } catch (err) {
+    spinner.fail('Authentication failed')
+    fail(err.message)
+    process.exit(1)
+  }
+}
+
+async function deviceFlowLogin() {
+  const api = createApiClient(null)
+  let deviceData
+
+  const spinner = ora('Starting authentication...').start()
+
+  try {
+    deviceData = await api.requestDeviceCode()
+    spinner.stop()
+  } catch (err) {
+    spinner.fail('Failed to start authentication')
+    fail(err.message)
+    process.exit(1)
+  }
 
-      try {
-        const api = createApiClient(token)
-        const result = await api.verify()
+  // Display the code
+  console.log('')
+  console.log(`  Open this URL in your browser:`)
+  console.log('')
+  console.log(`    ${teal(deviceData.verificationUrl)}`)
+  console.log('')
+  console.log(`  And enter this code:`)
+  console.log('')
+  console.log(`    ${teal(deviceData.userCode)}`)
+  console.log('')
+  info(dim('Code expires in 10 minutes'))
+  console.log('')
 
-        saveToken(token)
-        spinner.succeed('Authenticated successfully!')
+  // Try to open the browser
+  try {
+    await open(deviceData.verificationUrl)
+  } catch {
+    // Browser open failed — user can manually navigate
+  }
+
+  // Poll for approval
+  const pollSpinner = ora('Waiting for browser authorization...').start()
+
+  for (let i = 0; i < MAX_POLLS; i++) {
+    await sleep(POLL_INTERVAL)
+
+    try {
+      const result = await api.pollDeviceToken(deviceData.deviceCode)
+
+      if (result.status === 'pending') {
+        continue
+      }
+
+      if (result.status === 'approved') {
+        saveToken(result.token)
+        pollSpinner.succeed('Authenticated successfully!')
 
         console.log('')
         info(`Organization: ${teal(result.orgName)} (${result.orgSlug})`)
         info(`Plan: ${result.orgPlan}`)
         console.log('')
-      } catch (err) {
-        spinner.fail('Authentication failed')
-        fail(err.message)
+        return
+      }
+    } catch (err) {
+      if (err.message.includes('expired') || err.message.includes('EXPIRED')) {
+        pollSpinner.fail('Code expired')
+        fail('Run `syphin login` to try again.')
         process.exit(1)
       }
-    })
+      // Other errors — keep polling
+    }
+  }
+
+  pollSpinner.fail('Timed out waiting for authorization')
+  fail('Run `syphin login` to try again.')
+  process.exit(1)
+}
+
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms))
 }

package/src/commands/switch.js

@@ -0,0 +1,98 @@
+/**
+ * syphin switch
+ *
+ * Quick project switcher for an already-initialized directory.
+ */
+
+import ora from 'ora'
+import prompts from 'prompts'
+import { loadToken, loadProjectConfig, saveProjectConfig } from '../lib/config.js'
+import { createApiClient } from '../lib/api.js'
+import { success, fail, info, teal, dim } from '../lib/output.js'
+
+export function registerSwitch(program) {
+  program
+    .command('switch')
+    .description('Switch to a different Syphin project')
+    .option('--env <env>', 'Change environment too')
+    .action(async (opts) => {
+      const token = loadToken()
+      if (!token) {
+        fail('Not authenticated. Run `syphin login` first.')
+        process.exit(1)
+      }
+
+      const config = loadProjectConfig()
+      if (!config) {
+        fail('No project config found. Run `syphin init` first.')
+        process.exit(1)
+      }
+
+      const api = createApiClient(token)
+
+      const spinner = ora('Fetching your projects...').start()
+      let projects
+
+      try {
+        projects = await api.listProjects()
+        spinner.stop()
+      } catch (err) {
+        spinner.fail('Failed to fetch projects')
+        fail(err.message)
+        process.exit(1)
+      }
+
+      if (projects.length === 0) {
+        fail('No projects found. Create one in the dashboard first.')
+        process.exit(1)
+      }
+
+      console.log('')
+      info(`Current: ${teal(config.projectSlug)} (${config.environment})`)
+      console.log('')
+
+      const choices = projects.map(p => ({
+        title: p.slug === config.projectSlug
+          ? `${p.name} ${dim(`(${p.slug})`)} ${teal('← current')}`
+          : `${p.name} ${dim(`(${p.slug})`)}`,
+        value: p,
+      }))
+
+      const { project } = await prompts({
+        type: 'select',
+        name: 'project',
+        message: 'Switch to',
+        choices,
+      })
+
+      if (project === undefined) {
+        process.exit(0)
+      }
+
+      if (project.slug === config.projectSlug && !opts.env) {
+        info('Already connected to this project.')
+        return
+      }
+
+      const env = opts.env || config.environment
+
+      saveProjectConfig({
+        projectSlug: project.slug,
+        environment: env,
+      })
+
+      // Show manifest summary
+      try {
+        const manifest = await api.getManifest(project.slug, env)
+        console.log('')
+        info(`Always-on skills: ${teal(manifest.alwaysOn.length.toString())}`)
+        info(`Available skills: ${teal(manifest.available.length.toString())}`)
+        info(`Total always-on tokens: ${teal('~' + manifest.totalTokens)}`)
+      } catch {
+        info('No manifest yet — bind skills to this project in the dashboard.')
+      }
+
+      console.log('')
+      success(`Switched to ${teal(project.name)} (${env}). Restart Claude Code to activate.`)
+    })
+}

package/src/index.js

@@ -6,6 +6,7 @@
 import { Command } from 'commander'
 import { registerLogin } from './commands/login.js'
 import { registerInit } from './commands/init.js'
+import { registerSwitch } from './commands/switch.js'
 import { registerAuth } from './commands/auth.js'
 import { registerCache } from './commands/cache.js'
 import { loadToken, loadProjectConfig } from './lib/config.js'
@@ -21,6 +22,7 @@ program
 
 registerLogin(program)
 registerInit(program)
+registerSwitch(program)
 registerAuth(program)
 registerCache(program)
 

package/src/lib/api.js

@@ -28,9 +28,31 @@ export function createApiClient(token, apiUrl) {
     return json.data
   }
 
+  // Device flow endpoints don't need auth
+  async function requestNoAuth(method, path, body) {
+    const url = `${baseUrl}${path}`
+    const opts = {
+      method,
+      headers: { 'Content-Type': 'application/json' },
+    }
+    if (body) opts.body = JSON.stringify(body)
+
+    const res = await fetch(url, opts)
+    const json = await res.json()
+
+    if (!res.ok && res.status !== 202) {
+      throw new Error(json.error || `API error ${res.status}`)
+    }
+
+    return json.data
+  }
+
   return {
     verify: () => request('POST', '/api/auth/verify'),
+    listProjects: () => request('GET', '/api/projects'),
     getManifest: (slug, env) => request('GET', `/api/projects/${slug}/manifest?env=${env}`),
     createProject: (name, slug) => request('POST', '/api/projects', { name, slug }),
+    requestDeviceCode: () => requestNoAuth('POST', '/api/auth/device/code'),
+    pollDeviceToken: (deviceCode) => requestNoAuth('POST', '/api/auth/device/token', { deviceCode }),
   }
 }