pokt-cli 1.0.6 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +112 -119
  2. package/package.json +61 -62
package/README.md CHANGED
@@ -1,119 +1,112 @@
1
- # Pokt CLI
2
-
3
- CLI de **Vibe Coding** com IA: OpenRouter, Ollama (local e cloud), Gemini e provedor Pokt (controller).
4
-
5
- ## Requisitos
6
-
7
- - **Node.js** >= 18.0.0
8
-
9
- ## Instalação
10
-
11
- O pacote no npm chama-se **`pokt-cli`**; o comando no terminal é **`pokt`** (ou **`pokt-cli`**).
12
-
13
- ```bash
14
- # Instalação global (recomendado para o comando `pokt` no PATH)
15
- npm install -g pokt-cli
16
-
17
- # Sem instalar (sempre funciona em qualquer máquina)
18
- npx --yes pokt-cli
19
- ```
20
-
21
- ### O comando `pokt` não é reconhecido?
22
-
23
- 1. **Instalação local** (`npm install pokt-cli` dentro de um projeto): o `pokt` **não** fica no PATH global. Use:
24
- - `npx pokt-cli` ou
25
- - `npm exec pokt-cli` ou
26
- - `./node_modules/.bin/pokt` (Git Bash / WSL / macOS/Linux).
27
-
28
- 2. **Windows – pasta do npm no PATH**: após `npm install -g pokt-cli`, o executável fica na pasta global do npm. Confira:
29
- ```bash
30
- npm config get prefix
31
- ```
32
- 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.
33
-
34
- 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:
35
- ```powershell
36
- Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
37
- ```
38
- Ou continue usando **`npx pokt-cli`**, que costuma contornar o problema.
39
-
40
- 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`).
41
-
42
- ## Uso
43
-
44
- Sem argumentos, o Pokt abre um menu interativo:
45
-
46
- ```bash
47
- pokt
48
- ```
49
-
50
- Ou use os comandos diretamente:
51
-
52
- ```bash
53
- pokt chat # Iniciar chat (Vibe Coding)
54
- pokt models list # Listar modelos
55
- pokt provider use openrouter
56
- pokt config show
57
- pokt --help
58
- ```
59
-
60
- ## Comandos
61
-
62
- | Comando | Descrição |
63
- |--------|-----------|
64
- | `pokt` | Menu interativo |
65
- | `pokt chat` | Iniciar sessão de chat com a IA |
66
- | `pokt config <action>` | Configurar chaves e tokens |
67
- | `pokt models <action>` | Gerenciar modelos (listar, adicionar, trocar) |
68
- | `pokt provider use <provider>` | Trocar provedor de API |
69
- | `pokt mcp [action]` | Gerenciar servidores MCP (ferramentas externas) |
70
-
71
- ### Config (`config`)
72
-
73
- - `pokt config show` — Mostra a configuração atual (tokens mascarados).
74
- - `pokt config set-openrouter -v <token>` — Token OpenRouter.
75
- - `pokt config set-ollama -v <url>` — URL base do Ollama local.
76
- - `pokt config set-ollama-cloud -v <key>` — API key Ollama Cloud.
77
- - `pokt config set-gemini -v <key>` — API key Google Gemini.
78
- - `pokt config set-pokt-token -v <token>` — Token do controller Pokt.
79
- - `pokt config clear-openrouter` — Remove o token OpenRouter.
80
-
81
- ### Modelos (`models`)
82
-
83
- - `pokt models list` — Lista modelos registrados e o ativo.
84
- - `pokt models fetch-openrouter` — Busca modelos disponíveis no OpenRouter.
85
- - `pokt models fetch-ollama` — Busca modelos do Ollama local.
86
- - `pokt models fetch-ollama-cloud` — Busca modelos do Ollama Cloud.
87
- - `pokt models add-openrouter`, `add-ollama`, `add-ollama-cloud` — Adiciona modelo (use `-i <id>`).
88
- - `pokt models use -i <id> -p <provider>` — Define o modelo ativo.
89
-
90
- ### Provedores (`provider`)
91
-
92
- Provedores suportados: `controller` (Pokt), `openrouter`, `gemini`, `ollama`, `ollama-cloud`.
93
-
94
- ```bash
95
- pokt provider use openrouter
96
- pokt provider use ollama
97
- ```
98
-
99
- ## Desenvolvimento
100
-
101
- ```bash
102
- # Clonar e instalar
103
- git clone https://github.com/PoktWeb/Pokt_CLI.git
104
- cd Pokt_CLI
105
- npm install
106
-
107
- # Desenvolvimento (executa o TypeScript direto)
108
- npm run dev
109
-
110
- # Build
111
- npm run build
112
-
113
- # Executar após o build
114
- npm start
115
- ```
116
-
117
- ## Licença
118
-
119
- ISC · **PoktWeb**
1
+ # Pokt CLI
2
+
3
+ CLI de **Vibe Coding** com IA: OpenRouter, Ollama (local e cloud), Gemini e provedor Pokt (controller).
4
+
5
+ ## Requisitos
6
+
7
+ - **Node.js** >= 18.0.0
8
+
9
+ ## Instalação
10
+
11
+ ```bash
12
+ # Instalação principal (global)
13
+ npm install -g pokt-cli
14
+
15
+ # Alternativa: usar sem instalar
16
+ npx pokt-cli
17
+ ```
18
+
19
+ ## Uso
20
+
21
+ Sem argumentos, o Pokt abre um menu interativo:
22
+
23
+ ```bash
24
+ pokt
25
+ ```
26
+
27
+ ## Se o `pokt` não for reconhecido (Windows)
28
+
29
+ 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**.
30
+
31
+ ```bash
32
+ # Veja onde o npm instala pacotes globais
33
+ npm config get prefix
34
+
35
+ # Verifique se o comando foi criado (PowerShell)
36
+ where pokt
37
+ ```
38
+
39
+ - **Garanta no PATH**: adicione o `prefix` acima (geralmente algo como `%AppData%\\npm`) ao PATH do Windows.
40
+ - **Reinicie o terminal**: feche e abra o PowerShell/Terminal novamente.
41
+ - **Reinstale**: `npm uninstall -g pokt-cli && npm install -g pokt-cli`
42
+
43
+ Ou use os comandos diretamente:
44
+
45
+ ```bash
46
+ pokt chat # Iniciar chat (Vibe Coding)
47
+ pokt models list # Listar modelos
48
+ pokt provider use openrouter
49
+ pokt config show
50
+ pokt --help
51
+ ```
52
+
53
+ ## Comandos
54
+
55
+ | Comando | Descrição |
56
+ |--------|-----------|
57
+ | `pokt` | Menu interativo |
58
+ | `pokt chat` | Iniciar sessão de chat com a IA |
59
+ | `pokt config <action>` | Configurar chaves e tokens |
60
+ | `pokt models <action>` | Gerenciar modelos (listar, adicionar, trocar) |
61
+ | `pokt provider use <provider>` | Trocar provedor de API |
62
+ | `pokt mcp [action]` | Gerenciar servidores MCP (ferramentas externas) |
63
+
64
+ ### Config (`config`)
65
+
66
+ - `pokt config show` — Mostra a configuração atual (tokens mascarados).
67
+ - `pokt config set-openrouter -v <token>` — Token OpenRouter.
68
+ - `pokt config set-ollama -v <url>` — URL base do Ollama local.
69
+ - `pokt config set-ollama-cloud -v <key>` — API key Ollama Cloud.
70
+ - `pokt config set-gemini -v <key>` — API key Google Gemini.
71
+ - `pokt config set-pokt-token -v <token>` — Token do controller Pokt.
72
+ - `pokt config clear-openrouter` — Remove o token OpenRouter.
73
+
74
+ ### Modelos (`models`)
75
+
76
+ - `pokt models list` — Lista modelos registrados e o ativo.
77
+ - `pokt models fetch-openrouter` — Busca modelos disponíveis no OpenRouter.
78
+ - `pokt models fetch-ollama` — Busca modelos do Ollama local.
79
+ - `pokt models fetch-ollama-cloud` — Busca modelos do Ollama Cloud.
80
+ - `pokt models add-openrouter`, `add-ollama`, `add-ollama-cloud` — Adiciona modelo (use `-i <id>`).
81
+ - `pokt models use -i <id> -p <provider>` — Define o modelo ativo.
82
+
83
+ ### Provedores (`provider`)
84
+
85
+ Provedores suportados: `controller` (Pokt), `openrouter`, `gemini`, `ollama`, `ollama-cloud`.
86
+
87
+ ```bash
88
+ pokt provider use openrouter
89
+ pokt provider use ollama
90
+ ```
91
+
92
+ ## Desenvolvimento
93
+
94
+ ```bash
95
+ # Clonar e instalar
96
+ git clone https://github.com/PoktWeb/Pokt_CLI.git
97
+ cd Pokt_CLI
98
+ npm install
99
+
100
+ # Desenvolvimento (executa o TypeScript direto)
101
+ npm run dev
102
+
103
+ # Build
104
+ npm run build
105
+
106
+ # Executar após o build
107
+ npm start
108
+ ```
109
+
110
+ ## Licença
111
+
112
+ ISC · **PoktWeb**
package/package.json CHANGED
@@ -1,62 +1,61 @@
1
- {
2
- "name": "pokt-cli",
3
- "version": "1.0.6",
4
- "description": "Vibe Coding AI CLI for OpenRouter and Ollama",
5
- "main": "./dist/bin/pokt.js",
6
- "type": "module",
7
- "bin": {
8
- "pokt": "dist/bin/pokt.js",
9
- "pokt-cli": "dist/bin/pokt.js"
10
- },
11
- "scripts": {
12
- "build": "tsc && node scripts/ensure-bin-lf.js",
13
- "start": "node ./dist/bin/pokt.js",
14
- "dev": "tsx ./src/bin/pokt.ts",
15
- "prepublishOnly": "npm run build"
16
- },
17
- "files": [
18
- "dist",
19
- "package.json",
20
- "README.md"
21
- ],
22
- "keywords": [
23
- "ai",
24
- "cli",
25
- "coding",
26
- "agent",
27
- "openrouter",
28
- "ollama"
29
- ],
30
- "author": "PoktWeb",
31
- "license": "ISC",
32
- "engines": {
33
- "node": ">=18.0.0"
34
- },
35
- "repository": {
36
- "type": "git",
37
- "url": "git+https://github.com/PoktWeb/Pokt_CLI.git"
38
- },
39
- "homepage": "https://github.com/PoktWeb/Pokt_CLI#readme",
40
- "bugs": {
41
- "url": "https://github.com/PoktWeb/Pokt_CLI/issues"
42
- },
43
- "dependencies": {
44
- "@modelcontextprotocol/sdk": "^1.27.1",
45
- "chalk": "^5.3.0",
46
- "conf": "^12.0.0",
47
- "diff": "^8.0.3",
48
- "openai": "^4.28.4",
49
- "ora": "^8.0.1",
50
- "prompts": "^2.4.2",
51
- "yargs": "^17.7.2",
52
- "zod": "^3.23.8"
53
- },
54
- "devDependencies": {
55
- "@types/diff": "^7.0.2",
56
- "@types/node": "^20.11.24",
57
- "@types/prompts": "^2.4.9",
58
- "@types/yargs": "^17.0.32",
59
- "tsx": "^4.7.1",
60
- "typescript": "^5.3.3"
61
- }
62
- }
1
+ {
2
+ "name": "pokt-cli",
3
+ "version": "1.0.7",
4
+ "description": "Vibe Coding AI CLI for OpenRouter and Ollama",
5
+ "main": "./dist/bin/pokt.js",
6
+ "type": "module",
7
+ "bin": {
8
+ "pokt": "dist/bin/pokt.js"
9
+ },
10
+ "scripts": {
11
+ "build": "tsc",
12
+ "start": "node ./dist/bin/pokt.js",
13
+ "dev": "tsx ./src/bin/pokt.ts",
14
+ "prepublishOnly": "npm run build"
15
+ },
16
+ "files": [
17
+ "dist",
18
+ "package.json",
19
+ "README.md"
20
+ ],
21
+ "keywords": [
22
+ "ai",
23
+ "cli",
24
+ "coding",
25
+ "agent",
26
+ "openrouter",
27
+ "ollama"
28
+ ],
29
+ "author": "PoktWeb",
30
+ "license": "ISC",
31
+ "engines": {
32
+ "node": ">=18.0.0"
33
+ },
34
+ "repository": {
35
+ "type": "git",
36
+ "url": "git+https://github.com/PoktWeb/Pokt_CLI.git"
37
+ },
38
+ "homepage": "https://github.com/PoktWeb/Pokt_CLI#readme",
39
+ "bugs": {
40
+ "url": "https://github.com/PoktWeb/Pokt_CLI/issues"
41
+ },
42
+ "dependencies": {
43
+ "@modelcontextprotocol/sdk": "^1.27.1",
44
+ "chalk": "^5.3.0",
45
+ "conf": "^12.0.0",
46
+ "diff": "^8.0.3",
47
+ "openai": "^4.28.4",
48
+ "ora": "^8.0.1",
49
+ "prompts": "^2.4.2",
50
+ "yargs": "^17.7.2",
51
+ "zod": "^3.23.8"
52
+ },
53
+ "devDependencies": {
54
+ "@types/diff": "^7.0.2",
55
+ "@types/node": "^20.11.24",
56
+ "@types/prompts": "^2.4.9",
57
+ "@types/yargs": "^17.0.32",
58
+ "tsx": "^4.7.1",
59
+ "typescript": "^5.3.3"
60
+ }
61
+ }