pokt-cli 1.0.6 → 1.0.8

package/README.md

@@ -1,119 +1,112 @@
-# Pokt CLI
-
-CLI de **Vibe Coding** com IA: OpenRouter, Ollama (local e cloud), Gemini e provedor Pokt (controller).
-
-## Requisitos
-
-- **Node.js** >= 18.0.0
-
-## Instalação
-
-O pacote no npm chama-se **`pokt-cli`**; o comando no terminal é **`pokt`** (ou **`pokt-cli`**).
-
-```bash
-# Instalação global (recomendado para o comando `pokt` no PATH)
-npm install -g pokt-cli
-
-# Sem instalar (sempre funciona em qualquer máquina)
-npx --yes pokt-cli
-```
-
-### O comando `pokt` não é reconhecido?
-
-1. **Instalação local** (`npm install pokt-cli` dentro de um projeto): o `pokt` **não** fica no PATH global. Use:
-   - `npx pokt-cli` ou
-   - `npm exec pokt-cli` ou
-   - `./node_modules/.bin/pokt` (Git Bash / WSL / macOS/Linux).
-
-2. **Windows – pasta do npm no PATH**: após `npm install -g pokt-cli`, o executável fica na pasta global do npm. Confira:
-   ```bash
-   npm config get prefix
-   ```
-   O diretório **`prefix`** e a subpasta **`prefix\bin`** (ou no Windows muitas vezes **`%AppData%\npm`**) precisam estar no **PATH** do sistema. Reinicie o terminal após alterar.
-
-3. **Windows PowerShell – “running scripts is disabled”**: o npm cria `pokt.ps1`. Se a política bloquear scripts, use **Prompt de Comando (cmd)** para rodar `pokt`, ou:
-   ```powershell
-   Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
-   ```
-   Ou continue usando **`npx pokt-cli`**, que costuma contornar o problema.
-
-4. **Linux/macOS – “bad interpreter” ou comando não encontrado**: em versões antigas publicadas com **CRLF** no arquivo da CLI, reinstale a versão mais recente (`npm install -g pokt-cli@latest`).
-
-## Uso
-
-Sem argumentos, o Pokt abre um menu interativo:
-
-```bash
-pokt
-```
-
-Ou use os comandos diretamente:
-
-```bash
-pokt chat              # Iniciar chat (Vibe Coding)
-pokt models list       # Listar modelos
-pokt provider use openrouter
-pokt config show
-pokt --help
-```
-
-## Comandos
-
-| Comando | Descrição |
-|--------|-----------|
-| `pokt` | Menu interativo |
-| `pokt chat` | Iniciar sessão de chat com a IA |
-| `pokt config <action>` | Configurar chaves e tokens |
-| `pokt models <action>` | Gerenciar modelos (listar, adicionar, trocar) |
-| `pokt provider use <provider>` | Trocar provedor de API |
-| `pokt mcp [action]` | Gerenciar servidores MCP (ferramentas externas) |
-
-### Config (`config`)
-
-- `pokt config show` — Mostra a configuração atual (tokens mascarados).
-- `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.
-
-### Modelos (`models`)
-
-- `pokt models list` — Lista modelos registrados e o ativo.
-- `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 use -i <id> -p <provider>` — Define o modelo ativo.
-
-### Provedores (`provider`)
-
-Provedores suportados: `controller` (Pokt), `openrouter`, `gemini`, `ollama`, `ollama-cloud`.
-
-```bash
-pokt provider use openrouter
-pokt provider use ollama
-```
-
-## Desenvolvimento
-
-```bash
-# Clonar e instalar
-git clone https://github.com/PoktWeb/Pokt_CLI.git
-cd Pokt_CLI
-npm install
-
-# Desenvolvimento (executa o TypeScript direto)
-npm run dev
-
-# Build
-npm run build
-
-# Executar após o build
-npm start
-```
-
-## Licença
-
-ISC · **PoktWeb**
+# Pokt CLI
+
+CLI de **Vibe Coding** com IA: OpenRouter, Ollama (local e cloud), Gemini e provedor Pokt (controller).
+
+## Requisitos
+
+- **Node.js** >= 18.0.0
+
+## Instalação
+
+```bash
+# Instalação principal (global)
+npm install -g pokt-cli
+
+# Alternativa: usar sem instalar
+npx pokt-cli
+```
+
+## Uso
+
+Sem argumentos, o Pokt abre um menu interativo:
+
+```bash
+pokt
+```
+
+## Se o `pokt` não for reconhecido (Windows)
+
+Se você instalou com `npm install -g pokt-cli` mas o PowerShell diz que `pokt` não existe, normalmente é **PATH do prefixo global do npm**.
+
+```bash
+# Veja onde o npm instala pacotes globais
+npm config get prefix
+
+# Verifique se o comando foi criado (PowerShell)
+where pokt
+```
+
+- **Garanta no PATH**: adicione o `prefix` acima (geralmente algo como `%AppData%\\npm`) ao PATH do Windows.
+- **Reinicie o terminal**: feche e abra o PowerShell/Terminal novamente.
+- **Reinstale**: `npm uninstall -g pokt-cli && npm install -g pokt-cli`
+
+Ou use os comandos diretamente:
+
+```bash
+pokt chat              # Iniciar chat (Vibe Coding)
+pokt models list       # Listar modelos
+pokt provider use openrouter
+pokt config show
+pokt --help
+```
+
+## Comandos
+
+| Comando | Descrição |
+|--------|-----------|
+| `pokt` | Menu interativo |
+| `pokt chat` | Iniciar sessão de chat com a IA |
+| `pokt config <action>` | Configurar chaves e tokens |
+| `pokt models <action>` | Gerenciar modelos (listar, adicionar, trocar) |
+| `pokt provider use <provider>` | Trocar provedor de API |
+| `pokt mcp [action]` | Gerenciar servidores MCP (ferramentas externas) |
+
+### Config (`config`)
+
+- `pokt config show` — Mostra a configuração atual (tokens mascarados).
+- `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.
+
+### Modelos (`models`)
+
+- `pokt models list` — Lista modelos registrados e o ativo.
+- `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 use -i <id> -p <provider>` — Define o modelo ativo.
+
+### Provedores (`provider`)
+
+Provedores suportados: `controller` (Pokt), `openrouter`, `gemini`, `ollama`, `ollama-cloud`.
+
+```bash
+pokt provider use openrouter
+pokt provider use ollama
+```
+
+## Desenvolvimento
+
+```bash
+# Clonar e instalar
+git clone https://github.com/PoktWeb/Pokt_CLI.git
+cd Pokt_CLI
+npm install
+
+# Desenvolvimento (executa o TypeScript direto)
+npm run dev
+
+# Build
+npm run build
+
+# Executar após o build
+npm start
+```
+
+## Licença
+
+ISC · **PoktWeb**

package/dist/bin/pokt.js

@@ -37,7 +37,7 @@ async function showMenu() {
     const active = getEffectiveActiveModel();
     const providerLabel = active ? (PROVIDER_LABELS[active.provider] ?? active.provider) : 'No provider';
     console.log('');
-    console.log(ui.banner());
+    await ui.printBanner({ animate: true });
     console.log(ui.statusLine(providerLabel));
     console.log('');
     console.log(ui.separator());

package/dist/chat/loop.js

@@ -2,9 +2,11 @@ import prompts from 'prompts';
 import ora from 'ora';
 import { ui } from '../ui.js';
 import { runProFlow } from '../commands/pro.js';
+import { PROVIDER_LABELS, ALL_PROVIDERS } from '../config.js';
 import { config } from '../config.js';
 import { getClient } from './client.js';
 import { tools, executeTool } from './tools.js';
+import { saveAuto, loadAuto, listCheckpoints, saveCheckpoint, loadCheckpoint, deleteCheckpoint, exportConversation, getSessionsDir } from './sessions.js';
 import { connectMcpServer, getAllMcpToolsOpenAI, callMcpTool, isMcpTool, disconnectAllMcp, } from '../mcp/client.js';
 const SYSTEM_PROMPT = `You are Pokt CLI, an elite AI Software Engineer.
 Your goal is to help the user build, fix, and maintain software projects with high quality.
@@ -46,7 +48,8 @@ async function loadProjectStructure() {
     }
 }
 export async function startChatLoop(modelConfig) {
-    const client = await getClient(modelConfig);
+    let activeModel = modelConfig;
+    let client = await getClient(activeModel);
     // Conectar servidores MCP configurados e montar lista de tools (nativas + MCP)
     const mcpServers = config.get('mcpServers') ?? [];
     for (const server of mcpServers) {
@@ -59,14 +62,174 @@ export async function startChatLoop(modelConfig) {
         ...tools,
         ...getAllMcpToolsOpenAI(),
     ];
-    const messages = [
-        { role: 'system', content: SYSTEM_PROMPT }
-    ];
+    const messages = [{ role: 'system', content: SYSTEM_PROMPT }];
+    // Auto-resume do projeto (estilo gemini): se existir, adiciona mensagens anteriores (sem duplicar system prompt)
+    const prev = loadAuto();
+    if (prev && prev.length > 0) {
+        for (const m of prev) {
+            if (m.role === 'system')
+                continue;
+            messages.push({ role: m.role, content: m.content });
+        }
+        console.log(ui.dim(`Sessão anterior carregada (projeto). Use /chat list | /chat save <tag>.`));
+    }
+    function modelLabel(m) {
+        const provider = PROVIDER_LABELS[m.provider] ?? m.provider;
+        return `[${provider}] ${m.id}`;
+    }
+    async function switchModelFlow(mode = 'model') {
+        const models = config.get('registeredModels') ?? [];
+        if (!Array.isArray(models) || models.length === 0) {
+            console.log(ui.error('Nenhum modelo registrado. Rode: pokt models list'));
+            return;
+        }
+        const providerChoices = ALL_PROVIDERS.map((p) => {
+            const label = PROVIDER_LABELS[p] ?? p;
+            const hasAny = models.some((m) => m.provider === p);
+            const star = activeModel.provider === p ? '★ ' : '';
+            return {
+                title: `${star}${label}${hasAny ? '' : ' (sem modelos)'}`,
+                value: p,
+                disabled: !hasAny,
+            };
+        });
+        const providerPick = await prompts({
+            type: 'select',
+            name: 'provider',
+            message: mode === 'provider' ? 'Trocar provedor:' : 'Selecione o provedor:',
+            choices: [...providerChoices, { title: '🔙 Cancelar', value: 'cancel' }],
+        });
+        if (!providerPick.provider || providerPick.provider === 'cancel')
+            return;
+        const provider = providerPick.provider;
+        const providerModels = models.filter((m) => m.provider === provider);
+        if (providerModels.length === 0) {
+            console.log(ui.error(`Sem modelos para ${PROVIDER_LABELS[provider] ?? provider}.`));
+            return;
+        }
+        let selected = null;
+        if (mode === 'provider') {
+            selected = providerModels[0];
+        }
+        else {
+            const pick = await prompts({
+                type: 'select',
+                name: 'idx',
+                message: `Modelos em ${PROVIDER_LABELS[provider] ?? provider}:`,
+                choices: [
+                    ...providerModels.map((m, i) => ({
+                        title: `${activeModel.provider === m.provider && activeModel.id === m.id ? '★ ' : ''}${m.id}`,
+                        value: i,
+                    })),
+                    { title: '🔙 Cancelar', value: 'cancel' },
+                ],
+            });
+            if (pick.idx === 'cancel' || typeof pick.idx !== 'number')
+                return;
+            selected = providerModels[pick.idx] ?? null;
+        }
+        if (!selected)
+            return;
+        // Validar chaves/credenciais necessárias (reaproveita mesma lógica do providerCommand / getClient)
+        try {
+            const newClient = await getClient(selected);
+            client = newClient;
+        }
+        catch (e) {
+            console.log(ui.error(e?.message ?? String(e)));
+            return;
+        }
+        activeModel = selected;
+        config.set('activeModel', selected);
+        console.log(ui.success(`Modelo ativo atualizado: ${modelLabel(selected)}`));
+        console.log(ui.dim('Dica: o histórico do chat foi mantido; apenas o modelo/provedor mudou.'));
+    }
+    function printHelp() {
+        console.log(ui.dim(`
+Comandos do chat:
+  ${ui.accent('/help')} — mostra esta ajuda
+  ${ui.accent('/clear')} — limpa a tela
+  ${ui.accent('/status')} — mostra modelo/provider atual
+  ${ui.accent('/model')} — trocar modelo (menu interativo)
+  ${ui.accent('/provider')} — trocar provedor (usa o 1º modelo disponível)
+  ${ui.accent('/chat')} — checkpoints/sessões (list/save/resume/delete/share)
+  ${ui.accent('/resume')} — alias de /chat
+  ${ui.accent('/copy')} — copia a última resposta do Pokt (Windows: clip)
+  ${ui.accent('/pro')} — abrir Pokt Pro no navegador
+  ${ui.accent('/quit')} ou ${ui.accent('exit')} — sair do chat
+`));
+    }
+    let lastAssistantText = '';
+    async function handleChatCommand(raw) {
+        const parts = raw.trim().split(/\s+/);
+        const cmd = parts[0].toLowerCase();
+        const sub = (parts[1] ?? 'list').toLowerCase();
+        const arg = parts.slice(2).join(' ').trim();
+        if (sub === 'dir') {
+            console.log(ui.dim(`Sessões: ${getSessionsDir()}`));
+            return;
+        }
+        if (sub === 'list') {
+            const items = listCheckpoints();
+            if (items.length === 0) {
+                console.log(ui.dim('Nenhum checkpoint salvo ainda. Use: /chat save <tag>'));
+                return;
+            }
+            console.log(ui.dim('Checkpoints:'));
+            for (const it of items) {
+                console.log(`- ${ui.accent(it.tag)} ${it.updatedAt ? ui.dim(`(${it.updatedAt})`) : ''}`);
+            }
+            return;
+        }
+        if (sub === 'save') {
+            if (!arg) {
+                console.log(ui.error('Uso: /chat save <tag>'));
+                return;
+            }
+            saveCheckpoint(arg, messages);
+            console.log(ui.success(`Checkpoint salvo: ${arg}`));
+            return;
+        }
+        if (sub === 'resume' || sub === 'load') {
+            if (!arg) {
+                console.log(ui.error('Uso: /chat resume <tag>'));
+                return;
+            }
+            const loaded = loadCheckpoint(arg);
+            // mantém system prompt; substitui resto
+            const sys = messages[0];
+            messages.length = 0;
+            messages.push(sys);
+            for (const m of loaded) {
+                if (m.role === 'system')
+                    continue;
+                messages.push({ role: m.role, content: m.content });
+            }
+            console.log(ui.success(`Checkpoint carregado: ${arg}`));
+            return;
+        }
+        if (sub === 'delete' || sub === 'rm') {
+            if (!arg) {
+                console.log(ui.error('Uso: /chat delete <tag>'));
+                return;
+            }
+            deleteCheckpoint(arg);
+            console.log(ui.success(`Checkpoint removido: ${arg}`));
+            return;
+        }
+        if (sub === 'share' || sub === 'export') {
+            const filename = arg || `pokt-chat-${Date.now()}.md`;
+            const out = exportConversation(filename, messages);
+            console.log(ui.success(`Exportado: ${out}`));
+            return;
+        }
+        console.log(ui.warn(`Subcomando desconhecido: ${sub}. Use /chat list|save|resume|delete|share`));
+    }
     while (true) {
         console.log('');
         const cwd = process.cwd();
         console.log(ui.dim(`Diretório atual: ${cwd}`));
-        console.log(ui.shortcutsLine('shift+tab to accept edits', '? · /pro (Torne-se Pro)'));
+        console.log(ui.shortcutsLine(undefined, '? · /help · /pro'));
         const response = await prompts({
             type: 'text',
             name: 'input',
@@ -82,6 +245,55 @@ export async function startChatLoop(modelConfig) {
         }
         const trimmed = userInput.trim();
         const low = trimmed.toLowerCase();
+        if (low === '/help' || low === '/?' || low === 'help') {
+            printHelp();
+            continue;
+        }
+        if (low === '/clear') {
+            console.clear();
+            continue;
+        }
+        if (low === '/status') {
+            console.log(ui.statusBar({ cwd: process.cwd(), model: `/model ${activeModel.provider} (${activeModel.id})` }));
+            continue;
+        }
+        if (low.startsWith('/chat') || low.startsWith('/resume')) {
+            await handleChatCommand(trimmed.replace(/^\/resume/i, '/chat'));
+            continue;
+        }
+        if (low === '/copy') {
+            try {
+                if (!lastAssistantText) {
+                    console.log(ui.warn('Nada para copiar ainda.'));
+                    continue;
+                }
+                // Sem interpolar conteúdo no comando (evita quebra por aspas/newlines).
+                // Escreve para um arquivo temporário e copia via Get-Content | clip (Windows).
+                const tmp = `.pokt_copy_${Date.now()}.txt`;
+                await executeTool('write_file', JSON.stringify({ path: tmp, content: lastAssistantText }));
+                await executeTool('run_command', JSON.stringify({ command: `powershell -NoProfile -Command "Get-Content -Raw '${tmp}' | clip"` }));
+                // best-effort cleanup
+                try {
+                    await executeTool('delete_file', JSON.stringify({ path: tmp }));
+                }
+                catch {
+                    // ignore
+                }
+                console.log(ui.success('Copiado para a área de transferência.'));
+            }
+            catch {
+                console.log(ui.warn('Falha ao copiar. Se estiver no Windows, verifique se o comando "clip" está disponível.'));
+            }
+            continue;
+        }
+        if (low === '/model') {
+            await switchModelFlow('model');
+            continue;
+        }
+        if (low === '/provider') {
+            await switchModelFlow('provider');
+            continue;
+        }
         if (low === '/pro' || low === '/torne-se-pro' || low === 'torne-se pro') {
             runProFlow();
             continue;
@@ -91,10 +303,12 @@ export async function startChatLoop(modelConfig) {
 Atalhos:
   ${ui.accent('/pro')} ou ${ui.accent('/torne-se-pro')} — abrir Pokt Pro no navegador (pagamento + chave)
   exit, ${ui.accent('/quit')} — sair do chat
+  ${ui.accent('/help')} — ver comandos do chat
 `));
             continue;
         }
         messages.push({ role: 'user', content: userInput });
+        saveAuto(messages);
         // Primeiro o modelo vê o pedido; depois carregamos a estrutura do projeto para ele entender e então criar/editar
         const isFirstUserMessage = messages.filter(m => m.role === 'user').length === 1;
         if (isFirstUserMessage) {
@@ -103,7 +317,18 @@ Atalhos:
             loadSpinner.stop();
             messages.push({ role: 'system', content: `Current Project Structure:\n${projectStructure}` });
         }
-        await processLLMResponse(client, modelConfig.id, messages, allTools);
+        await processLLMResponse(client, activeModel.id, messages, allTools);
+        // Atualiza auto-save após resposta
+        saveAuto(messages);
+        // Captura última resposta do assistente para /copy (melhor esforço)
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const m = messages[i];
+            if (m?.role === 'assistant') {
+                const c = m.content;
+                lastAssistantText = typeof c === 'string' ? c : Array.isArray(c) ? c.map((p) => (p && p.text ? p.text : String(p))).join('') : String(c ?? '');
+                break;
+            }
+        }
     }
     await disconnectAllMcp();
 }

package/dist/chat/sessions.d.ts

@@ -0,0 +1,18 @@
+import type { ChatCompletionMessageParam } from 'openai/resources/chat/completions/completions.js';
+type PersistedMessage = {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+};
+export declare function getProjectHash(cwd?: string): string;
+export declare function getSessionsDir(): string;
+export declare function saveAuto(messages: ChatCompletionMessageParam[]): void;
+export declare function loadAuto(): PersistedMessage[] | null;
+export declare function listCheckpoints(): Array<{
+    tag: string;
+    updatedAt?: string;
+}>;
+export declare function saveCheckpoint(tag: string, messages: ChatCompletionMessageParam[]): void;
+export declare function loadCheckpoint(tag: string): PersistedMessage[];
+export declare function deleteCheckpoint(tag: string): void;
+export declare function exportConversation(filename: string, messages: ChatCompletionMessageParam[]): string;
+export {};

package/dist/chat/sessions.js

@@ -0,0 +1,120 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import crypto from 'crypto';
+function toPersisted(messages) {
+    return messages
+        .filter((m) => !!m && typeof m === 'object' && 'role' in m)
+        .map((m) => {
+        const role = m.role;
+        const content = m.content;
+        if (typeof content === 'string')
+            return { role, content };
+        if (Array.isArray(content)) {
+            const text = content
+                .map((part) => (part && typeof part === 'object' && 'text' in part ? String(part.text) : String(part)))
+                .join('');
+            return { role, content: text };
+        }
+        return { role, content: content != null ? String(content) : '' };
+    });
+}
+function ensureDir(p) {
+    fs.mkdirSync(p, { recursive: true });
+}
+function safeTag(tag) {
+    return tag.trim().replace(/[<>:"/\\|?*\x00-\x1F]/g, '_').slice(0, 80);
+}
+export function getProjectHash(cwd = process.cwd()) {
+    const h = crypto.createHash('sha1');
+    h.update(path.resolve(cwd));
+    return h.digest('hex').slice(0, 12);
+}
+export function getSessionsDir() {
+    // compatível Windows/mac/linux
+    const base = path.join(os.homedir(), '.pokt', 'tmp');
+    const proj = getProjectHash();
+    const dir = path.join(base, proj);
+    ensureDir(dir);
+    return dir;
+}
+function getAutoPath() {
+    return path.join(getSessionsDir(), 'auto.json');
+}
+export function saveAuto(messages) {
+    const payload = {
+        updatedAt: new Date().toISOString(),
+        cwd: process.cwd(),
+        messages: toPersisted(messages),
+    };
+    fs.writeFileSync(getAutoPath(), JSON.stringify(payload, null, 2), 'utf8');
+}
+export function loadAuto() {
+    try {
+        const raw = fs.readFileSync(getAutoPath(), 'utf8');
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed?.messages) ? parsed.messages : null;
+    }
+    catch {
+        return null;
+    }
+}
+function tagPath(tag) {
+    return path.join(getSessionsDir(), `checkpoint.${safeTag(tag)}.json`);
+}
+export function listCheckpoints() {
+    const dir = getSessionsDir();
+    const files = fs.readdirSync(dir).filter((f) => f.startsWith('checkpoint.') && f.endsWith('.json'));
+    return files
+        .map((f) => {
+        const tag = f.replace(/^checkpoint\./, '').replace(/\.json$/, '');
+        try {
+            const raw = fs.readFileSync(path.join(dir, f), 'utf8');
+            const parsed = JSON.parse(raw);
+            return { tag, updatedAt: parsed.updatedAt };
+        }
+        catch {
+            return { tag };
+        }
+    })
+        .sort((a, b) => String(b.updatedAt ?? '').localeCompare(String(a.updatedAt ?? '')));
+}
+export function saveCheckpoint(tag, messages) {
+    const t = safeTag(tag);
+    if (!t)
+        throw new Error('Tag inválida.');
+    const payload = {
+        tag: t,
+        updatedAt: new Date().toISOString(),
+        cwd: process.cwd(),
+        messages: toPersisted(messages),
+    };
+    fs.writeFileSync(tagPath(t), JSON.stringify(payload, null, 2), 'utf8');
+}
+export function loadCheckpoint(tag) {
+    const t = safeTag(tag);
+    const raw = fs.readFileSync(tagPath(t), 'utf8');
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed?.messages))
+        throw new Error('Checkpoint inválido.');
+    return parsed.messages;
+}
+export function deleteCheckpoint(tag) {
+    const t = safeTag(tag);
+    fs.unlinkSync(tagPath(t));
+}
+export function exportConversation(filename, messages) {
+    const out = path.isAbsolute(filename) ? filename : path.join(process.cwd(), filename);
+    const ext = path.extname(out).toLowerCase();
+    if (ext === '.json') {
+        fs.writeFileSync(out, JSON.stringify({ exportedAt: new Date().toISOString(), messages: toPersisted(messages) }, null, 2), 'utf8');
+        return out;
+    }
+    // markdown
+    const md = toPersisted(messages)
+        .filter((m) => m.role !== 'system')
+        .map((m) => `## ${m.role}\n\n${m.content}\n`)
+        .join('\n');
+    fs.writeFileSync(out, `# Pokt CLI chat export\n\nExportado em: ${new Date().toISOString()}\n\n${md}`, 'utf8');
+    return out;
+}

package/dist/commands/chat.js

@@ -27,7 +27,7 @@ export const chatCommand = {
         }
         // Se veio do menu interativo, não repetir banner/tips (já foram exibidos)
         if (!fromMenu) {
-            console.log(ui.banner());
+            await ui.printBanner({ animate: true });
             console.log(ui.statusLine(`[${activeModel.provider}] ${activeModel.id}`));
             console.log('');
             console.log(ui.tips());

package/dist/ui.d.ts

@@ -9,8 +9,13 @@ export declare const ui: {
     labelPokt: () => any;
     accent: (text: string) => any;
     muted: (text: string) => any;
-    /** Banner principal estilo Gemini CLI: logo + nome + versão */
+    /** Banner principal em ASCII (Pokt CLI) */
     banner: (customVersion?: string) => string;
+    /** Imprime o banner com “typewriter” (letra por letra) */
+    printBanner: (opts?: {
+        animate?: boolean;
+        version?: string;
+    }) => Promise<void>;
     /** Status de login / provider (uma linha) */
     statusLine: (providerLabel: string, configPath?: string) => any;
     /** Seção "Tips for getting started" */

package/dist/ui.js

@@ -2,15 +2,101 @@ import chalk from 'chalk';
 import fs from 'fs';
 import path from 'path';
 import { execSync } from 'child_process';
-const VERSION = '1.0.5';
-/** Logo em estilo chevron com gradiente (azul → rosa → roxo) */
-function logo() {
-    const c = (s, color) => color(s);
-    const block = (char, col) => col(char);
-    const blue = chalk.rgb(100, 149, 237);
-    const pink = chalk.rgb(255, 105, 180);
-    const purple = chalk.rgb(147, 112, 219);
-    return block('▸', blue) + ' ' + block('▸', pink) + ' ' + block('▸', purple);
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function lerp(a, b, t) {
+    return a + (b - a) * t;
+}
+function gradientColor(idx, len, start, end) {
+    if (len <= 1)
+        return start;
+    const t = idx / (len - 1);
+    return [
+        Math.round(lerp(start[0], end[0], t)),
+        Math.round(lerp(start[1], end[1], t)),
+        Math.round(lerp(start[2], end[2], t)),
+    ];
+}
+function gradientChars(text, start, end) {
+    const chars = [...text];
+    return chars.map((ch, i) => {
+        if (ch === ' ')
+            return ' ';
+        const [r, g, b] = gradientColor(i, chars.length, start, end);
+        return chalk.rgb(r, g, b).bold(ch);
+    });
+}
+function getVersion() {
+    // Prioridade: env de empacotamento → package.json → fallback
+    const envVer = process.env.POKT_CLI_VERSION || process.env.npm_package_version;
+    if (envVer)
+        return envVer;
+    try {
+        const pkgPath = path.resolve(process.cwd(), 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            const raw = fs.readFileSync(pkgPath, 'utf8');
+            const parsed = JSON.parse(raw);
+            if (parsed?.version)
+                return parsed.version;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return 'dev';
+}
+function bannerLines(ver) {
+    const left = [
+        '██████╗  ██████╗ ██╗  ██╗████████╗',
+        '██╔══██╗██╔═══██╗██║ ██╔╝╚══██╔══╝',
+        '██████╔╝██║   ██║█████╔╝    ██║',
+        '██╔═══╝ ██║   ██║██╔═██╗    ██║',
+        '██║     ╚██████╔╝██║  ██╗   ██║',
+        '╚═╝      ╚═════╝ ╚═╝  ╚═╝   ╚═╝',
+    ];
+    const right = [
+        '   ██████╗██╗     ██╗',
+        '  ██╔════╝██║     ██║',
+        '     ██║     ██║     ██║',
+        '     ██║     ██║     ██║',
+        '     ╚██████╗███████╗██║',
+        '      ╚═════╝╚══════╝╚═╝',
+    ];
+    const lines = left.map((l, i) => `${l}${right[i] ?? ''}`);
+    lines.push(' '.repeat(18) + `CLI Version v${ver}`);
+    return lines;
+}
+function bannerAscii(ver) {
+    const start = [0, 205, 255]; // azul/ciano
+    const end = [155, 89, 255]; // roxo
+    const lines = bannerLines(ver);
+    return lines
+        .map((line, i) => {
+        if (i === lines.length - 1)
+            return chalk.gray(line);
+        return gradientChars(line, start, end).join('');
+    })
+        .join('\n');
+}
+async function printBannerAnimated(customVersion) {
+    const ver = customVersion ?? getVersion();
+    const start = [0, 205, 255];
+    const end = [155, 89, 255];
+    const lines = bannerLines(ver);
+    for (let li = 0; li < lines.length; li++) {
+        const line = lines[li] ?? '';
+        if (li === lines.length - 1) {
+            process.stdout.write(chalk.gray(line) + '\n');
+            continue;
+        }
+        const colored = gradientChars(line, start, end);
+        for (let i = 0; i <= colored.length; i++) {
+            process.stdout.write('\r' + colored.slice(0, i).join(''));
+            await sleep(1);
+        }
+        process.stdout.write('\n');
+    }
 }
 export const ui = {
     title: (text) => chalk.whiteBright.bold(text),
@@ -19,33 +105,40 @@ export const ui = {
     error: (text) => chalk.red(text),
     warn: (text) => chalk.yellow(text),
     dim: (text) => chalk.gray(text),
-    labelYou: () => chalk.cyan('You:'),
+    labelYou: () => chalk.cyan('Você:'),
     labelPokt: () => chalk.green('Pokt:'),
     accent: (text) => chalk.blue(text),
     muted: (text) => chalk.gray(text),
-    /** Banner principal estilo Gemini CLI: logo + nome + versão */
+    /** Banner principal em ASCII (Pokt CLI) */
     banner: (customVersion) => {
-        const ver = customVersion ?? VERSION;
-        const line1 = logo() + '  ' + chalk.whiteBright.bold('Pokt CLI') + chalk.gray(` v${ver}`);
-        return line1;
+        const ver = customVersion ?? getVersion();
+        return bannerAscii(ver);
+    },
+    /** Imprime o banner com “typewriter” (letra por letra) */
+    printBanner: async (opts) => {
+        if (opts?.animate) {
+            await printBannerAnimated(opts.version);
+            return;
+        }
+        console.log(ui.banner(opts?.version));
     },
     /** Status de login / provider (uma linha) */
     statusLine: (providerLabel, configPath = '/config') => {
-        const auth = chalk.gray(`Logged in with ${providerLabel} ${chalk.underline(configPath)}`);
+        const auth = chalk.gray(`Ativo: ${providerLabel}  ${chalk.underline(configPath)}`);
         return auth;
     },
     /** Seção "Tips for getting started" */
     tips: () => {
-        const title = chalk.white('Tips for getting started:');
+        const title = chalk.white('Dicas para começar:');
         const tips = [
-            chalk.gray('1. /help for more information'),
-            chalk.gray('2. Ask coding questions, edit code or run commands'),
-            chalk.gray('3. Be specific for the best results'),
+            chalk.gray('1. Digite /help para ver comandos'),
+            chalk.gray('2. Peça ajuda para codar, editar arquivos ou rodar comandos'),
+            chalk.gray('3. Seja específico para melhores resultados'),
         ].join('\n');
         return title + '\n' + tips;
     },
     /** Linha de atalhos acima do input */
-    shortcutsLine: (left = 'shift+tab to accept edits', right = '? for shortcuts', center) => {
+    shortcutsLine: (left = 'shift+tab para aceitar edições', right = '? para atalhos', center) => {
         const l = chalk.gray(left);
         const r = chalk.gray(right);
         const c = center ? chalk.gray(center) : '';
@@ -55,7 +148,7 @@ export const ui = {
         return l + ' '.repeat(Math.max(0, 60 - left.length - right.length)) + r;
     },
     /** Placeholder do input */
-    inputPlaceholder: () => chalk.gray('Type your message or @path/to/file'),
+    inputPlaceholder: () => chalk.gray('Digite sua mensagem (ou /help)'),
     /** Barra de status inferior: path, branch, sandbox, model */
     statusBar: (opts) => {
         const cwd = opts.cwd ?? process.cwd();

package/package.json

@@ -1,62 +1,61 @@
-{
-  "name": "pokt-cli",
-  "version": "1.0.6",
-  "description": "Vibe Coding AI CLI for OpenRouter and Ollama",
-  "main": "./dist/bin/pokt.js",
-  "type": "module",
-  "bin": {
-    "pokt": "dist/bin/pokt.js",
-    "pokt-cli": "dist/bin/pokt.js"
-  },
-  "scripts": {
-    "build": "tsc && node scripts/ensure-bin-lf.js",
-    "start": "node ./dist/bin/pokt.js",
-    "dev": "tsx ./src/bin/pokt.ts",
-    "prepublishOnly": "npm run build"
-  },
-  "files": [
-    "dist",
-    "package.json",
-    "README.md"
-  ],
-  "keywords": [
-    "ai",
-    "cli",
-    "coding",
-    "agent",
-    "openrouter",
-    "ollama"
-  ],
-  "author": "PoktWeb",
-  "license": "ISC",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/PoktWeb/Pokt_CLI.git"
-  },
-  "homepage": "https://github.com/PoktWeb/Pokt_CLI#readme",
-  "bugs": {
-    "url": "https://github.com/PoktWeb/Pokt_CLI/issues"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "chalk": "^5.3.0",
-    "conf": "^12.0.0",
-    "diff": "^8.0.3",
-    "openai": "^4.28.4",
-    "ora": "^8.0.1",
-    "prompts": "^2.4.2",
-    "yargs": "^17.7.2",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@types/diff": "^7.0.2",
-    "@types/node": "^20.11.24",
-    "@types/prompts": "^2.4.9",
-    "@types/yargs": "^17.0.32",
-    "tsx": "^4.7.1",
-    "typescript": "^5.3.3"
-  }
-}
+{
+  "name": "pokt-cli",
+  "version": "1.0.8",
+  "description": "Vibe Coding AI CLI for OpenRouter and Ollama",
+  "main": "./dist/bin/pokt.js",
+  "type": "module",
+  "bin": {
+    "pokt": "dist/bin/pokt.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node ./dist/bin/pokt.js",
+    "dev": "tsx ./src/bin/pokt.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md"
+  ],
+  "keywords": [
+    "ai",
+    "cli",
+    "coding",
+    "agent",
+    "openrouter",
+    "ollama"
+  ],
+  "author": "PoktWeb",
+  "license": "ISC",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PoktWeb/Pokt_CLI.git"
+  },
+  "homepage": "https://github.com/PoktWeb/Pokt_CLI#readme",
+  "bugs": {
+    "url": "https://github.com/PoktWeb/Pokt_CLI/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "chalk": "^5.3.0",
+    "conf": "^12.0.0",
+    "diff": "^8.0.3",
+    "openai": "^4.28.4",
+    "ora": "^8.0.1",
+    "prompts": "^2.4.2",
+    "yargs": "^17.7.2",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/diff": "^7.0.2",
+    "@types/node": "^20.11.24",
+    "@types/prompts": "^2.4.9",
+    "@types/yargs": "^17.0.32",
+    "tsx": "^4.7.1",
+    "typescript": "^5.3.3"
+  }
+}