spaceshipai 0.1.0 → 0.1.2

package/.github/workflows/publish.yml

@@ -0,0 +1,23 @@
+name: Publish to npm
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          registry-url: 'https://registry.npmjs.org'
+
+      - run: npm install -g npm@latest
+
+      - run: npm publish --access public --provenance

package/README.md

@@ -0,0 +1,78 @@
+# Spaceship AI CLI
+
+Install the [Spaceship AI](https://spaceshipai.io) MCP server into every AI coding tool on your machine with one command.
+
+## Quick start
+
+```bash
+SPACESHIP_API_KEY=sk_live_... npx spaceshipai@latest init
+```
+
+Detects and installs to **Claude Code**, **Cursor**, **VS Code**, and **Windsurf** — whichever you have installed.
+
+Get your API key from the [Spaceship dashboard](https://spaceshipai.io).
+
+## What it does
+
+```
+Spaceship AI — MCP installer
+
+Installing Spaceship MCP server...
+
+✓ Claude Code
+✓ Cursor
+✓ VS Code
+— Windsurf not detected (skipped)
+
+Spaceship MCP is ready. Restart your IDE if it was open.
+```
+
+## Install to Cursor
+
+[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=Spaceship&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJzcGFjZXNoaXAtbWNwIl19)
+
+## Available MCP tools
+
+Once installed, these tools are available in your AI IDE:
+
+| Tool | Description |
+|------|-------------|
+| `list_projects` | List all projects in your org |
+| `list_agents` | List agents, optionally filtered by project |
+| `get_agent` | Get full details of a single agent |
+| `create_agent` | Create an agent with auto-generated system prompt |
+| `update_agent` | Update name, prompt, or tools |
+| `delete_agent` | Permanently delete an agent |
+| `run_agent` | Start an async run; returns execution_id |
+| `get_run_status` | Poll run status until completed or errored |
+| `get_run_logs` | Fetch full event log for a completed run |
+| `list_executions` | List recent runs with status and duration |
+| `test_agent` | Quick sync test with 15s timeout |
+| `list_tools` | List tools available to attach to agents |
+
+## Manual configuration
+
+If you prefer to configure manually, add this to your IDE's MCP config file:
+
+```json
+{
+  "spaceship": {
+    "command": "uvx",
+    "args": ["spaceship-mcp"],
+    "env": {
+      "SPACESHIP_API_KEY": "sk_live_..."
+    }
+  }
+}
+```
+
+| IDE | Config file |
+|-----|-------------|
+| Claude Code | `~/.claude/mcp.json` or run `claude mcp add` |
+| Cursor | `~/.cursor/mcp.json` |
+| VS Code | `.vscode/mcp.json` |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+
+## License
+
+MIT

package/bin/init.js

@@ -7,7 +7,7 @@ import {
   installVscode,
   installWindsurf,
 } from '../src/install.js'
-import { promptApiKey } from '../src/prompt.js'
+import { authenticateViaBrowser } from '../src/auth.js'
 
 const TEAL  = '\x1b[36m'
 const GREEN = '\x1b[32m'
@@ -18,15 +18,10 @@ const RESET = '\x1b[0m'
 async function main() {
   console.log(`\n${BOLD}${TEAL}Spaceship AI${RESET} — MCP installer\n`)
 
-  // Resolve API key: env var → prompt
+  // Resolve API key: env var → browser OAuth flow
   let apiKey = process.env.SPACESHIP_API_KEY
   if (!apiKey) {
-    apiKey = await promptApiKey()
-  }
-
-  if (!apiKey || !apiKey.startsWith('sk_')) {
-    console.error('\nInvalid API key. Keys must start with sk_live_ or sk_test_.')
-    process.exit(1)
+    apiKey = await authenticateViaBrowser()
   }
 
   // Detect installed tools

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spaceshipai",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Spaceship AI CLI — connect your AI coding tools, manage agents, and more",
   "type": "module",
   "bin": {

package/src/auth.js

@@ -0,0 +1,151 @@
+import { createServer } from 'http'
+import { randomBytes } from 'crypto'
+import { execSync } from 'child_process'
+
+const DASHBOARD_URL = process.env.SPACESHIP_BASE_URL || 'https://spaceshipai.io'
+const TIMEOUT_MS = 120_000
+
+function openBrowser(url) {
+  try {
+    const p = process.platform
+    if (p === 'darwin') execSync(`open "${url}"`, { stdio: 'ignore' })
+    else if (p === 'win32') execSync(`start "" "${url}"`, { stdio: 'ignore' })
+    else execSync(`xdg-open "${url}"`, { stdio: 'ignore' })
+    return true
+  } catch {
+    return false
+  }
+}
+
+export async function authenticateViaBrowser() {
+  const state = randomBytes(16).toString('hex')
+
+  return new Promise((resolve, reject) => {
+    const server = createServer((req, res) => {
+      try {
+        const url = new URL(req.url, 'http://localhost')
+
+        if (url.pathname !== '/cb') {
+          res.writeHead(404)
+          res.end()
+          return
+        }
+
+        const error = url.searchParams.get('error')
+        if (error) {
+          res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })
+          res.end(cancelledHtml())
+          server.close()
+          clearTimeout(timer)
+          reject(new Error('Authentication cancelled.'))
+          return
+        }
+
+        const code = url.searchParams.get('code')
+        const returnedState = url.searchParams.get('state')
+
+        if (!code || returnedState !== state) {
+          res.writeHead(400)
+          res.end('Invalid request')
+          return
+        }
+
+        // Exchange the short-lived code for the actual API key
+        fetch(`${DASHBOARD_URL}/cli-auth/exchange?code=${encodeURIComponent(code)}`)
+          .then((r) => {
+            if (!r.ok) return Promise.reject(new Error(`Exchange failed (${r.status}). Run again to retry.`))
+            return r.json()
+          })
+          .then(({ key }) => {
+            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })
+            res.end(successHtml())
+            server.close()
+            clearTimeout(timer)
+            resolve(key)
+          })
+          .catch((err) => {
+            res.writeHead(500)
+            res.end('Exchange failed')
+            server.close()
+            clearTimeout(timer)
+            reject(err)
+          })
+      } catch (err) {
+        reject(err)
+      }
+    })
+
+    server.listen(0, '127.0.0.1', () => {
+      const { port } = server.address()
+      const callbackUrl = `http://127.0.0.1:${port}/cb`
+      const authUrl = `${DASHBOARD_URL}/cli-auth?callback=${encodeURIComponent(callbackUrl)}&state=${state}`
+
+      const opened = openBrowser(authUrl)
+      if (opened) {
+        process.stderr.write('Opening browser for authentication...\n')
+      } else {
+        process.stderr.write(`Could not open browser automatically. Visit this URL:\n\n  ${authUrl}\n\n`)
+      }
+      process.stderr.write('Waiting for browser authorization... (Ctrl+C to cancel)\n\n')
+    })
+
+    const timer = setTimeout(() => {
+      server.close()
+      reject(new Error('Authentication timed out. Run again to retry.'))
+    }, TIMEOUT_MS)
+
+    server.on('error', reject)
+  })
+}
+
+function successHtml() {
+  return `<!DOCTYPE html>
+<html>
+<head>
+  <title>Spaceship CLI Authorized</title>
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <style>
+    *{box-sizing:border-box;margin:0;padding:0}
+    body{background:#0f0f1a;color:#e0e0e0;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;
+      display:flex;align-items:center;justify-content:center;min-height:100vh;text-align:center}
+    .card{padding:48px;max-width:400px}
+    .icon{font-size:48px;margin-bottom:16px}
+    h2{color:#00daf3;margin:0 0 12px;font-size:22px;font-weight:600}
+    p{color:#888;margin:0;font-size:14px;line-height:1.6}
+  </style>
+</head>
+<body>
+  <div class="card">
+    <div class="icon">&#10003;</div>
+    <h2>Spaceship CLI authorized</h2>
+    <p>You can close this tab and return to your terminal.</p>
+  </div>
+</body>
+</html>`
+}
+
+function cancelledHtml() {
+  return `<!DOCTYPE html>
+<html>
+<head>
+  <title>Cancelled</title>
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <style>
+    *{box-sizing:border-box;margin:0;padding:0}
+    body{background:#0f0f1a;color:#e0e0e0;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;
+      display:flex;align-items:center;justify-content:center;min-height:100vh;text-align:center}
+    .card{padding:48px;max-width:400px}
+    .icon{font-size:48px;margin-bottom:16px}
+    h2{color:#888;margin:0 0 12px;font-size:22px;font-weight:600}
+    p{color:#888;margin:0;font-size:14px}
+  </style>
+</head>
+<body>
+  <div class="card">
+    <div class="icon">&#10005;</div>
+    <h2>Authorization cancelled</h2>
+    <p>You can close this tab.</p>
+  </div>
+</body>
+</html>`
+}

package/src/install.js

@@ -26,8 +26,14 @@ function writeJsonFile(path, data) {
 }
 
 export function installClaudeCode(key) {
+  // Remove any existing project-scoped entry before adding user-scoped one
+  try {
+    execSync('claude mcp remove spaceship', { stdio: 'ignore' })
+  } catch {
+    // Not present — that's fine
+  }
   execSync(
-    `claude mcp add --transport stdio spaceship --env SPACESHIP_API_KEY=${key} -- uvx spaceship-mcp`,
+    `claude mcp add --scope user --transport stdio spaceship --env SPACESHIP_API_KEY=${key} -- uvx spaceship-mcp`,
     { stdio: 'ignore' }
   )
 }

package/src/prompt.js

@@ -1,12 +0,0 @@
-import { createInterface } from 'readline'
-
-export async function promptApiKey() {
-  const rl = createInterface({ input: process.stdin, output: process.stderr })
-
-  return new Promise((resolve) => {
-    rl.question('Enter your Spaceship API key (sk_live_...): ', (answer) => {
-      rl.close()
-      resolve(answer.trim())
-    })
-  })
-}