tibiaway-ai 1.0.7 → 1.0.8

package/README.md

@@ -13,9 +13,44 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-FFD700.svg?style=flat-square)](LICENSE)
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-4ade80?style=flat-square)](https://nodejs.org)
 
-**TibiaWayAI** es un agente CLI instalable via npm que asiste a jugadores de Tibia en tiempo real. Sugiere hunting spots, calcula profit/waste/exp, recomienda quests, organiza sets e imbuements, explica mecánicas de bosses, lleva un diario de progreso y analiza screenshots.
+**TibiaWayAI** es un asistente de IA para jugadores de Tibia. Sugiere hunting spots, calcula profit/waste/exp, recomienda quests, organiza sets e imbuements, explica mecánicas de bosses, lleva un diario de progreso y analiza screenshots.
 
-Funciona como **CLI standalone** y como **plugin de OpenCode**.
+Funciona como **CLI standalone** (Anthropic o Ollama) y como **plugin de OpenCode** (sin API key extra).
+
+---
+
+## Instalación
+
+Un solo comando — el instalador te pregunta qué modo querés usar:
+
+```bash
+npx tibiaway-ai
+```
+
+El instalador ofrece tres opciones:
+
+| Opción | Requisito | Descripción |
+|---|---|---|
+| **Anthropic Claude** | API key de Anthropic | Mejor calidad de respuestas |
+| **Ollama (local)** | [Ollama](https://ollama.com) instalado | Completamente gratis, sin internet |
+| **Plugin de OpenCode** | [OpenCode](https://opencode.ai) | Sin API key extra, usa el modelo de OpenCode |
+
+### Instalación global
+
+```bash
+npm install -g tibiaway-ai
+tibiaway setup
+```
+
+---
+
+## Requisitos
+
+- **Node.js** >= 18.0.0
+- Según el modo elegido:
+  - **Anthropic**: API key de [console.anthropic.com](https://console.anthropic.com)
+  - **Ollama**: [ollama.com](https://ollama.com) con al menos un modelo descargado (`ollama pull llama3.2`)
+  - **OpenCode**: [OpenCode](https://opencode.ai) instalado
 
 ---
 
@@ -45,98 +80,68 @@ con objetivo de máxima exp/h, te recomiendo estos spots:
 
 ---
 
-## Requisitos
+## Comandos CLI
 
-- **Node.js** >= 18.0.0
-- **API key de Anthropic** — [Obtén la tuya aquí](https://console.anthropic.com)
-- Cuenta en Tibia (para sincronización de personaje)
+| Comando | Descripción |
+|---|---|
+| `tibiaway hunt` | Sugiere hunting spots para tu vocación y level |
+| `tibiaway profit` | Calcula profit, waste y exp/hora |
+| `tibiaway quest` | Recomienda quests según tus objetivos |
+| `tibiaway set` | Arma tu equipment con imbuements |
+| `tibiaway boss <nombre>` | Mecánicas y estrategia de cualquier boss |
+| `tibiaway diary` | Diario de progreso |
+| `tibiaway diary add` | Agrega una entrada al diario |
+| `tibiaway diary show` | Muestra el historial |
+| `tibiaway diary summary` | Resumen de progreso con IA |
+| `tibiaway analyze <archivo>` | Analiza screenshots o notas (.png, .jpg, .txt) |
+| `tibiaway sync` | Actualiza tu perfil desde tibiadata.com |
+| `tibiaway setup` | Reconfigurar proveedor de IA o personaje |
+| `tibiaway help` | Muestra todos los comandos |
 
 ---
 
-## Instalación
+## Plugin para OpenCode
 
-### Opción 1 — npx (sin instalar)
+TibiaWayAI se instala como agente y comandos en OpenCode con el mismo comando de siempre:
 
 ```bash
 npx tibiaway-ai
+# → elige "Plugin OpenCode"
 ```
 
-### Opción 2 — Instalación global
-
-```bash
-npm install -g tibiaway-ai
-tibiaway setup
-```
+Esto copia el agente y los comandos a `~/.config/opencode/` (o `.opencode/` local) y vincula tu personaje automáticamente.
 
-### Opción 3 — Desde el código fuente
+### Comandos disponibles en OpenCode
 
-```bash
-git clone https://github.com/tibiawayai/tibiaway-ai
-cd tibiaway-ai
-npm install
-node bin/tibiaway.js setup
+```
+/hunt     → Busca spots de caza
+/profit   → Calcula profit de sesión
+/quest    → Recomienda quests
+/set      → Arma tu equipment
+/boss     → Mecánicas de boss
+/diary    → Gestiona el diario
+/analyze  → Analiza screenshots
+/sync     → Refresca el perfil del agente
 ```
 
-El instalador te guiará para:
-1. Configurar tu API key de Anthropic
-2. Vincular tu personaje de Tibia (sincronización automática con tibiadata.com)
-
----
-
-## Comandos
-
-| Comando | Descripción | Ejemplo |
-|---|---|---|
-| `tibiaway hunt` | Sugiere hunting spots para tu vocación y level | `tibiaway hunt` |
-| `tibiaway profit` | Calcula profit, waste y exp/hora | `tibiaway profit` |
-| `tibiaway quest` | Recomienda quests según tus objetivos | `tibiaway quest` |
-| `tibiaway set` | Arma tu equipment con imbuements | `tibiaway set` |
-| `tibiaway boss <nombre>` | Mecánicas y estrategia de cualquier boss | `tibiaway boss "Ferumbras"` |
-| `tibiaway diary` | Diario de progreso | `tibiaway diary` |
-| `tibiaway diary add` | Agrega una entrada al diario | `tibiaway diary add` |
-| `tibiaway diary show` | Muestra el historial | `tibiaway diary show` |
-| `tibiaway diary summary` | Resumen de progreso con IA | `tibiaway diary summary` |
-| `tibiaway analyze <archivo>` | Analiza screenshots o notas | `tibiaway analyze ./loot.png` |
-| `tibiaway sync` | Actualiza tu perfil desde tibiadata.com | `tibiaway sync` |
-| `tibiaway setup` | Configuración inicial | `tibiaway setup` |
-| `tibiaway help` | Muestra todos los comandos | `tibiaway help` |
-
-### Ejemplos de uso
-
-```bash
-# Buscar el mejor spot para tu nivel y vocación
-tibiaway hunt
-
-# Calcular si tu sesión fue rentable
-tibiaway profit
-
-# Planear tu próxima quest
-tibiaway quest
-
-# Aprender mecánicas de un boss antes de enfrentarlo
-tibiaway boss "The Pale Count"
+### Sincronización de personaje en OpenCode
 
-# Analizar un screenshot de loot
-tibiaway analyze ./screenshot_2025.png
+El agente lee `~/.tibiaway/config.json` al inicio de cada sesión y detecta tu personaje automáticamente. Para refrescar el contexto durante una conversación:
 
-# Ver resumen de tu progreso
-tibiaway diary summary
+```
+/sync
 ```
 
 ---
 
 ## ¿Cómo funciona el sync de personaje?
 
-TibiaWayAI se conecta a la API pública de [TibiaData](https://tibiadata.com) para obtener datos de tu personaje en tiempo real.
+TibiaWayAI se conecta a la API pública de [TibiaData](https://tibiadata.com) — sin IA, sin API key:
 
-**Flujo de configuración:**
-
-1. Al ejecutar `tibiaway setup` o por primera vez, se muestra el banner
-2. Se pide el nombre de tu personaje
-3. Se consulta `https://api.tibiadata.com/v4/character/[nombre]`
-4. Se muestran tus datos: nombre, vocación, level, world y guild
-5. Confirmas si es tu personaje
-6. Todo se guarda en `~/.tibiaway/config.json`
+1. Se ingresa el nombre del personaje
+2. Se consulta `https://api.tibiadata.com/v4/character/[nombre]`
+3. Se muestran los datos: nombre, vocación, level, world y guild
+4. Se confirma y se guarda en `~/.tibiaway/config.json`
 
 **Actualizar tu perfil:**
 
@@ -145,10 +150,12 @@ tibiaway sync
 # ✓ Perfil actualizado: Draken Fireblade | Level 347 | Elder Druid
 ```
 
-**Estructura del perfil guardado** (`~/.tibiaway/config.json`):
+**Estructura del archivo de configuración** (`~/.tibiaway/config.json`):
 
 ```json
 {
+  "provider": "anthropic",
+  "anthropic_api_key": "sk-ant-...",
   "character": {
     "name": "Draken Fireblade",
     "vocation": "Elder Druid",
@@ -156,46 +163,12 @@ tibiaway sync
     "world": "Antica",
     "guild": "The Tibia Gods"
   },
-  "anthropic_api_key": "sk-ant-...",
-  "language": "español",
   "diary": [],
   "last_sync": "2025-05-17T12:00:00.000Z"
 }
 ```
 
----
-
-## Plugin para OpenCode
-
-TibiaWayAI incluye definiciones de agente y comandos compatibles con OpenCode.
-
-### Instalar el agente
-
-```bash
-# Copia el agente a tu configuración de OpenCode
-cp agents/tibiaway.md ~/.config/opencode/agents/
-
-# O para uso local (solo este proyecto)
-cp agents/tibiaway.md .opencode/agents/
-```
-
-### Instalar los comandos
-
-```bash
-cp commands/*.md ~/.config/opencode/commands/
-```
-
-### Usar en OpenCode
-
-```
-/hunt       → Busca spots de caza
-/profit     → Calcula profit de sesión
-/quest      → Recomienda quests
-/set        → Arma tu equipment
-/boss       → Mecánicas de boss
-/diary      → Gestiona el diario
-/analyze    → Analiza screenshots
-```
+Para Ollama, en lugar de `anthropic_api_key` se guardan `ollama_model` y `ollama_url`.
 
 ---
 
@@ -204,37 +177,38 @@ cp commands/*.md ~/.config/opencode/commands/
 ```
 tibiaway-ai/
 ├── bin/
-│   └── tibiaway.js           # Punto de entrada CLI principal
+│   └── tibiaway.js           # Punto de entrada CLI
 ├── src/
-│   ├── installer.js          # Lógica de instalación interactiva
-│   ├── standalone.js         # Modo CLI standalone (router de comandos)
-│   ├── tibia-api.js          # Wrapper API pública tibiadata.com
+│   ├── installer.js          # Instalación interactiva (3 modos)
+│   ├── standalone.js         # Router de comandos CLI
 │   ├── commands/
-│   │   ├── hunt.js           # Hunting spots personalizados
-│   │   ├── profit.js         # Calculadora de profit/waste/exp
-│   │   ├── quest.js          # Recomendador de quests
-│   │   ├── set.js            # Armador de sets e imbuements
-│   │   ├── boss.js           # Mecánicas de bosses
-│   │   ├── diary.js          # Diario de progreso
-│   │   ├── analyze.js        # Análisis de screenshots y notas
-│   │   └── sync.js           # Sincronización de perfil
+│   │   ├── hunt.js
+│   │   ├── profit.js
+│   │   ├── quest.js
+│   │   ├── set.js
+│   │   ├── boss.js
+│   │   ├── diary.js
+│   │   ├── analyze.js
+│   │   ├── sync.js
+│   │   └── setup-opencode.js # Setup del plugin OpenCode
 │   └── utils/
 │       ├── banner.js         # Banner ASCII y helpers de UI
 │       ├── config.js         # Config en ~/.tibiaway/config.json
 │       ├── character.js      # Gestión del perfil de personaje
-│       └── api.js            # Wrapper Anthropic API (Claude)
+│       └── api.js            # Wrapper Anthropic + Ollama
 ├── agents/
 │   └── tibiaway.md           # Definición del agente OpenCode
-├── commands/                 # Prompts para comandos OpenCode
+├── commands/                 # Slash commands para OpenCode
 │   ├── hunt.md
 │   ├── profit.md
 │   ├── quest.md
 │   ├── set.md
 │   ├── boss.md
 │   ├── diary.md
-│   └── analyze.md
+│   ├── analyze.md
+│   └── sync.md
 ├── web/
-│   └── index.html            # Landing page (vanilla, sin frameworks)
+│   └── index.html            # Landing page
 ├── package.json
 └── README.md
 ```
@@ -248,11 +222,6 @@ tibiaway-ai/
 | `ANTHROPIC_API_KEY` | API key de Anthropic (alternativa a la configuración guardada) |
 | `DEBUG` | Si está definida, muestra errores detallados |
 
-```bash
-export ANTHROPIC_API_KEY=sk-ant-tu-key-aqui
-tibiaway hunt
-```
-
 ---
 
 ## Contributing
@@ -280,5 +249,5 @@ MIT © TibiaWayAI
 
 ---
 
-*TibiaWayAI no está afiliado con CipSoft GmbH ni con Tibia oficialmente.*
+*TibiaWayAI no está afiliado con CipSoft GmbH ni con Tibia oficialmente.*  
 *Tibia® es una marca registrada de CipSoft GmbH.*

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "tibiaway-ai",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Tu guía de Tibia powered by AI. Your path through Tibia, powered by AI.",
   "bin": {
-    "tibiaway": "./bin/tibiaway.js",
-    "tibiaway-ai": "./bin/tibiaway.js"
+    "tibiaway": "bin/tibiaway.js",
+    "tibiaway-ai": "bin/tibiaway.js"
   },
   "type": "module",
   "engines": {
@@ -42,7 +42,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/tibiawayai/tibiaway-ai"
+    "url": "git+https://github.com/tibiawayai/tibiaway-ai.git"
   },
   "homepage": "https://tibiawayai.com",
   "bugs": {