noiton 1.0.0 → 2.0.0

package/README.md

@@ -1,6 +1,8 @@
-# NOITON
+# 🐙 NOITON
 
-OpenCode authenticator - configure providers with a single key.
+**Universal AI Agent Connector** — one key, many agents.
+
+NOITON is a CLI wizard that connects your API key to multiple AI coding agents at once. Run it once, pick your agents, paste your key — done.
 
 ## Quick Start
 
@@ -8,51 +10,64 @@ OpenCode authenticator - configure providers with a single key.
 npx noiton
 ```
 
-The wizard will:
-1. Ask for your NOITON API key
-2. Validate it against the API
-3. Fetch available models
-4. Write the `noiton` provider to your `opencode.json`
+The octopus will:
+1. 🔍 Detect which AI agents are installed (OpenCode, Hermes, OpenClaw, Cline, Aider, Kilo Code, Kimi Code)
+2. 📦 If none found, offer to install OpenCode or Hermes based on your use case
+3. 🔄 If OpenCode is outdated, offer to update it
+4. 🔑 Ask for your NOITON API key (one key serves all agents)
+5. 📋 Fetch available models from the API
+6. ⚙️ Configure each selected agent in its native format
+7. 🎉 Show a funny success message (with easter eggs on holidays!)
+
+## Supported Agents
+
+| Agent | Type | Config Format | Multiple Models |
+|-------|------|---------------|-----------------|
+| **OpenCode** | CLI | JSON (`opencode.json`) | ✅ |
+| **Hermes** | CLI | YAML (`config.yaml` + `.env`) | Single default |
+| **OpenClaw** | CLI | JSON5 (`openclaw.json`) | ✅ |
+| **Cline** | VS Code ext | JSON (VS Code settings) | Single |
+| **Aider** | CLI | YAML (`.aider.conf.yml` + `.env`) | Single |
+| **Kilo Code** | CLI + VS Code | JSONC (`kilo.jsonc`) | ✅ |
+| **Kimi Code** | CLI + VS Code | TOML (`config.toml`) | Single |
 
 ## Commands
 
 ```bash
 npx noiton            # Setup wizard (default)
-npx noiton status     # Show current configuration
+npx noiton status     # Show configuration across all agents
 npx noiton refresh    # Re-fetch models from API
-npx noiton change     # Change API key
-npx noiton remove     # Remove NOITON from config
+npx noiton change     # Change API key in all agents
+npx noiton remove     # Remove NOITON from all agents
 npx noiton help       # Show help
+npx noiton --version  # Show version
 ```
 
 ## How It Works
 
-NOITON adds a provider to your `~/.config/opencode/opencode.json`:
-
-```json
-{
-  "provider": {
-    "noiton": {
-      "npm": "@ai-sdk/openai-compatible",
-      "name": "NOITON",
-      "options": {
-        "baseURL": "https://blogs-litellm-app.rwezkp.easypanel.host",
-        "apiKey": "sk-your-key-here"
-      },
-      "models": {
-        "model-id": { "name": "Model Name", "limit": { ... } }
-      }
-    }
-  }
-}
-```
+NOITON detects your installed agents and writes to each one's native config format:
+
+- **OpenCode** → `~/.config/opencode/opencode.json` (provider block)
+- **Hermes** → `~/.hermes/config.yaml` (model block) + `~/.hermes/.env` (API key)
+- **OpenClaw** → `~/.openclaw/openclaw.json` (models.providers block)
+- **Cline** → VS Code `settings.json` (cline.* keys)
+- **Aider** → `~/.aider.conf.yml` (openai-api-base) + `~/.env` (OPENAI_API_KEY)
+- **Kilo Code** → `~/.config/kilo/kilo.jsonc` (provider.openai-compatible block)
+- **Kimi Code** → `~/.kimi-code/config.toml` (providers + models blocks)
+
+Existing configurations are preserved — NOITON only adds/removes its own entries.
+
+## Auto-Install
+
+If no agents are detected, NOITON asks what you want to do:
 
-After running `npx noiton`, restart OpenCode and the models will be available.
+- 💻 **Programar** → installs OpenCode (`curl -fsSL https://opencode.ai/install | bash`)
+- 🤖 **Assistente** → installs Hermes (`pip install nous-hermes`)
 
 ## Requirements
 
 - Node.js >= 18
-- OpenCode CLI installed
+- At least one supported agent (or let NOITON install one for you)
 
 ## License
 

package/package.json

@@ -1,17 +1,26 @@
 {
   "name": "noiton",
-  "version": "1.0.0",
-  "description": "OpenCode authenticator - configure providers with a single key",
+  "version": "2.0.0",
+  "description": "🐙 Universal AI Agent Connector - one key, many agents (OpenCode, Hermes, OpenClaw, Cline, Aider, Kilo, Kimi)",
   "keywords": [
+    "noiton",
     "opencode",
-    "auth",
+    "hermes",
+    "openclaw",
+    "cline",
+    "aider",
+    "kilo",
+    "kimi",
+    "ai",
     "cli",
-    "noiton",
-    "provider",
-    "ai"
+    "agent",
+    "wizard",
+    "setup",
+    "auth"
   ],
   "license": "MIT",
   "author": "NOITON",
+  "homepage": "https://github.com/tokensilimitados/noiton",
   "type": "module",
   "bin": {
     "noiton": "./bin/noiton.js"
@@ -27,11 +36,19 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@inquirer/prompts": "^7.0.0"
+    "@inquirer/prompts": "^7.0.0",
+    "@iarna/toml": "^2.2.5",
+    "boxen": "^8.0.0",
+    "gradient-string": "^3.0.0",
+    "json5": "^2.2.3",
+    "ora": "^8.0.0",
+    "picocolors": "^1.1.0",
+    "yaml": "^2.8.4"
   },
   "scripts": {
     "test": "node --test tests/",
-    "prepublishOnly": "echo 'no build step - pure JS'"
+    "prepublishOnly": "echo 'no build step - pure JS'",
+    "view-octopus": "node -e \"import('./src/octopus.js').then(m => console.log(m.octopusHappy()))\""
   },
   "publishConfig": {
     "access": "public",

package/src/commands/change.js

@@ -1,77 +1,67 @@
+/**
+ * NOITON change command - swap the API key across all configured agents
+ */
+
 import { input, confirm } from "@inquirer/prompts";
-import { BANNER, color } from "../constants.js";
+import { c } from "../constants.js";
+import { printHeader, spinner, ok, fail, info, box, dim } from "../ui.js";
+import { getConfiguredAgents } from "../lib/agents/index.js";
 import { validateKey, maskKey } from "../lib/api.js";
-import {
-  readConfig,
-  writeConfig,
-  hasProvider,
-  getProvider,
-  upsertProvider,
-  buildModels,
-} from "../lib/config.js";
+import { farewellMessage } from "../messages.js";
 
-/**
- * Change API key (re-runs wizard with new key).
- */
 export async function changeCommand() {
-  console.log(BANNER);
+  printHeader("Trocar Chave API");
 
-  const { config, path } = readConfig();
+  const configured = getConfiguredAgents();
 
-  if (!hasProvider(config)) {
-    console.log(color("  ❌ NOITON não está configurado.\n", "red"));
-    console.log(color("  Rode ", "dim") + color("npx noiton", "cyan") + color(" para configurar.\n", "dim"));
-    process.exit(1);
+  if (configured.length === 0) {
+    box("NOITON não está configurado em nenhum agente.\n\nRode 'npx noiton' para configurar.", "warning");
+    return;
   }
 
-  const provider = getProvider(config);
-  const oldKey = provider?.options?.apiKey || "";
-
-  console.log(color("  Chave atual: ", "dim") + maskKey(oldKey) + "\n");
+  info(`Agentes configurados: ${configured.map(a => a.name).join(", ")}`);
+  console.log();
 
   const newKey = await input({
-    message: "  Nova chave:",
+    message: "  Nova chave NOITON:",
     validate: (v) => (v.trim().length >= 10 ? true : "Chave muito curta"),
     transformer: (v) => maskKey(v),
   });
 
-  const trimmedKey = newKey.trim();
+  const trimmed = newKey.trim();
 
-  console.log(color("\n  ⏳ Validando nova chave...", "dim"));
-
-  const { valid, models, error } = await validateKey(trimmedKey);
+  // Validate the new key
+  const s = spinner("Validando nova chave...");
+  const { valid, error } = await validateKey(trimmed);
 
   if (!valid) {
-    console.log(color(`\n  ❌ Erro: ${error}\n`, "red"));
-    process.exit(1);
-  }
-
-  console.log(color("  ✓ Chave válida!\n", "green"));
-
-  if (!models || models.length === 0) {
-    console.log(color("  ⚠  Nenhum modelo disponível para esta chave.\n", "yellow"));
-    process.exit(1);
-  }
-
-  console.log(color(`  📦 ${models.length} modelo(s) encontrado(s):\n`, "cyan"));
-  for (const m of models) {
-    console.log(`    • ${m.id}`);
+    s.fail(`Chave inválida: ${error}`);
+    return;
   }
 
-  const proceed = await confirm({
-    message: "\n  Atualizar configuração com a nova chave?",
-    default: true,
-  });
-
-  if (!proceed) {
-    console.log(color("\n  ✋ Operação cancelada.\n", "dim"));
-    return;
+  s.succeed("Nova chave válida!");
+  console.log();
+
+  let success = 0;
+  for (const agent of configured) {
+    const sub = spinner(`Atualizando ${agent.name}...`);
+    try {
+      agent.changeKey(trimmed);
+      sub.succeed(`${agent.name} atualizado!`);
+      success++;
+    } catch (err) {
+      sub.fail(`${agent.name}: ${err.message}`);
+    }
   }
 
-  const modelsObj = buildModels(models);
-  const newConfig = upsertProvider(config, trimmedKey, modelsObj);
-  writeConfig(newConfig, path);
+  console.log();
+  box(
+    success > 0
+      ? `✨ Chave trocada em ${success} agente(s)!`
+      : "⚠️ Nenhum agente pôde ser atualizado.",
+    success > 0 ? "success" : "warning"
+  );
 
-  console.log(color("\n  ✓ Chave atualizada!\n", "green"));
-  console.log(color("  🚀 Reinicie o OpenCode para usar a nova chave.\n", "cyan"));
+  console.log();
+  console.log(c.dim(`  ${farewellMessage()}`));
 }

package/src/commands/init.js

@@ -1,85 +1,308 @@
-import { input, confirm } from "@inquirer/prompts";
-import { BANNER, color } from "../constants.js";
+/**
+ * NOITON init command - the universal multi-agent wizard
+ *
+ * Flow:
+ *   1. Print banner with octopus mascot
+ *   2. Detect all installed agents
+ *   3. If OpenCode installed, check version & offer update
+ *   4. If no agents, offer to install OpenCode or Hermes (based on use case)
+ *   5. Show checklist of detected agents
+ *   6. Ask which agents to configure
+ *   7. Ask for NOITON API key (once)
+ *   8. Validate key + fetch models
+ *   9. Ask which model to use as primary (for single-model agents)
+ *   10. Configure each selected agent
+ *   11. Show funny success message + easter egg
+ */
+
+import { input, confirm, select, checkbox } from "@inquirer/prompts";
+import { c } from "../constants.js";
+import {
+  printBanner,
+  box,
+  spinner,
+  ok,
+  warn,
+  fail,
+  info,
+  dim,
+  step,
+  checklist,
+  divider,
+  withSpinner,
+} from "../ui.js";
+import {
+  successMessage,
+  noAgentMessage,
+  thinkingMessage,
+  cancelMessage,
+  farewellMessage,
+  getEasterEgg,
+} from "../messages.js";
 import { validateKey, maskKey } from "../lib/api.js";
+import { getDetectedAgents, getAgent } from "../lib/agents/index.js";
 import {
-  readConfig,
-  writeConfig,
-  hasProvider,
-  upsertProvider,
-  buildModels,
-} from "../lib/config.js";
+  detectAgents,
+  getOpenCodeStatus,
+  getRecommendedAgent,
+} from "../lib/detect.js";
+import { installAgent, updateAgent, offerInstall } from "../lib/install.js";
 
-/**
- * Main wizard command - interactive setup.
- */
 export async function initCommand() {
-  console.log(BANNER);
+  // ============= STEP 1: BANNER =============
+  printBanner("happy");
+
+  // ============= STEP 2: DETECT AGENTS =============
+  step(1, "Procurando agentes de IA instalados...");
+
+  const detected = getDetectedAgents();
+  const opencodeStatus = getOpenCodeStatus();
+
+  if (detected.length === 0) {
+    // ============= STEP 2a: NO AGENTS - OFFER INSTALL =============
+    console.log();
+    box(noAgentMessage(), "warning");
+    console.log();
+
+    const installChoice = await offerInstall();
+    if (!installChoice) {
+      console.log();
+      info(cancelMessage());
+      console.log();
+      console.log(c.dim("  💡 Dica: instale OpenCode ou Hermes e rode noiton novamente!"));
+      console.log(c.dim("     OpenCode: curl -fsSL https://opencode.ai/install | bash"));
+      console.log(c.dim("     Hermes:   pip install nous-hermes"));
+      console.log();
+      return;
+    }
+
+    // Install the chosen agent
+    const result = await installAgent(installChoice);
+    if (!result.ok) {
+      console.log();
+      fail(`Não foi possível instalar: ${result.error}`);
+      console.log(c.dim("  Tente instalar manualmente e rode noiton novamente."));
+      return;
+    }
+
+    // Re-detect after install
+    const reDetected = getDetectedAgents();
+    if (reDetected.length === 0) {
+      console.log();
+      warn("Instalação concluída, mas não foi possível detectar o agente.");
+      info("Reinicie o terminal e rode 'npx noiton' novamente.");
+      return;
+    }
+    detected.push(...reDetected);
+  }
+
+  // ============= STEP 2b: CHECK OPENCODE VERSION =============
+  if (opencodeStatus?.updateAvailable) {
+    console.log();
+    box(
+      `🔄 OpenCode v${opencodeStatus.latest} disponível!\n` +
+      `   Você tem v${opencodeStatus.version}.\n\n` +
+      `   Atualizar agora?`,
+      "warning"
+    );
+    const wantUpdate = await confirm({
+      message: "Atualizar OpenCode?",
+      default: true,
+    });
+    if (wantUpdate) {
+      const updateResult = await updateAgent("opencode");
+      if (updateResult.ok) {
+        ok("OpenCode atualizado!");
+      } else {
+        warn(`Não foi possível atualizar: ${updateResult.error}`);
+      }
+    }
+  }
+
+  // ============= STEP 3: SHOW CHECKLIST =============
+  step(2, "Agentes detectados");
+
+  const items = detected.map((a) => ({
+    label: a.name,
+    ok: true,
+    detail: a.version ? `v${a.version}` : "(config encontrado)",
+  }));
+  checklist(items);
+  console.log();
 
-  const { config, path } = readConfig();
+  // ============= STEP 4: CHOOSE AGENTS TO CONFIGURE =============
+  step(3, "Escolha quais agentes configurar");
 
-  if (hasProvider(config)) {
-    console.log(color("  ⚠  NOITON já está configurado!\n", "yellow"));
+  const agentChoices = detected.map((a) => ({
+    name: `${a.name}${a.version ? ` (v${a.version})` : ""}`,
+    value: a.id,
+    checked: true,
+  }));
+
+  let selectedIds;
+  if (detected.length === 1) {
+    selectedIds = [detected[0].id];
+    info(`Configurando: ${detected[0].name}`);
+  } else {
+    selectedIds = await checkbox({
+      message: "Quais agentes você quer conectar ao NOITON?",
+      choices: agentChoices,
+      required: true,
+    });
+  }
+
+  const selectedAgents = selectedIds
+    .map((id) => getAgent(id))
+    .filter(Boolean);
+
+  // ============= STEP 5: CHECK EXISTING CONFIG =============
+  const alreadyConfigured = selectedAgents.filter((a) => {
+    try {
+      return a.isConfigured();
+    } catch {
+      return false;
+    }
+  });
+
+  if (alreadyConfigured.length > 0) {
+    console.log();
+    warn(
+      `NOITON já está configurado em: ${alreadyConfigured.map((a) => a.name).join(", ")}`
+    );
     const overwrite = await confirm({
-      message: "Deseja sobrescrever a configuração existente?",
+      message: "Sobrescrever configuração existente?",
       default: false,
     });
     if (!overwrite) {
-      console.log(color("\n  ✋ Operação cancelada.\n", "dim"));
+      console.log();
+      info(cancelMessage());
       return;
     }
   }
 
-  console.log(color("  Cole sua chave NOITON para começar.\n", "dim"));
+  // ============= STEP 6: ASK FOR API KEY =============
+  step(4, "Cole sua chave NOITON");
+  console.log(c.dim("  Uma chave só serve para todos os agentes! 🐙"));
+  console.log();
 
   const apiKey = await input({
-    message: "  Chave:",
+    message: "  Chave NOITON:",
     validate: (v) => (v.trim().length >= 10 ? true : "Chave muito curta"),
     transformer: (v) => maskKey(v),
   });
 
   const trimmedKey = apiKey.trim();
 
-  console.log(color("\n  ⏳ Validando chave...", "dim"));
-
+  // ============= STEP 7: VALIDATE KEY + FETCH MODELS =============
+  console.log();
+  const s = spinner(`${thinkingMessage()} Validando chave...`);
   const { valid, models, error } = await validateKey(trimmedKey);
 
   if (!valid) {
-    console.log(color(`\n  ❌ Erro: ${error}\n`, "red"));
-    process.exit(1);
+    s.fail(`Erro: ${error}`);
+    console.log();
+    fail("Não foi possível validar a chave. Verifique e tente novamente.");
+    return;
   }
 
-  console.log(color("  ✓ Chave válida!\n", "green"));
+  s.succeed("Chave válida!");
+  console.log();
 
   if (!models || models.length === 0) {
-    console.log(color("  ⚠  Nenhum modelo disponível para esta chave.\n", "yellow"));
-    process.exit(1);
+    warn("Nenhum modelo disponível para esta chave.");
+    return;
   }
 
-  console.log(color(`  📦 ${models.length} modelo(s) encontrado(s):\n`, "cyan"));
+  // ============= STEP 8: SHOW MODELS =============
+  step(5, `Modelos disponíveis (${models.length})`);
+
   for (const m of models) {
     const ctx = m.context_window
-      ? color(` (${Math.round(m.context_window / 1000)}K ctx)`, "dim")
+      ? c.dim(` (${Math.round(m.context_window / 1000)}K ctx)`)
       : "";
-    console.log(`    • ${m.id}${ctx}`);
+    console.log(`  ${c.cyan("•")} ${m.id}${ctx}`);
   }
+  console.log();
 
-  const proceed = await confirm({
-    message: "\n  Configurar OpenCode com estes modelos?",
-    default: true,
-  });
+  // ============= STEP 9: CHOOSE PRIMARY MODEL =============
+  // For agents that only support one model, ask which to use
+  const needsPrimaryModel = selectedAgents.some((a) => !a.supportsMultipleModels);
 
-  if (!proceed) {
-    console.log(color("\n  ✋ Operação cancelada.\n", "dim"));
-    return;
+  let primaryModel = null;
+  if (needsPrimaryModel) {
+    step(6, "Escolha o modelo principal");
+    console.log(c.dim("  Alguns agentes usam apenas 1 modelo por vez."));
+    console.log();
+
+    const modelChoices = models.map((m) => ({
+      name: `${m.id}${m.context_window ? ` (${Math.round(m.context_window / 1000)}K ctx)` : ""}`,
+      value: m.id,
+    }));
+
+    primaryModel = await select({
+      message: "Qual modelo usar como principal?",
+      choices: modelChoices,
+      default: models[0]?.id,
+    });
+    console.log();
   }
 
-  console.log(color("\n  ⏳ Configurando OpenCode...", "dim"));
+  // ============= STEP 10: CONFIGURE EACH AGENT =============
+  step(7, "Configurando agentes...");
+
+  const results = [];
+  for (const agent of selectedAgents) {
+    const s = spinner(`Configurando ${agent.name}...`);
+    try {
+      const result = agent.configure({
+        apiKey: trimmedKey,
+        models,
+        primaryModel,
+      });
+      s.succeed(`${agent.name} configurado!`);
+      results.push({ agent: agent.name, ok: true, ...result });
+    } catch (err) {
+      s.fail(`Erro em ${agent.name}: ${err.message}`);
+      results.push({ agent: agent.name, ok: false, error: err.message });
+    }
+  }
 
-  const modelsObj = buildModels(models);
-  const newConfig = upsertProvider(config, trimmedKey, modelsObj);
-  writeConfig(newConfig, path);
+  // ============= STEP 11: SUMMARY =============
+  console.log();
+  divider();
+  console.log();
+  printBanner("dancing");
+
+  const successCount = results.filter((r) => r.ok).length;
+  if (successCount > 0) {
+    box(
+      `${successMessage()}\n\n` +
+      `${successCount} de ${selectedAgents.length} agente(s) configurado(s):`,
+      "success"
+    );
+    console.log();
+    for (const r of results) {
+      if (r.ok) {
+        ok(`${r.agent} ${c.dim(`→ ${r.path}`)}`);
+      } else {
+        fail(`${r.agent} ${c.dim(`→ ${r.error}`)}`);
+      }
+    }
+  } else {
+    box("Nenhum agente foi configurado. Tente novamente!", "error");
+    return;
+  }
+
+  // ============= STEP 12: EASTER EGG + FAREWELL =============
+  const egg = getEasterEgg();
+  if (egg) {
+    console.log();
+    console.log(c.yellow(`  🎁 ${egg}`));
+  }
 
-  console.log(color("  ✓ Provider 'noiton' adicionado!\n", "green"));
-  console.log(color(`  📁 Arquivo: ${path}\n`, "dim"));
-  console.log(color("  🚀 Reinicie o OpenCode e use os modelos!\n", "cyan"));
+  console.log();
+  console.log(c.dim("  💡 Reinicie os agentes para aplicar as mudanças."));
+  console.log();
+  console.log(c.purple(`  ${farewellMessage()}`));
+  console.log();
 }