@neverquits/nq 0.1.1

package/bin/nq.mjs

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+
+const args = process.argv.slice(2)
+const command = args[0]
+
+function parseFlags(args) {
+  const flags = {}
+  const positional = []
+  for (let i = 0; i < args.length; i++) {
+    if (args[i].startsWith('--')) {
+      const key = args[i].slice(2)
+      const next = args[i + 1]
+      if (next && !next.startsWith('--')) {
+        flags[key] = next
+        i++
+      } else {
+        flags[key] = true
+      }
+    } else {
+      positional.push(args[i])
+    }
+  }
+  return { flags, positional }
+}
+
+function printHelp() {
+  console.log(`
+  nq — NeverQuits CLI
+
+  Usage:
+    nq login                          Log in with your access token
+    nq pull <agent> --org <orgId>     Clone agent workspace
+    nq push [-m "message"]            Commit and push changes
+    nq logout                         Clear stored credentials
+    nq status                         Show current config
+
+  Options:
+    nq pull <agent> --org <id> --session <id>   Also write .mcp.json
+    nq pull <agent> --org <id> --dir <path>     Custom clone directory
+    nq push --message "my changes"              Custom commit message
+
+  Examples:
+    nq login
+    nq pull alex --org acme123 --session sess_abc
+    nq push -m "updated research notes"
+`)
+}
+
+async function main() {
+  if (!command || command === 'help' || command === '--help' || command === '-h') {
+    printHelp()
+    return
+  }
+
+  if (command === 'login') {
+    const { login } = await import('../lib/commands/login.mjs')
+    await login()
+    return
+  }
+
+  if (command === 'logout') {
+    const { clearCredentials } = await import('../lib/config.mjs')
+    clearCredentials()
+    console.log('  Logged out. Credentials cleared.')
+    return
+  }
+
+  if (command === 'status') {
+    const { getCredentials, getConfig } = await import('../lib/config.mjs')
+    const creds = getCredentials()
+    const config = getConfig()
+    console.log()
+    console.log(`  Logged in: ${creds?.token ? 'yes' : 'no'}`)
+    if (creds?.token) {
+      console.log(`  Token:     ${creds.token.slice(0, 12)}...`)
+    }
+    console.log(`  API:       ${config.apiUrl ?? 'https://dev.neverquits.work'}`)
+    console.log()
+    return
+  }
+
+  if (command === 'pull') {
+    const { flags, positional } = parseFlags(args.slice(1))
+    const agentKey = positional[0]
+    if (!agentKey) {
+      console.error('Usage: nq pull <agent> --org <orgId>')
+      process.exit(1)
+    }
+    const { pull } = await import('../lib/commands/pull.mjs')
+    await pull(agentKey, {
+      org: flags.org,
+      session: flags.session,
+      dir: flags.dir,
+    })
+    return
+  }
+
+  if (command === 'push') {
+    const { flags } = parseFlags(args.slice(1))
+    const { push } = await import('../lib/commands/push.mjs')
+    await push({ message: flags.message ?? flags.m })
+    return
+  }
+
+  console.error(`  Unknown command: ${command}`)
+  console.error('  Run "nq help" for usage.')
+  process.exit(1)
+}
+
+main().catch((err) => {
+  console.error(err.message ?? err)
+  process.exit(1)
+})

package/lib/api.mjs

@@ -0,0 +1,28 @@
+import { getCredentials, getApiUrl } from './config.mjs'
+
+export function getToken() {
+  const creds = getCredentials()
+  if (!creds?.token) {
+    console.error('Not logged in. Run: nq login')
+    process.exit(1)
+  }
+  return creds.token
+}
+
+export async function apiFetch(path, options = {}) {
+  const token = getToken()
+  const url = `${getApiUrl()}${path}`
+  const res = await fetch(url, {
+    ...options,
+    headers: {
+      'Authorization': `Bearer ${token}`,
+      'Content-Type': 'application/json',
+      ...options.headers,
+    },
+  })
+  if (res.status === 401) {
+    console.error('Token expired or invalid. Run: nq login')
+    process.exit(1)
+  }
+  return res
+}

package/lib/commands/login.mjs

@@ -0,0 +1,60 @@
+import { createInterface } from 'node:readline'
+import { saveCredentials, getApiUrl } from '../config.mjs'
+
+export async function login() {
+  const apiUrl = getApiUrl()
+  const tokenUrl = `${apiUrl}/agentops/settings/tokens`
+
+  console.log()
+  console.log('  1. Open this URL in your browser:')
+  console.log()
+  console.log(`     ${tokenUrl}`)
+  console.log()
+  console.log('  2. Create a new access token and copy it.')
+  console.log()
+
+  // Try to open browser automatically
+  try {
+    const { exec } = await import('node:child_process')
+    const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open'
+    exec(`${cmd} ${tokenUrl}`)
+  } catch {
+    // silent — manual paste is fine
+  }
+
+  const rl = createInterface({ input: process.stdin, output: process.stdout })
+  const token = await new Promise((resolve) => {
+    rl.question('  Paste your token: ', (answer) => {
+      rl.close()
+      resolve(answer.trim())
+    })
+  })
+
+  if (!token) {
+    console.error('No token provided.')
+    process.exit(1)
+  }
+
+  if (!token.startsWith('nq_aop_')) {
+    console.error('Invalid token format. Tokens start with nq_aop_')
+    process.exit(1)
+  }
+
+  // Verify the token works
+  const res = await fetch(`${apiUrl}/api/agentops/me`, {
+    headers: { 'Authorization': `Bearer ${token}` },
+  })
+
+  if (!res.ok) {
+    console.error('Token verification failed. Check the token and try again.')
+    process.exit(1)
+  }
+
+  const me = await res.json()
+  saveCredentials({ token })
+
+  console.log()
+  console.log(`  Logged in as ${me.email ?? me.name ?? 'operator'}.`)
+  console.log('  Credentials saved to ~/.nq/credentials.json')
+  console.log()
+}

package/lib/commands/pull.mjs

@@ -0,0 +1,98 @@
+import { execSync } from 'node:child_process'
+import { existsSync, writeFileSync, mkdirSync } from 'node:fs'
+import { join, resolve } from 'node:path'
+import { apiFetch, getToken } from '../api.mjs'
+import { getApiUrl } from '../config.mjs'
+
+export async function pull(agentKey, options) {
+  const orgId = options.org
+  if (!orgId) {
+    console.error('Missing --org flag. Usage: nq pull <agent> --org <orgId>')
+    process.exit(1)
+  }
+
+  const sessionId = options.session
+  const dir = options.dir ?? `${orgId}-${agentKey}`
+  const dest = resolve(dir)
+
+  console.log()
+  console.log(`  Pulling workspace: ${orgId}/${agentKey}`)
+
+  // 1. Check if workspace repo exists
+  const res = await apiFetch(`/api/workspace/repos?orgId=${orgId}&agentKey=${agentKey}`)
+
+  if (!res.ok) {
+    console.error(`  Failed to fetch workspace info: ${res.status}`)
+    process.exit(1)
+  }
+
+  const repo = await res.json()
+
+  if (!repo?.repoName) {
+    console.error('  No workspace repo found. Has onboarding been completed for this org?')
+    process.exit(1)
+  }
+
+  // 2. Clone or pull
+  const gitDir = join(dest, '.git')
+  const org = repo.githubOrg ?? process.env.GITHUB_WORKSPACES_ORG
+
+  if (existsSync(gitDir)) {
+    console.log('  Pulling latest changes...')
+    try {
+      execSync('git pull --ff-only', { cwd: dest, stdio: 'inherit', timeout: 30_000 })
+    } catch {
+      console.error('  Pull failed. Resolve conflicts manually.')
+      process.exit(1)
+    }
+  } else {
+    console.log(`  Cloning ${org}/${repo.repoName}...`)
+    try {
+      execSync(`git clone https://github.com/${org}/${repo.repoName}.git ${dest}`, {
+        stdio: 'inherit',
+        timeout: 60_000,
+      })
+    } catch {
+      console.error('  Clone failed. Make sure you have git access to the repo.')
+      console.error(`  Try: gh auth login && gh repo clone ${org}/${repo.repoName}`)
+      process.exit(1)
+    }
+  }
+
+  // 3. Write .mcp.json if we have a session
+  if (sessionId) {
+    writeMcpJson(dest, orgId, agentKey, sessionId)
+    console.log('  Wrote .mcp.json')
+  } else {
+    console.log('  Skipped .mcp.json (no --session). Create a session first, then run:')
+    console.log(`    nq pull ${agentKey} --org ${orgId} --session <sessionId>`)
+  }
+
+  console.log()
+  console.log(`  Done. Workspace at: ${dest}`)
+  console.log()
+
+  if (sessionId) {
+    console.log('  Open this folder in Claude Code to start using the agent tools.')
+    console.log()
+  }
+}
+
+function writeMcpJson(dest, orgId, agentKey, sessionId) {
+  const apiUrl = getApiUrl()
+  const token = getToken()
+  const mcpUrl = `${apiUrl}/api/mcp/${orgId}/${agentKey}?sessionId=${sessionId}`
+
+  const config = {
+    mcpServers: {
+      [`nq-${agentKey}`]: {
+        url: mcpUrl,
+        headers: {
+          Authorization: `Bearer ${token}`,
+        },
+      },
+    },
+  }
+
+  writeFileSync(join(dest, '.mcp.json'), JSON.stringify(config, null, 2) + '\n')
+}

package/lib/commands/push.mjs

@@ -0,0 +1,33 @@
+import { execSync } from 'node:child_process'
+
+export async function push(options) {
+  const message = options.message ?? 'workspace update'
+
+  try {
+    execSync('git rev-parse --is-inside-work-tree', { stdio: 'ignore' })
+  } catch {
+    console.error('Not inside a git repo. Run this from your workspace directory.')
+    process.exit(1)
+  }
+
+  try {
+    // Check for changes
+    const status = execSync('git status --porcelain', { encoding: 'utf-8' }).trim()
+    if (!status) {
+      console.log('  Nothing to push — working tree clean.')
+      return
+    }
+
+    console.log()
+    console.log('  Staging and pushing changes...')
+    execSync('git add -A', { stdio: 'inherit' })
+    execSync(`git commit -m "${message.replace(/"/g, '\\"')}"`, { stdio: 'inherit' })
+    execSync('git push', { stdio: 'inherit', timeout: 30_000 })
+    console.log()
+    console.log('  Pushed.')
+    console.log()
+  } catch (err) {
+    console.error('  Push failed:', err.message)
+    process.exit(1)
+  }
+}

package/lib/config.mjs

@@ -0,0 +1,52 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+
+const CONFIG_DIR = join(homedir(), '.nq')
+const CREDENTIALS_FILE = join(CONFIG_DIR, 'credentials.json')
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json')
+
+function ensureDir() {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 })
+  }
+}
+
+export function getCredentials() {
+  try {
+    return JSON.parse(readFileSync(CREDENTIALS_FILE, 'utf-8'))
+  } catch {
+    return null
+  }
+}
+
+export function saveCredentials(creds) {
+  ensureDir()
+  writeFileSync(CREDENTIALS_FILE, JSON.stringify(creds, null, 2), { mode: 0o600 })
+}
+
+export function clearCredentials() {
+  try {
+    writeFileSync(CREDENTIALS_FILE, '{}', { mode: 0o600 })
+  } catch {
+    // ignore
+  }
+}
+
+export function getConfig() {
+  try {
+    return JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'))
+  } catch {
+    return {}
+  }
+}
+
+export function saveConfig(config) {
+  ensureDir()
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2))
+}
+
+export function getApiUrl() {
+  const config = getConfig()
+  return config.apiUrl ?? 'https://dev.neverquits.work'
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@neverquits/nq",
+  "version": "0.1.1",
+  "description": "NeverQuits CLI — workspace setup for AI agent operators",
+  "type": "module",
+  "bin": {
+    "nq": "./bin/nq.mjs"
+  },
+  "files": [
+    "bin/",
+    "lib/"
+  ],
+  "scripts": {
+    "dev": "node bin/nq.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT"
+}