@twoer/ccx 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 twoer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+# ccx
+
+**C**laude **C**ode e**X**ecutor — 轻松切换 Provider 和模型。
+
+```
+$ ccx
+
+┌  ⚡ ccx — Claude Code eXecutor
+│
+│  5 providers from cc-switch · v0.1.0
+│    ccx add   Add provider    ccx edit  Edit provider
+│    ccx list  List providers   ccx rm    Remove provider
+│    ccx -n    New window       ccx help  Show help
+│
+◆  Select provider
+│  ● Zhipu GLM-5.1           glm-5.1
+│  ○ Zhipu GLM-5 Turbo       glm-5-turbo
+│  ○ Claude Official
+└
+```
+
+## 安装
+
+```bash
+# 克隆并链接
+git clone https://github.com/twoer/ccx.git ~/.ccx
+cd ~/.ccx && npm install
+ln -s ~/.ccx/bin/ccx.mjs /usr/local/bin/ccx
+```
+
+### 环境要求
+
+- macOS
+- Node.js >= 18
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
+
+## 使用
+
+```bash
+# 交互选择，在当前终端运行
+ccx
+
+# 模糊匹配 provider 名称
+ccx glm
+
+# 在新终端窗口中打开
+ccx --new
+ccx -n glm
+```
+
+## 命令
+
+```bash
+# 管理 Provider
+ccx add           # 交互式添加 provider
+ccx list          # 列出所有 provider
+ccx edit          # 编辑 provider
+ccx rm            # 删除 provider
+
+# 其他
+ccx help          # 显示帮助
+ccx --reset       # 重置所有配置
+```
+
+## Provider 数据源
+
+ccx 会自动检测可用的数据源：
+
+### 1. cc-switch（自动检测）
+
+如果你使用 [cc-switch](https://github.com/nicepkg/cc-switch)，ccx 会直接读取 `~/.cc-switch/cc-switch.db`，无需额外配置。
+
+### 2. JSON 文件（手动配置）
+
+手动创建 `~/.config/ccx/providers.json`，或使用 `ccx add` 交互式创建：
+
+```json
+{
+  "providers": [
+    {
+      "name": "My Provider",
+      "model": "model-name",
+      "env": {
+        "ANTHROPIC_BASE_URL": "https://...",
+        "ANTHROPIC_AUTH_TOKEN": "sk-...",
+        "ANTHROPIC_MODEL": "model-name"
+      }
+    }
+  ]
+}
+```
+
+## 终端支持
+
+使用 `ccx --new` 时，首次运行会自动检测已安装的终端：
+
+- Ghostty
+- iTerm2
+- Warp
+- kitty
+- Terminal.app
+
+配置文件：`~/.config/ccx/config.json`
+
+## License
+
+MIT

package/bin/ccx.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { run } from '../src/launcher.mjs'
+
+run(process.argv.slice(2))

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@twoer/ccx",
+  "version": "0.1.0",
+  "description": "Claude Code launcher - switch providers and models with ease",
+  "type": "module",
+  "bin": {
+    "ccx": "./bin/ccx.mjs"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "scripts": {
+    "start": "node bin/ccx.mjs"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "cli",
+    "launcher"
+  ],
+  "author": "twoer",
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^0.10.0",
+    "better-sqlite3": "^11.8.0",
+    "picocolors": "^1.1.1"
+  }
+}

package/src/commands.mjs

@@ -0,0 +1,228 @@
+import { intro, outro, select, text, confirm, cancel, isCancel, log, note } from '@clack/prompts'
+import pc from 'picocolors'
+import * as manager from './providers/manager.mjs'
+import { loadProviders } from './providers/index.mjs'
+
+function guard(result) {
+  if (isCancel(result)) {
+    cancel('Cancelled')
+    process.exit(0)
+  }
+  return result
+}
+
+// ── ccx list ────────────────────────────────────────────
+
+export async function list() {
+  intro(pc.cyan(pc.bold('⚡ ccx list')))
+
+  const { providers, source } = await loadProviders()
+
+  if (providers.length === 0) {
+    log.warn('No providers found')
+    outro(pc.dim('Run `ccx add` to add one'))
+    return
+  }
+
+  log.message(pc.dim(`${providers.length} providers from ${source}`))
+
+  const lines = providers.map((p, i) => {
+    const idx = pc.dim(`${String(i + 1).padStart(2)}.`)
+    const name = pc.bold(p.name)
+    const model = pc.dim(p.model)
+    const url = pc.dim(p.env?.ANTHROPIC_BASE_URL || '')
+    return `${idx} ${name}  ${model}\n      ${url}`
+  })
+
+  note(lines.join('\n'), 'Providers')
+  outro(pc.dim(`Config: ${manager.filePath}`))
+}
+
+// ── ccx add ─────────────────────────────────────────────
+
+export async function add() {
+  intro(pc.cyan(pc.bold('⚡ ccx add')))
+
+  const name = guard(await text({
+    message: 'Provider name',
+    placeholder: 'e.g. Zhipu GLM-5.1',
+    validate: (v) => v.trim() ? undefined : 'Name is required',
+  }))
+
+  const baseUrl = guard(await text({
+    message: 'API base URL',
+    placeholder: 'e.g. https://open.bigmodel.cn/api/anthropic',
+    validate: (v) => v.trim() ? undefined : 'URL is required',
+  }))
+
+  const authToken = guard(await text({
+    message: 'API key / Auth token',
+    placeholder: 'sk-xxx or your-api-key',
+    validate: (v) => v.trim() ? undefined : 'Token is required',
+  }))
+
+  const model = guard(await text({
+    message: 'Model name',
+    placeholder: 'e.g. glm-5.1, claude-sonnet-4-20250514',
+    validate: (v) => v.trim() ? undefined : 'Model is required',
+  }))
+
+  const fillAll = guard(await confirm({
+    message: 'Set this model for all roles (Sonnet/Opus/Haiku)?',
+    initialValue: true,
+  }))
+
+  const env = {
+    ANTHROPIC_BASE_URL: baseUrl.trim(),
+    ANTHROPIC_AUTH_TOKEN: authToken.trim(),
+    ANTHROPIC_MODEL: model.trim(),
+  }
+
+  if (fillAll) {
+    env.ANTHROPIC_DEFAULT_SONNET_MODEL = model.trim()
+    env.ANTHROPIC_DEFAULT_OPUS_MODEL = model.trim()
+    env.ANTHROPIC_DEFAULT_HAIKU_MODEL = model.trim()
+    env.ANTHROPIC_REASONING_MODEL = model.trim()
+  }
+
+  const provider = {
+    name: name.trim(),
+    model: model.trim(),
+    env,
+  }
+
+  note(
+    [
+      `${pc.bold('Name:')}  ${provider.name}`,
+      `${pc.bold('Model:')} ${provider.model}`,
+      `${pc.bold('URL:')}   ${env.ANTHROPIC_BASE_URL}`,
+      `${pc.bold('Key:')}   ${env.ANTHROPIC_AUTH_TOKEN.slice(0, 8)}${'*'.repeat(8)}`,
+    ].join('\n'),
+    'Review',
+  )
+
+  const ok = guard(await confirm({ message: 'Add this provider?' }))
+
+  if (!ok) {
+    cancel('Cancelled')
+    return
+  }
+
+  manager.add(provider)
+  outro(pc.green('✔') + ` Added ${pc.bold(provider.name)}`)
+}
+
+// ── ccx rm ──────────────────────────────────────────────
+
+export async function rm() {
+  intro(pc.cyan(pc.bold('⚡ ccx rm')))
+
+  const providers = manager.getAll()
+
+  if (providers.length === 0) {
+    log.warn('No providers in JSON config')
+    outro(pc.dim('Nothing to remove'))
+    return
+  }
+
+  const result = guard(await select({
+    message: 'Remove which provider?',
+    options: providers.map((p, i) => ({
+      value: i,
+      label: p.name,
+      hint: pc.dim(p.model || p.env?.ANTHROPIC_MODEL || ''),
+    })),
+  }))
+
+  const target = providers[result]
+
+  const ok = guard(await confirm({
+    message: `Remove ${pc.bold(target.name)}?`,
+    initialValue: false,
+  }))
+
+  if (!ok) {
+    cancel('Cancelled')
+    return
+  }
+
+  manager.remove(result)
+  outro(pc.green('✔') + ` Removed ${pc.bold(target.name)}`)
+}
+
+// ── ccx edit ────────────────────────────────────────────
+
+export async function edit() {
+  intro(pc.cyan(pc.bold('⚡ ccx edit')))
+
+  const providers = manager.getAll()
+
+  if (providers.length === 0) {
+    log.warn('No providers in JSON config')
+    outro(pc.dim('Run `ccx add` to add one'))
+    return
+  }
+
+  const index = guard(await select({
+    message: 'Edit which provider?',
+    options: providers.map((p, i) => ({
+      value: i,
+      label: p.name,
+      hint: pc.dim(p.model || p.env?.ANTHROPIC_MODEL || ''),
+    })),
+  }))
+
+  const current = providers[index]
+  const env = current.env || {}
+
+  const name = guard(await text({
+    message: 'Provider name',
+    initialValue: current.name,
+    validate: (v) => v.trim() ? undefined : 'Name is required',
+  }))
+
+  const baseUrl = guard(await text({
+    message: 'API base URL',
+    initialValue: env.ANTHROPIC_BASE_URL || '',
+    validate: (v) => v.trim() ? undefined : 'URL is required',
+  }))
+
+  const authToken = guard(await text({
+    message: 'API key / Auth token',
+    initialValue: env.ANTHROPIC_AUTH_TOKEN || '',
+    validate: (v) => v.trim() ? undefined : 'Token is required',
+  }))
+
+  const model = guard(await text({
+    message: 'Model name',
+    initialValue: env.ANTHROPIC_MODEL || current.model || '',
+    validate: (v) => v.trim() ? undefined : 'Model is required',
+  }))
+
+  const fillAll = guard(await confirm({
+    message: 'Set this model for all roles (Sonnet/Opus/Haiku)?',
+    initialValue: true,
+  }))
+
+  const newEnv = {
+    ANTHROPIC_BASE_URL: baseUrl.trim(),
+    ANTHROPIC_AUTH_TOKEN: authToken.trim(),
+    ANTHROPIC_MODEL: model.trim(),
+  }
+
+  if (fillAll) {
+    newEnv.ANTHROPIC_DEFAULT_SONNET_MODEL = model.trim()
+    newEnv.ANTHROPIC_DEFAULT_OPUS_MODEL = model.trim()
+    newEnv.ANTHROPIC_DEFAULT_HAIKU_MODEL = model.trim()
+    newEnv.ANTHROPIC_REASONING_MODEL = model.trim()
+  }
+
+  const updated = {
+    name: name.trim(),
+    model: model.trim(),
+    env: newEnv,
+  }
+
+  manager.update(index, updated)
+  outro(pc.green('✔') + ` Updated ${pc.bold(updated.name)}`)
+}

package/src/config.mjs

@@ -0,0 +1,44 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+const CONFIG_DIR = join(process.env.XDG_CONFIG_HOME || join(homedir(), '.config'), 'ccx')
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json')
+
+function ensureDir() {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true })
+  }
+}
+
+function load() {
+  ensureDir()
+  if (!existsSync(CONFIG_FILE)) return {}
+  try {
+    return JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'))
+  } catch {
+    return {}
+  }
+}
+
+function save(config) {
+  ensureDir()
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n')
+}
+
+export function get(key) {
+  return load()[key]
+}
+
+export function set(key, value) {
+  const config = load()
+  config[key] = value
+  save(config)
+}
+
+export function reset() {
+  save({})
+}
+
+export const configDir = CONFIG_DIR
+export const configFile = CONFIG_FILE

package/src/launcher.mjs

@@ -0,0 +1,218 @@
+import { intro, outro, select, cancel, isCancel, log } from '@clack/prompts'
+import pc from 'picocolors'
+import { writeFileSync, mkdtempSync, rmSync } from 'node:fs'
+import { join } from 'node:path'
+import { tmpdir } from 'node:os'
+import { spawn } from 'node:child_process'
+import { loadProviders } from './providers/index.mjs'
+import { detectTerminals, getTerminal } from './terminals/index.mjs'
+import * as config from './config.mjs'
+import * as commands from './commands.mjs'
+
+const VERSION = '0.1.0'
+
+const SUBCOMMANDS = ['list', 'ls', 'add', 'rm', 'remove', 'edit', 'help']
+
+function parseArgs(argv) {
+  const flags = { newWindow: false, help: false, version: false, reset: false }
+  let command = null
+  let query = ''
+
+  for (const arg of argv) {
+    switch (arg) {
+      case '--new': case '-n': flags.newWindow = true; break
+      case '--help': case '-h': flags.help = true; break
+      case '--version': case '-v': flags.version = true; break
+      case '--reset': flags.reset = true; break
+      default:
+        if (arg.startsWith('-')) {
+          console.error(`Unknown option: ${arg}`)
+          process.exit(1)
+        }
+        if (!command && SUBCOMMANDS.includes(arg)) {
+          command = arg
+        } else {
+          query = arg
+        }
+    }
+  }
+
+  return { flags, command, query }
+}
+
+function showHelp() {
+  console.log(`
+  ${pc.cyan(pc.bold('⚡ ccx'))} ${pc.dim(`v${VERSION}`)}
+  ${pc.dim('Claude Code launcher')}
+
+  ${pc.bold('Usage:')} ccx [command] [options] [provider-name]
+
+  ${pc.bold('Commands:')}
+    ${pc.cyan('list')}, ${pc.cyan('ls')}     List all providers
+    ${pc.cyan('add')}           Add a new provider
+    ${pc.cyan('edit')}          Edit an existing provider
+    ${pc.cyan('rm')}            Remove a provider
+
+  ${pc.bold('Options:')}
+    ${pc.cyan('-n')}, ${pc.cyan('--new')}      Open in a new terminal window
+    ${pc.cyan('-h')}, ${pc.cyan('--help')}     Show this help
+    ${pc.cyan('-v')}, ${pc.cyan('--version')}  Show version
+    ${pc.cyan('--reset')}        Reset all configuration
+
+  ${pc.bold('Examples:')}
+    ${pc.dim('$')} ccx              ${pc.dim('# Interactive select, current terminal')}
+    ${pc.dim('$')} ccx glm          ${pc.dim('# Fuzzy match provider name')}
+    ${pc.dim('$')} ccx --new        ${pc.dim('# Interactive select, new window')}
+    ${pc.dim('$')} ccx add          ${pc.dim('# Add a new provider')}
+    ${pc.dim('$')} ccx list         ${pc.dim('# List all providers')}
+    ${pc.dim('$')} ccx edit         ${pc.dim('# Edit a provider')}
+    ${pc.dim('$')} ccx rm           ${pc.dim('# Remove a provider')}
+
+  ${pc.bold('Providers:')}
+    ${pc.cyan('cc-switch')}  ${pc.dim('auto-detected from ~/.cc-switch/cc-switch.db')}
+    ${pc.cyan('JSON file')}  ${pc.dim('configure at ~/.config/ccx/providers.json')}
+
+  ${pc.bold('Config:')} ${pc.dim('~/.config/ccx/config.json')}
+`)
+}
+
+function writeTempSettings(env) {
+  const dir = mkdtempSync(join(tmpdir(), 'ccx-'))
+  const file = join(dir, 'settings.json')
+  writeFileSync(file, JSON.stringify({ env }, null, 2))
+  return file
+}
+
+async function selectTerminal() {
+  const saved = config.get('terminal')
+  if (saved) {
+    const t = getTerminal(saved)
+    if (t) return t
+  }
+
+  const available = detectTerminals()
+  if (available.length === 1) {
+    config.set('terminal', available[0].name)
+    return available[0]
+  }
+
+  const result = await select({
+    message: 'Select default terminal for new windows',
+    options: available.map(t => ({ value: t.name, label: t.name })),
+  })
+
+  if (isCancel(result)) {
+    cancel('Cancelled')
+    process.exit(0)
+  }
+
+  config.set('terminal', result)
+  return getTerminal(result)
+}
+
+export async function run(argv) {
+  const { flags, command, query } = parseArgs(argv)
+
+  if (flags.version) {
+    console.log(`ccx ${VERSION}`)
+    return
+  }
+
+  if (flags.help) {
+    showHelp()
+    return
+  }
+
+  if (flags.reset) {
+    config.reset()
+    log.success('Config reset')
+    return
+  }
+
+  // Handle subcommands
+  if (command) {
+    switch (command) {
+      case 'help': showHelp(); return
+      case 'list': case 'ls': return commands.list()
+      case 'add': return commands.add()
+      case 'rm': case 'remove': return commands.rm()
+      case 'edit': return commands.edit()
+    }
+  }
+
+  // Default: launch claude
+  intro(`${pc.cyan(pc.bold('⚡ ccx'))} ${pc.dim('— Claude Code eXecutor')}`)
+  const { providers, source } = await loadProviders()
+  log.message(
+    pc.dim(`${providers.length} providers from ${source || 'none'} · v${VERSION}\n`) +
+    pc.dim(`  ccx ${pc.cyan('add')}   Add provider    ccx ${pc.cyan('edit')}  Edit provider\n`) +
+    pc.dim(`  ccx ${pc.cyan('list')}  List providers   ccx ${pc.cyan('rm')}    Remove provider\n`) +
+    pc.dim(`  ccx ${pc.cyan('-n')}    New window       ccx ${pc.cyan('help')}  Show help`),
+  )
+
+  if (providers.length === 0) {
+    log.error('No providers found')
+    log.message('')
+    log.message(`  ${pc.cyan('1.')} Run ${pc.bold('ccx add')} to add a provider`)
+    log.message(`  ${pc.cyan('2.')} Or install ${pc.bold('cc-switch')} for auto-detection`)
+    log.message('')
+    cancel('Setup a provider first')
+    return
+  }
+
+  // Select provider
+  let selected
+
+  if (query) {
+    const lowerQuery = query.toLowerCase()
+    selected = providers.find(p =>
+      p.name.toLowerCase().includes(lowerQuery) ||
+      p.model.toLowerCase().includes(lowerQuery),
+    )
+
+    if (!selected) {
+      log.warn(`No match for "${query}"`)
+    }
+  }
+
+  if (!selected) {
+    const result = await select({
+      message: 'Select provider',
+      options: providers.map(p => ({
+        value: p.id,
+        label: p.name,
+        hint: pc.dim(p.model),
+      })),
+    })
+
+    if (isCancel(result)) {
+      cancel('Cancelled')
+      process.exit(0)
+    }
+
+    selected = providers.find(p => p.id === result)
+  }
+
+  // Write temp settings
+  const settingsFile = writeTempSettings(selected.env)
+
+  if (flags.newWindow) {
+    const terminal = await selectTerminal()
+    const cwd = process.cwd()
+    const cmd = `cd '${cwd}'; echo '=== Claude Code [${selected.name}] ==='; echo; claude --settings '${settingsFile}'; rm -f '${settingsFile}'; exec bash`
+    terminal.open(cmd)
+    outro(`${pc.green('⚡')} ${selected.name} ${pc.dim(`(${selected.model})`)} → ${pc.dim(terminal.name)}`)
+  } else {
+    outro(`${pc.green('⚡')} ${selected.name} ${pc.dim(`(${selected.model})`)}`)
+
+    const child = spawn('claude', ['--settings', settingsFile], {
+      stdio: 'inherit',
+      env: { ...process.env },
+    })
+
+    child.on('exit', (code) => {
+      try { rmSync(settingsFile, { force: true }) } catch {}
+      process.exit(code ?? 0)
+    })
+  }
+}

package/src/providers/cc-switch.mjs

@@ -0,0 +1,35 @@
+import { existsSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+const DB_PATH = join(homedir(), '.cc-switch', 'cc-switch.db')
+
+export function detect() {
+  return existsSync(DB_PATH)
+}
+
+export async function list() {
+  const Database = (await import('better-sqlite3')).default
+  const db = new Database(DB_PATH, { readonly: true })
+
+  try {
+    const rows = db.prepare(`
+      SELECT id, name, json_extract(settings_config, '$.env.ANTHROPIC_MODEL') as model,
+             json_extract(settings_config, '$.env') as env
+      FROM providers
+      WHERE app_type = 'claude' AND settings_config LIKE '%"env"%'
+      ORDER BY sort_index
+    `).all()
+
+    return rows.map(row => ({
+      id: row.id,
+      name: row.name,
+      model: row.model || 'unknown',
+      env: JSON.parse(row.env || '{}'),
+    }))
+  } finally {
+    db.close()
+  }
+}
+
+export const source = 'cc-switch'

package/src/providers/index.mjs

@@ -0,0 +1,20 @@
+import * as ccSwitch from './cc-switch.mjs'
+import * as jsonFile from './json-file.mjs'
+
+const sources = [ccSwitch, jsonFile]
+
+export async function loadProviders() {
+  for (const source of sources) {
+    if (source.detect()) {
+      try {
+        const providers = await source.list()
+        if (providers.length > 0) {
+          return { providers, source: source.source }
+        }
+      } catch {
+        // Try next source
+      }
+    }
+  }
+  return { providers: [], source: null }
+}

package/src/providers/json-file.mjs

@@ -0,0 +1,28 @@
+import { existsSync, readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+const PROVIDERS_FILE = join(
+  process.env.XDG_CONFIG_HOME || join(homedir(), '.config'),
+  'ccx',
+  'providers.json',
+)
+
+export function detect() {
+  return existsSync(PROVIDERS_FILE)
+}
+
+export function list() {
+  const data = JSON.parse(readFileSync(PROVIDERS_FILE, 'utf-8'))
+  const providers = data.providers || []
+
+  return providers.map((p, i) => ({
+    id: `json:${i}`,
+    name: p.name,
+    model: p.model || p.env?.ANTHROPIC_MODEL || 'unknown',
+    env: p.env || {},
+  }))
+}
+
+export const source = 'json'
+export const filePath = PROVIDERS_FILE

package/src/providers/manager.mjs

@@ -0,0 +1,52 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join, dirname } from 'node:path'
+
+const PROVIDERS_FILE = join(
+  process.env.XDG_CONFIG_HOME || join(homedir(), '.config'),
+  'ccx',
+  'providers.json',
+)
+
+function ensureFile() {
+  const dir = dirname(PROVIDERS_FILE)
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true })
+  if (!existsSync(PROVIDERS_FILE)) {
+    writeFileSync(PROVIDERS_FILE, JSON.stringify({ providers: [] }, null, 2) + '\n')
+  }
+}
+
+function load() {
+  ensureFile()
+  return JSON.parse(readFileSync(PROVIDERS_FILE, 'utf-8'))
+}
+
+function save(data) {
+  ensureFile()
+  writeFileSync(PROVIDERS_FILE, JSON.stringify(data, null, 2) + '\n')
+}
+
+export function getAll() {
+  return load().providers || []
+}
+
+export function add(provider) {
+  const data = load()
+  data.providers = data.providers || []
+  data.providers.push(provider)
+  save(data)
+}
+
+export function remove(index) {
+  const data = load()
+  data.providers.splice(index, 1)
+  save(data)
+}
+
+export function update(index, provider) {
+  const data = load()
+  data.providers[index] = provider
+  save(data)
+}
+
+export const filePath = PROVIDERS_FILE

package/src/terminals/index.mjs

@@ -0,0 +1,38 @@
+import { existsSync } from 'node:fs'
+import { execSync } from 'node:child_process'
+
+const terminals = [
+  {
+    name: 'Ghostty',
+    detect: () => existsSync('/Applications/Ghostty.app'),
+    open: (cmd) => execSync(`open -na Ghostty.app --args -e bash -c "${cmd}"`),
+  },
+  {
+    name: 'iTerm2',
+    detect: () => existsSync('/Applications/iTerm.app'),
+    open: (cmd) => execSync(`osascript -e 'tell application "iTerm" to create window with default profile command "bash -c \\"${cmd}\\""'`),
+  },
+  {
+    name: 'Warp',
+    detect: () => existsSync('/Applications/Warp.app'),
+    open: (cmd) => execSync(`open -na Warp.app --args bash -c "${cmd}"`),
+  },
+  {
+    name: 'kitty',
+    detect: () => existsSync('/Applications/kitty.app'),
+    open: (cmd) => execSync(`/Applications/kitty.app/Contents/MacOS/kitty bash -c "${cmd}" &`),
+  },
+  {
+    name: 'Terminal',
+    detect: () => true,
+    open: (cmd) => execSync(`osascript -e 'tell application "Terminal" to do script "${cmd}"'`),
+  },
+]
+
+export function detectTerminals() {
+  return terminals.filter(t => t.detect())
+}
+
+export function getTerminal(name) {
+  return terminals.find(t => t.name === name)
+}