pokt-cli 1.0.8 → 1.0.9

package/README.md

@@ -1,6 +1,6 @@
 # Pokt CLI
 
-CLI de **Vibe Coding** com IA: OpenRouter, Ollama (local e cloud), Gemini e provedor Pokt (controller).
+CLI de **Vibe Coding** com IA: OpenAI, Grok (xAI), OpenRouter, Ollama (local e cloud), Gemini e provedor Pokt (controller).
 
 ## Requisitos
 
@@ -60,35 +60,71 @@ pokt --help
 | `pokt models <action>` | Gerenciar modelos (listar, adicionar, trocar) |
 | `pokt provider use <provider>` | Trocar provedor de API |
 | `pokt mcp [action]` | Gerenciar servidores MCP (ferramentas externas) |
+| `pokt doctor` | Diagnóstico (credenciais + conectividade) |
 
 ### Config (`config`)
 
 - `pokt config show` — Mostra a configuração atual (tokens mascarados).
+- `pokt config set-openai -v <key>` — API key OpenAI.
+- `pokt config set-grok -v <key>` — API key Grok (xAI).
 - `pokt config set-openrouter -v <token>` — Token OpenRouter.
 - `pokt config set-ollama -v <url>` — URL base do Ollama local.
 - `pokt config set-ollama-cloud -v <key>` — API key Ollama Cloud.
 - `pokt config set-gemini -v <key>` — API key Google Gemini.
 - `pokt config set-pokt-token -v <token>` — Token do controller Pokt.
 - `pokt config clear-openrouter` — Remove o token OpenRouter.
+- `pokt config clear-openai` — Remove a API key OpenAI.
+- `pokt config clear-grok` — Remove a API key Grok (xAI).
 
 ### Modelos (`models`)
 
 - `pokt models list` — Lista modelos registrados e o ativo.
+- `pokt models fetch-openai` — Busca modelos disponíveis na OpenAI.
+- `pokt models fetch-grok` — Busca modelos disponíveis no Grok (xAI).
 - `pokt models fetch-openrouter` — Busca modelos disponíveis no OpenRouter.
 - `pokt models fetch-ollama` — Busca modelos do Ollama local.
 - `pokt models fetch-ollama-cloud` — Busca modelos do Ollama Cloud.
-- `pokt models add-openrouter`, `add-ollama`, `add-ollama-cloud` — Adiciona modelo (use `-i <id>`).
+- `pokt models add-openai`, `add-grok`, `add-openrouter`, `add-ollama`, `add-ollama-cloud` — Adiciona modelo (use `-i <id>`).
 - `pokt models use -i <id> -p <provider>` — Define o modelo ativo.
 
+### Variáveis de ambiente (opcional)
+
+Se preferir não salvar chaves no computador (ou para CI), você pode usar env vars. O Pokt prioriza env var e depois cai no `pokt config`.
+
+- `OPENAI_API_KEY`
+- `XAI_API_KEY` (ou `GROK_API_KEY`)
+- `OPENROUTER_API_KEY` (ou `OPENROUTER_TOKEN`)
+- `GEMINI_API_KEY` (ou `GOOGLE_API_KEY`)
+- `OLLAMA_BASE_URL`
+- `OLLAMA_CLOUD_API_KEY`
+- `POKT_TOKEN`
+
 ### Provedores (`provider`)
 
-Provedores suportados: `controller` (Pokt), `openrouter`, `gemini`, `ollama`, `ollama-cloud`.
+Provedores suportados: `controller` (Pokt), `openai`, `grok`, `openrouter`, `gemini`, `ollama`, `ollama-cloud`.
 
 ```bash
+pokt provider use openai
+pokt provider use grok
 pokt provider use openrouter
 pokt provider use ollama
 ```
 
+### MCP por projeto (`pokt_cli/mcp.json`)
+
+Na **raiz do seu repositório** (subindo pastas a partir do diretório atual), o Pokt procura uma pasta chamada **`pokt_cli`**, **`Pokt_CLI`**, **`Pot_cli`**, etc. (aceita essas variações, comparação sem diferenciar maiúsculas).
+
+Dentro dela, o arquivo **`mcp.json`** define servidores MCP. O Pokt aceita a chave **`mcpServers`** (Cursor/Claude) ou **`servers`** (ex.: Neon e outros). Opcionalmente `mcp.servers` / `mcp.mcpServers`. O Pokt **mescla** isso com servidores **globais** (`pokt mcp add`); se o **mesmo nome** existir nos dois, vale o do **projeto**.
+
+- `pokt mcp init` — cria `./pokt_cli/mcp.json` com exemplo (no diretório atual).
+- `pokt mcp list` — mostra origem `[projeto]` / `[global]`.
+- `pokt mcp test` — testa stdio e HTTP (Streamable HTTP ou `transport: "sse"`).
+- `pokt mcp link -n <nome>` — para entradas HTTP com `"oauth": true`: abre o navegador, autoriza e grava tokens em `pokt_cli/.mcp-oauth/` (adicione `.mcp-oauth` ao `.gitignore` se não quiser versionar).
+
+Em strings do JSON você pode usar **`${NOME_DA_VARIÁVEL}`** para ler variáveis de ambiente (ex.: tokens em `headers`).
+
+No **chat**, as tools MCP aparecem com prefixo `mcp_`; a IA também pode usar `run_command` e `write_file` para scripts (Python, etc.) quando fizer sentido.
+
 ## Desenvolvimento
 
 ```bash

package/dist/bin/pokt.js

@@ -9,10 +9,13 @@ import { mcpCommand } from '../commands/mcp.js';
 import { updateCommand } from '../commands/update.js';
 import { uninstallCommand } from '../commands/uninstall.js';
 import { proCommand, runProFlow } from '../commands/pro.js';
+import { doctorCommand } from '../commands/doctor.js';
 import prompts from 'prompts';
 import chalk from 'chalk';
 import { ui } from '../ui.js';
 const argv = hideBin(process.argv);
+/** Banner typewriter só na 1ª vez do menu nesta execução; ao voltar de submenus, banner instantâneo. Novo `pokt` = animação de novo. */
+let mainMenuBannerAnimatedThisProcess = false;
 if (argv.length === 0) {
     showMenu();
 }
@@ -25,6 +28,7 @@ else {
         .command(chatCommand)
         .command(providerCommand)
         .command(mcpCommand)
+        .command(doctorCommand)
         .command(updateCommand)
         .command(uninstallCommand)
         .command(proCommand)
@@ -37,7 +41,10 @@ async function showMenu() {
     const active = getEffectiveActiveModel();
     const providerLabel = active ? (PROVIDER_LABELS[active.provider] ?? active.provider) : 'No provider';
     console.log('');
-    await ui.printBanner({ animate: true });
+    const animateBanner = !mainMenuBannerAnimatedThisProcess;
+    if (animateBanner)
+        mainMenuBannerAnimatedThisProcess = true;
+    await ui.printBanner({ animate: animateBanner });
     console.log(ui.statusLine(providerLabel));
     console.log('');
     console.log(ui.separator());
@@ -52,6 +59,7 @@ async function showMenu() {
             { title: '➕ Add / sync models', value: 'add-models' },
             { title: '🏠 Switch API Provider (casa de API)', value: 'provider' },
             { title: '🔌 MCP Servers (tools externos)', value: 'mcp' },
+            { title: '🩺 Doctor (diagnóstico)', value: 'doctor' },
             { title: '⚙️  Configure API Keys / Tokens', value: 'config' },
             { title: '⭐ Torne-se Pro (site — pagamento + chave)', value: 'pro' },
             { title: '🔄 Atualizar Pokt CLI', value: 'update' },
@@ -64,7 +72,8 @@ async function showMenu() {
     }
     if (response.action === 'chat') {
         const { chatCommand } = await import('../commands/chat.js');
-        chatCommand.handler({ fromMenu: true });
+        await chatCommand.handler({ fromMenu: true });
+        return showMenu();
     }
     else if (response.action === 'models') {
         await handleModelsMenu();
@@ -78,6 +87,11 @@ async function showMenu() {
     else if (response.action === 'config') {
         await handleConfigMenu();
     }
+    else if (response.action === 'doctor') {
+        const { doctorCommand } = await import('../commands/doctor.js');
+        await doctorCommand.handler({});
+        return showMenu();
+    }
     else if (response.action === 'pro') {
         runProFlow();
         return showMenu();
@@ -98,8 +112,9 @@ async function showMenu() {
             name: 'mcpAction',
             message: 'MCP:',
             choices: [
-                { title: '🧪 Test connection', value: 'test' },
-                { title: '🔙 Back', value: 'back' }
+                { title: '📄 Criar pokt_cli/mcp.json neste diretório (init)', value: 'init' },
+                { title: '🧪 Testar conexão (global + projeto)', value: 'test' },
+                { title: '🔙 Voltar', value: 'back' }
             ]
         });
         if (mcpResp.mcpAction === 'back')
@@ -179,9 +194,13 @@ async function handleAddModelsMenu() {
         name: 'action',
         message: 'Add or sync models from which provider?',
         choices: [
+            { title: 'OpenAI — sync all from API', value: 'fetch-openai' },
+            { title: 'Grok (xAI) — sync all from API', value: 'fetch-grok' },
             { title: 'OpenRouter — sync all from API', value: 'fetch-openrouter' },
             { title: 'Ollama (local) — sync from your Ollama (list models)', value: 'fetch-ollama' },
             { title: 'Ollama Cloud — sync from API', value: 'fetch-ollama-cloud' },
+            { title: 'OpenAI — add model by ID', value: 'add-openai' },
+            { title: 'Grok (xAI) — add model by ID', value: 'add-grok' },
             { title: 'OpenRouter — add model by ID', value: 'add-openrouter' },
             { title: 'Ollama (local) — add model by ID', value: 'add-ollama' },
             { title: 'Ollama Cloud — add model by ID', value: 'add-ollama-cloud' },
@@ -190,14 +209,18 @@ async function handleAddModelsMenu() {
     });
     if (response.action === 'back')
         return showMenu();
-    const addActions = ['add-openrouter', 'add-ollama', 'add-ollama-cloud'];
+    const addActions = ['add-openai', 'add-grok', 'add-openrouter', 'add-ollama', 'add-ollama-cloud'];
     if (addActions.includes(response.action)) {
         const idPrompt = await prompts({
             type: 'text',
             name: 'id',
-            message: response.action === 'add-openrouter'
-                ? 'Model ID (ex: google/gemini-2.5-flash):'
-                : 'Model ID (ex: llama3):'
+            message: response.action === 'add-openai'
+                ? 'Model ID (ex: gpt-4o-mini):'
+                : response.action === 'add-grok'
+                    ? 'Model ID (ex: grok-2-latest):'
+                    : response.action === 'add-openrouter'
+                        ? 'Model ID (ex: google/gemini-2.5-flash):'
+                        : 'Model ID (ex: llama3):'
         });
         const id = typeof idPrompt.id === 'string' ? idPrompt.id.trim() : '';
         if (id) {
@@ -222,6 +245,8 @@ async function handleConfigMenu() {
         choices: [
             { title: 'View current config', value: 'show' },
             { title: 'Pokt Token (do painel — só isso para usar Controller)', value: 'set-pokt-token' },
+            { title: 'OpenAI API Key', value: 'set-openai' },
+            { title: 'Grok (xAI) API Key', value: 'set-grok' },
             { title: 'OpenRouter Token', value: 'set-openrouter' },
             { title: 'Gemini API Key', value: 'set-gemini' },
             { title: 'Ollama Base URL (local)', value: 'set-ollama' },
@@ -233,6 +258,8 @@ async function handleConfigMenu() {
         return showMenu();
     if (response.type === 'show') {
         const { getControllerBaseUrl } = await import('../config.js');
+        const openai = config.get('openaiApiKey');
+        const grok = config.get('grokApiKey');
         const openrouter = config.get('openrouterToken');
         const gemini = config.get('geminiApiKey');
         const ollama = config.get('ollamaBaseUrl');
@@ -241,6 +268,8 @@ async function handleConfigMenu() {
         console.log(chalk.blue('\nCurrent config (tokens masked):'));
         console.log(ui.dim('  Controller URL:'), getControllerBaseUrl(), ui.dim('(já configurado)'));
         console.log(ui.dim('  Pokt Token:'), poktToken ? poktToken.slice(0, 10) + '****' : '(not set)');
+        console.log(ui.dim('  OpenAI API Key:'), openai ? openai.slice(0, 8) + '****' : '(not set)');
+        console.log(ui.dim('  Grok (xAI) API Key:'), grok ? grok.slice(0, 8) + '****' : '(not set)');
         console.log(ui.dim('  OpenRouter Token:'), openrouter ? openrouter.slice(0, 8) + '****' : '(not set)');
         console.log(ui.dim('  Gemini API Key:'), gemini ? gemini.slice(0, 8) + '****' : '(not set)');
         console.log(ui.dim('  Ollama Base URL (local):'), ollama || '(not set)');
@@ -259,6 +288,8 @@ async function handleConfigMenu() {
     if (valueResponse.val) {
         const keyMap = {
             'set-gemini': 'geminiApiKey',
+            'set-openai': 'openaiApiKey',
+            'set-grok': 'grokApiKey',
             'set-openrouter': 'openrouterToken',
             'set-ollama': 'ollamaBaseUrl',
             'set-ollama-cloud': 'ollamaCloudApiKey',

package/dist/chat/client.js

@@ -1,9 +1,9 @@
 import OpenAI from 'openai';
-import { config, getControllerBaseUrl } from '../config.js';
+import { getControllerBaseUrl, getOpenAIApiKey, getGrokApiKey, getOpenRouterToken, getGeminiApiKey, getOllamaCloudApiKey, getOllamaBaseUrl, getPoktToken, } from '../config.js';
 export async function getClient(modelConfig) {
     if (modelConfig.provider === 'controller') {
         const baseUrl = getControllerBaseUrl();
-        const token = config.get('poktToken');
+        const token = getPoktToken();
         if (!token) {
             throw new Error('Token Pokt não configurado. No painel gere um token e use: pokt config set-pokt-token -v <token>');
         }
@@ -16,10 +16,30 @@ export async function getClient(modelConfig) {
             }
         });
     }
+    else if (modelConfig.provider === 'openai') {
+        const apiKey = getOpenAIApiKey();
+        if (!apiKey) {
+            throw new Error('OpenAI API key não configurada. Use: pokt config set-openai -v <key>');
+        }
+        return new OpenAI({
+            baseURL: 'https://api.openai.com/v1',
+            apiKey,
+        });
+    }
+    else if (modelConfig.provider === 'grok') {
+        const apiKey = getGrokApiKey();
+        if (!apiKey) {
+            throw new Error('Grok (xAI) API key não configurada. Use: pokt config set-grok -v <key>');
+        }
+        return new OpenAI({
+            baseURL: 'https://api.x.ai/v1',
+            apiKey,
+        });
+    }
     else if (modelConfig.provider === 'openrouter') {
         return new OpenAI({
             baseURL: 'https://openrouter.ai/api/v1',
-            apiKey: config.get('openrouterToken'),
+            apiKey: getOpenRouterToken(),
             defaultHeaders: {
                 'HTTP-Referer': 'https://github.com/pokt-cli',
                 'X-Title': 'Pokt CLI',
@@ -27,7 +47,7 @@ export async function getClient(modelConfig) {
         });
     }
     else if (modelConfig.provider === 'gemini') {
-        const apiKey = config.get('geminiApiKey');
+        const apiKey = getGeminiApiKey();
         if (!apiKey) {
             throw new Error('Gemini API key not set. Use: pokt config set-gemini -v <key>');
         }
@@ -37,7 +57,7 @@ export async function getClient(modelConfig) {
         });
     }
     else if (modelConfig.provider === 'ollama-cloud') {
-        const apiKey = config.get('ollamaCloudApiKey');
+        const apiKey = getOllamaCloudApiKey();
         if (!apiKey) {
             throw new Error('Ollama Cloud API key não configurada. Crie uma em https://ollama.com/settings/keys e use: pokt config set-ollama-cloud -v <key>');
         }
@@ -52,7 +72,7 @@ export async function getClient(modelConfig) {
     else {
         // Ollama (local) — não precisa de API key
         return new OpenAI({
-            baseURL: `${config.get('ollamaBaseUrl')}/v1`,
+            baseURL: `${getOllamaBaseUrl()}/v1`,
             apiKey: 'ollama',
         });
     }