@syphin/cli 0.1.0

package/README.md

@@ -0,0 +1,65 @@
+# syphin
+
+CLI for [Syphin](https://syphin.dev) — centralized AI agent context.
+
+## Install
+
+```bash
+npm install -g syphin
+```
+
+## Commands
+
+### `syphin login`
+
+Authenticate with Syphin.
+
+```bash
+syphin login --token <your-token>
+```
+
+Get a token from the [Syphin dashboard](https://app.syphin.dev/settings/tokens).
+
+### `syphin init`
+
+Connect the current directory to Syphin. Creates `.syphin/config.json` and adds the MCP server to `.mcp.json`.
+
+```bash
+syphin init
+syphin init --env staging
+```
+
+### `syphin status`
+
+Check connection status and show the live manifest.
+
+```bash
+syphin status
+```
+
+### `syphin whoami`
+
+Show current auth context (org, plan, token type).
+
+### `syphin logout`
+
+Clear stored credentials.
+
+### `syphin cache`
+
+Show local cache stats (cached skills and manifests).
+
+### `syphin cache clear`
+
+Clear the local cache.
+
+## Environment variables
+
+| Variable | Description |
+|----------|-------------|
+| `SYPHIN_TOKEN` | Auth token (alternative to `syphin login`) |
+| `SYPHIN_API_URL` | API base URL (default: `https://syphin.vercel.app`) |
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@syphin/cli",
+  "version": "0.1.0",
+  "description": "Syphin CLI — centralized AI agent context",
+  "license": "MIT",
+  "type": "module",
+  "bin": { "syphin": "src/index.js" },
+  "files": ["src", "README.md"],
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "node --watch src/index.js"
+  },
+  "keywords": ["syphin", "cli", "ai", "agent", "context", "mcp", "claude"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dbigby/syphin.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://syphin.dev",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "ora": "^8.0.1",
+    "chalk": "^5.3.0",
+    "prompts": "^2.4.2",
+    "open": "^10.1.0"
+  },
+  "engines": { "node": ">=18.0.0" }
+}

package/src/commands/auth.js

@@ -0,0 +1,39 @@
+/**
+ * syphin whoami / syphin logout
+ */
+
+import { loadToken, clearToken } from '../lib/config.js'
+import { createApiClient } from '../lib/api.js'
+import { success, fail, info, teal } from '../lib/output.js'
+
+export function registerAuth(program) {
+  program
+    .command('whoami')
+    .description('Show current auth context')
+    .action(async () => {
+      const token = loadToken()
+      if (!token) {
+        fail('Not authenticated. Run `syphin login` first.')
+        process.exit(1)
+      }
+
+      try {
+        const api = createApiClient(token)
+        const result = await api.verify()
+        info(`Organization: ${teal(result.orgName)} (${result.orgSlug})`)
+        info(`Plan: ${result.orgPlan}`)
+        info(`Token type: ${result.tokenType}`)
+      } catch (err) {
+        fail(`Token invalid: ${err.message}`)
+        process.exit(1)
+      }
+    })
+
+  program
+    .command('logout')
+    .description('Clear stored credentials')
+    .action(() => {
+      clearToken()
+      success('Logged out.')
+    })
+}

package/src/commands/cache.js

@@ -0,0 +1,59 @@
+/**
+ * syphin cache / syphin cache clear
+ */
+
+import { existsSync, readdirSync, rmSync, statSync } from 'fs'
+import { join } from 'path'
+import { homedir } from 'os'
+import { success, info, teal } from '../lib/output.js'
+
+const CACHE_DIR = join(homedir(), '.cache', 'syphin')
+
+function countFiles(dir) {
+  if (!existsSync(dir)) return 0
+  return readdirSync(dir).length
+}
+
+function dirSize(dir) {
+  if (!existsSync(dir)) return 0
+  let total = 0
+  for (const f of readdirSync(dir)) {
+    const fp = join(dir, f)
+    try {
+      total += statSync(fp).size
+    } catch {}
+  }
+  return total
+}
+
+function formatBytes(bytes) {
+  if (bytes < 1024) return `${bytes} B`
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`
+  return `${(bytes / 1024 / 1024).toFixed(1)} MB`
+}
+
+export function registerCache(program) {
+  const cache = program
+    .command('cache')
+    .description('Show cache stats')
+    .action(() => {
+      const skills = countFiles(join(CACHE_DIR, 'skills'))
+      const manifests = countFiles(join(CACHE_DIR, 'manifests'))
+      const size = dirSize(join(CACHE_DIR, 'skills')) + dirSize(join(CACHE_DIR, 'manifests'))
+
+      info(`Cache directory: ${CACHE_DIR}`)
+      info(`Cached skills: ${teal(skills.toString())}`)
+      info(`Cached manifests: ${teal(manifests.toString())}`)
+      info(`Total size: ${formatBytes(size)}`)
+    })
+
+  cache
+    .command('clear')
+    .description('Clear the local cache')
+    .action(() => {
+      if (existsSync(CACHE_DIR)) {
+        rmSync(CACHE_DIR, { recursive: true })
+      }
+      success('Cache cleared.')
+    })
+}

package/src/commands/init.js

@@ -0,0 +1,103 @@
+/**
+ * syphin init [--yes] [--env <env>]
+ */
+
+import ora from 'ora'
+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'
+
+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())
+}
+
+function updateMcpJson() {
+  const mcpPath = '.mcp.json'
+  let mcp = {}
+
+  if (existsSync(mcpPath)) {
+    try {
+      mcp = JSON.parse(readFileSync(mcpPath, 'utf-8'))
+    } catch {}
+  }
+
+  if (!mcp.mcpServers) mcp.mcpServers = {}
+
+  mcp.mcpServers.syphin = {
+    command: 'npx',
+    args: ['@syphin/mcp'],
+    type: 'stdio',
+  }
+
+  writeFileSync(mcpPath, JSON.stringify(mcp, null, 2))
+}
+
+export function registerInit(program) {
+  program
+    .command('init')
+    .description('Connect current directory to Syphin')
+    .option('--yes', 'Skip prompts')
+    .option('--env <env>', 'Environment', 'dev')
+    .action(async (opts) => {
+      const token = loadToken()
+      if (!token) {
+        fail('Not authenticated. Run `syphin login` first.')
+        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()
+
+      try {
+        const api = createApiClient(token)
+
+        // Verify auth first
+        await api.verify()
+
+        // Save project config
+        saveProjectConfig({
+          projectSlug: slug,
+          environment: env,
+        })
+
+        // Update .mcp.json
+        updateMcpJson()
+
+        spinner.succeed('Connected!')
+
+        // 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.')
+        }
+
+        console.log('')
+        success('Project connected. Restart Claude Code to activate Syphin.')
+      } catch (err) {
+        spinner.fail('Connection failed')
+        fail(err.message)
+        process.exit(1)
+      }
+    })
+}

package/src/commands/login.js

@@ -0,0 +1,49 @@
+/**
+ * syphin login [--token <t>] [--force]
+ */
+
+import ora from 'ora'
+import { saveToken, loadToken } from '../lib/config.js'
+import { createApiClient } from '../lib/api.js'
+import { success, fail, info, teal } from '../lib/output.js'
+
+export function registerLogin(program) {
+  program
+    .command('login')
+    .description('Authenticate with Syphin')
+    .option('--token <token>', 'Direct token authentication')
+    .option('--force', 'Re-authenticate even if already logged in')
+    .action(async (opts) => {
+      const existing = loadToken()
+      if (existing && !opts.force && !opts.token) {
+        info('Already authenticated. Use --force to re-authenticate.')
+        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)
+      }
+
+      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)
+      }
+    })
+}

package/src/index.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+/**
+ * syphin CLI — login, init, status, cache management.
+ */
+
+import { Command } from 'commander'
+import { registerLogin } from './commands/login.js'
+import { registerInit } from './commands/init.js'
+import { registerAuth } from './commands/auth.js'
+import { registerCache } from './commands/cache.js'
+import { loadToken, loadProjectConfig } from './lib/config.js'
+import { createApiClient } from './lib/api.js'
+import { info, fail, teal, dim } from './lib/output.js'
+
+const program = new Command()
+
+program
+  .name('syphin')
+  .description('Syphin CLI — centralized AI agent context')
+  .version('0.1.0')
+
+registerLogin(program)
+registerInit(program)
+registerAuth(program)
+registerCache(program)
+
+program
+  .command('status')
+  .description('Check connection status and live manifest')
+  .action(async () => {
+    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` in your project directory.')
+      process.exit(1)
+    }
+
+    info(`Project: ${teal(config.projectSlug)}`)
+    info(`Environment: ${config.environment}`)
+
+    try {
+      const api = createApiClient(token)
+      const result = await api.verify()
+      info(`Organization: ${teal(result.orgName)} (${result.orgSlug})`)
+
+      try {
+        const manifest = await api.getManifest(config.projectSlug, config.environment)
+        info(`Always-on: ${teal(manifest.alwaysOn.length.toString())} skills (~${manifest.totalTokens} tokens)`)
+        info(`Available: ${teal(manifest.available.length.toString())} skills`)
+
+        if (manifest.alwaysOn.length > 0) {
+          console.log('')
+          info(dim('Always-on skills:'))
+          for (const s of manifest.alwaysOn) {
+            info(`  ${s.name} ${dim(`[${s.type}]`)} ~${s.tokenCount} tokens`)
+          }
+        }
+      } catch {
+        info('Manifest not available — project may need skills bound.')
+      }
+    } catch (err) {
+      fail(`Connection error: ${err.message}`)
+      process.exit(1)
+    }
+  })
+
+program.parse()

package/src/lib/api.js

@@ -0,0 +1,36 @@
+/**
+ * API client for CLI.
+ */
+
+const DEFAULT_API_URL = 'https://syphin.vercel.app'
+
+export function createApiClient(token, apiUrl) {
+  const baseUrl = (apiUrl || process.env.SYPHIN_API_URL || DEFAULT_API_URL).replace(/\/+$/, '')
+
+  async function request(method, path, body) {
+    const url = `${baseUrl}${path}`
+    const opts = {
+      method,
+      headers: {
+        'Authorization': `Bearer ${token}`,
+        '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) {
+      throw new Error(json.error || `API error ${res.status}`)
+    }
+
+    return json.data
+  }
+
+  return {
+    verify: () => request('POST', '/api/auth/verify'),
+    getManifest: (slug, env) => request('GET', `/api/projects/${slug}/manifest?env=${env}`),
+    createProject: (name, slug) => request('POST', '/api/projects', { name, slug }),
+  }
+}

package/src/lib/config.js

@@ -0,0 +1,60 @@
+/**
+ * Config management — credentials and project config.
+ */
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync, chmodSync } from 'fs'
+import { join, dirname } from 'path'
+import { homedir } from 'os'
+
+const CONFIG_DIR = join(homedir(), '.config', 'syphin')
+const CREDS_FILE = join(CONFIG_DIR, 'credentials.json')
+
+function ensureDir(dir) {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true })
+  }
+}
+
+export function saveToken(token) {
+  ensureDir(CONFIG_DIR)
+  writeFileSync(CREDS_FILE, JSON.stringify({ token }, null, 2))
+  try {
+    chmodSync(CREDS_FILE, 0o600)
+  } catch {}
+}
+
+export function loadToken() {
+  if (process.env.SYPHIN_TOKEN) return process.env.SYPHIN_TOKEN
+
+  if (existsSync(CREDS_FILE)) {
+    try {
+      const raw = readFileSync(CREDS_FILE, 'utf-8')
+      return JSON.parse(raw).token || null
+    } catch {
+      return null
+    }
+  }
+  return null
+}
+
+export function clearToken() {
+  if (existsSync(CREDS_FILE)) {
+    writeFileSync(CREDS_FILE, '{}')
+  }
+}
+
+export function loadProjectConfig() {
+  const configPath = join(process.cwd(), '.syphin', 'config.json')
+  if (!existsSync(configPath)) return null
+  try {
+    return JSON.parse(readFileSync(configPath, 'utf-8'))
+  } catch {
+    return null
+  }
+}
+
+export function saveProjectConfig(config) {
+  const dir = join(process.cwd(), '.syphin')
+  ensureDir(dir)
+  writeFileSync(join(dir, 'config.json'), JSON.stringify(config, null, 2))
+}

package/src/lib/output.js

@@ -0,0 +1,28 @@
+/**
+ * Styled terminal output helpers.
+ */
+
+import chalk from 'chalk'
+
+export const teal = chalk.hex('#00d4c8')
+export const dim = chalk.dim
+export const bold = chalk.bold
+export const red = chalk.red
+export const green = chalk.green
+export const yellow = chalk.yellow
+
+export function success(msg) {
+  console.log(green('  ✓ ') + msg)
+}
+
+export function fail(msg) {
+  console.log(red('  ✗ ') + msg)
+}
+
+export function info(msg) {
+  console.log(dim('  → ') + msg)
+}
+
+export function heading(msg) {
+  console.log('\n' + bold(msg))
+}