zugzbot 1.0.6 → 1.0.8

package/.utils/docs_opencode/commands.md

@@ -0,0 +1,354 @@
+# Comandos
+
+Cree comandos personalizados para tareas repetitivas.
+
+Los comandos personalizados le permiten especificar un mensaje que desea ejecutar cuando ese comando se ejecuta en TUI.
+
+**File**:
+
+```bash
+/my-command
+```
+
+Los comandos personalizados se suman a los comandos integrados como `/init`, `/undo`, `/redo`, `/share`, `/help`. [Más información](https://opencode.ai/docs/tui#commands).
+
+---
+
+## [Crear archivos de comando](#crear-archivos-de-comando)
+
+Cree archivos de Markdown en el directorio `commands/` para definir comandos personalizados.
+
+Crear `.opencode/commands/test.md`:
+
+**File**: .opencode/commands/test.md
+
+```md
+---
+description: Run tests with coverage
+agent: build
+model: anthropic/claude-3-5-sonnet-20241022
+---
+
+Run the full test suite with coverage report and show any failures.
+Focus on the failing tests and suggest fixes.
+```
+
+El frontmatter define las propiedades del comando. El contenido se convierte en la plantilla.
+
+Utilice el comando escribiendo `/` seguido del nombre del comando.
+
+**File**:
+
+```bash
+"/test"
+```
+
+---
+
+## [Configuración](#configuración)
+
+Puede agregar comandos personalizados a través de la configuración OpenCode o creando archivos de Markdown en el directorio `commands/`.
+
+---
+
+### [JSON](#json)
+
+Utilice la opción `command` en su OpenCode [config](https://opencode.ai/docs/config):
+
+**File**: opencode.jsonc
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "command": {
+    // This becomes the name of the command
+    "test": {
+      // This is the prompt that will be sent to the LLM
+      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes.",
+      // This is shown as the description in the TUI
+      "description": "Run tests with coverage",
+      "agent": "build",
+      "model": "anthropic/claude-3-5-sonnet-20241022"
+    }
+  }
+}
+```
+
+Ahora puedes ejecutar este comando en TUI:
+
+**File**:
+
+```bash
+/test
+```
+
+---
+
+### [Markdown](#markdown)
+
+También puede definir comandos utilizando archivos de Markdown. Colócalos en:
+
+- Global: `~/.config/opencode/commands/`
+- Por proyecto: `.opencode/commands/`
+
+**File**: ~/.config/opencode/commands/test.md
+
+```markdown
+---
+description: Run tests with coverage
+agent: build
+model: anthropic/claude-3-5-sonnet-20241022
+---
+
+Run the full test suite with coverage report and show any failures.
+Focus on the failing tests and suggest fixes.
+```
+
+El nombre del archivo de Markdown se convierte en el nombre del comando. Por ejemplo, `test.md` permite que lo ejecutes:
+
+**File**:
+
+```bash
+/test
+```
+
+---
+
+## [Configuración de indicaciones](#configuración-de-indicaciones)
+
+Las indicaciones para los comandos personalizados admiten varios marcadores de posición y sintaxis especiales.
+
+---
+
+### [Argumentos](#argumentos)
+
+Pase argumentos a comandos usando el marcador de posición `$ARGUMENTS`.
+
+**File**: .opencode/commands/component.md
+
+```md
+---
+description: Create a new component
+---
+
+Create a new React component named $ARGUMENTS with TypeScript support.
+Include proper typing and basic structure.
+```
+
+Ejecute el comando con argumentos:
+
+**File**:
+
+```bash
+/component Button
+```
+
+Y `$ARGUMENTS` será reemplazado por `Button`.
+
+También puede acceder a argumentos individuales utilizando parámetros posicionales:
+
+- `$1` - Primer argumento
+- `$2` - Segundo argumento
+- `$3` - Tercer argumento
+- Etcétera…
+
+Por ejemplo:
+
+**File**: .opencode/commands/create-file.md
+
+```md
+---
+description: Create a new file with content
+---
+
+Create a file named $1 in the directory $2
+with the following content: $3
+```
+
+Ejecute el comando:
+
+**File**:
+
+```bash
+/create-file config.json src "{ \"key\": \"value\" }"
+```
+
+Esto reemplaza:
+
+- `$1` con `config.json`
+- `$2` con `src`
+- `$3` con `{ "key": "value" }`
+
+---
+
+### [Salida del shell](#salida-del-shell)
+
+Utilice *!`command`* para inyectar la salida de [comando bash](https://opencode.ai/docs/tui#bash-commands) en su mensaje.
+
+Por ejemplo, para crear un comando personalizado que analice la cobertura de la prueba:
+
+**File**: .opencode/commands/analyze-coverage.md
+
+```md
+---
+description: Analyze test coverage
+---
+
+Here are the current test results:
+!`npm test`
+
+Based on these results, suggest improvements to increase coverage.
+```
+
+O para revisar cambios recientes:
+
+**File**: .opencode/commands/review-changes.md
+
+```md
+---
+description: Review recent changes
+---
+
+Recent git commits:
+!`git log --oneline -10`
+
+Review these changes and suggest any improvements.
+```
+
+Los comandos se ejecutan en el directorio raíz de su proyecto y su salida pasa a formar parte del mensaje.
+
+---
+
+### [Referencias de archivos](#referencias-de-archivos)
+
+Incluya archivos en su comando usando `@` seguido del nombre del archivo.
+
+**File**: .opencode/commands/review-component.md
+
+```md
+---
+description: Review component
+---
+
+Review the component in @src/components/Button.tsx.
+Check for performance issues and suggest improvements.
+```
+
+El contenido del archivo se incluye automáticamente en el mensaje.
+
+---
+
+## [Opciones](#opciones)
+
+Veamos las opciones de configuración en detalle.
+
+---
+
+### [Plantilla](#plantilla)
+
+La opción `template` define el mensaje que se enviará al LLM cuando se ejecute el comando.
+
+**File**: opencode.json
+
+```json
+{
+  "command": {
+    "test": {
+      "template": "Run the full test suite with coverage report and show any failures.\nFocus on the failing tests and suggest fixes."
+    }
+  }
+}
+```
+
+Esta es una opción de configuración **obligatoria**.
+
+---
+
+### [Descripción](#descripción)
+
+Utilice la opción `description` para proporcionar una breve descripción de lo que hace el comando.
+
+**File**: opencode.json
+
+```json
+{
+  "command": {
+    "test": {
+      "description": "Run tests with coverage"
+    }
+  }
+}
+```
+
+Esto se muestra como descripción en TUI cuando escribe el comando.
+
+---
+
+### [Agente](#agente)
+
+Utilice la configuración `agent` para especificar opcionalmente qué [agente](https://opencode.ai/docs/agents) debe ejecutar este comando. Si se trata de un [subagente](https://opencode.ai/docs/agents/#subagents), el comando activará una invocación de subagente de forma predeterminada. Para desactivar este comportamiento, establezca `subtask` en `false`.
+
+**File**: opencode.json
+
+```json
+{
+  "command": {
+    "review": {
+      "agent": "plan"
+    }
+  }
+}
+```
+
+Esta es una opción de configuración **opcional**. Si no se especifica, el valor predeterminado es su agente actual.
+
+---
+
+### [Subtarea](#subtarea)
+
+Utilice el booleano `subtask` para forzar que el comando active una invocación de [subagente](https://opencode.ai/docs/agents/#subagents). Esto es útil si desea que el comando no contamine su contexto principal y **obligue** al agente a actuar como subagente. incluso si `mode` está configurado en `primary` en la configuración de [agente](https://opencode.ai/docs/agents).
+
+**File**: opencode.json
+
+```json
+{
+  "command": {
+    "analyze": {
+      "subtask": true
+    }
+  }
+}
+```
+
+Esta es una opción de configuración **opcional**.
+
+---
+
+### [Modelo](#modelo)
+
+Utilice la configuración `model` para anular el modelo predeterminado para este comando.
+
+**File**: opencode.json
+
+```json
+{
+  "command": {
+    "analyze": {
+      "model": "anthropic/claude-3-5-sonnet-20241022"
+    }
+  }
+}
+```
+
+Esta es una opción de configuración **opcional**.
+
+---
+
+## [Integrados](#integrados)
+
+opencode incluye varios comandos integrados como `/init`, `/undo`, `/redo`, `/share`, `/help`; [más información](https://opencode.ai/docs/tui#commands).
+
+> [!NOTE]
+> Los comandos personalizados pueden anular los comandos integrados.
+
+Si define un comando personalizado con el mismo nombre, anulará el comando integrado.

package/.utils/docs_opencode/custom-tools.md

@@ -0,0 +1,209 @@
+# Herramientas personalizadas
+
+Cree herramientas que LLM pueda llamar en opencode.
+
+Las herramientas personalizadas son funciones que usted crea y que el LLM puede llamar durante las conversaciones. Trabajan junto con las [herramientas integradas](https://opencode.ai/docs/tools) de opencode como `read`, `write` y `bash`.
+
+---
+
+## [Crear una herramienta](#crear-una-herramienta)
+
+Las herramientas se definen como archivos **TypeScript** o **JavaScript**. Sin embargo, la definición de la herramienta puede invocar secuencias de comandos escritas en **cualquier idioma**: TypeScript o JavaScript solo se utilizan para la definición de la herramienta en sí.
+
+---
+
+### [Ubicación](#ubicación)
+
+Se pueden definir:
+
+- Localmente colocándolos en el directorio `.opencode/tools/` de tu proyecto.
+- O de forma global, colocándolos en `~/.config/opencode/tools/`.
+
+---
+
+### [Estructura](#estructura)
+
+La forma más sencilla de crear herramientas es utilizar el asistente `tool()` que proporciona seguridad de tipos y validación.
+
+**File**: .opencode/tools/database.ts
+
+```ts
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Query the project database",
+  args: {
+    query: tool.schema.string().describe("SQL query to execute"),
+  },
+  async execute(args) {
+    // Your database logic here
+    return `Executed query: ${args.query}`
+  },
+})
+```
+
+El **nombre de archivo** se convierte en el **nombre de la herramienta**. Lo anterior crea una herramienta `database`.
+
+---
+
+#### [Múltiples herramientas por archivo](#múltiples-herramientas-por-archivo)
+
+También puede exportar varias herramientas desde un solo archivo. Cada exportación se convierte en **una herramienta independiente** con el nombre **`_`**:
+
+**File**: .opencode/tools/math.ts
+
+```ts
+import { tool } from "@opencode-ai/plugin"
+
+export const add = tool({
+  description: "Add two numbers",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args) {
+    return args.a + args.b
+  },
+})
+
+export const multiply = tool({
+  description: "Multiply two numbers",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args) {
+    return args.a * args.b
+  },
+})
+```
+
+Esto crea dos herramientas: `math_add` y `math_multiply`.
+
+---
+
+#### [Colisiones de nombres con herramientas integradas](#colisiones-de-nombres-con-herramientas-integradas)
+
+Las herramientas personalizadas están codificadas por el nombre de la herramienta. Si una herramienta personalizada utiliza el mismo nombre que una herramienta integrada, la herramienta personalizada tiene prioridad.
+
+Por ejemplo, este archivo reemplaza la herramienta `bash` integrada:
+
+**File**: .opencode/tools/bash.ts
+
+```ts
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Restricted bash wrapper",
+  args: {
+    command: tool.schema.string(),
+  },
+  async execute(args) {
+    return `blocked: ${args.command}`
+  },
+})
+```
+
+> [!NOTE]
+> Prefiera nombres únicos a menos que intencionalmente desee reemplazar una herramienta integrada. Si desea deshabilitar una herramienta integrada pero no anularla, use [permisos](https://opencode.ai/docs/permissions).
+
+---
+
+### [Argumentos](#argumentos)
+
+Puedes usar `tool.schema`, que es simplemente [Zod](https://zod.dev), para definir tipos de argumentos.
+
+**File**:
+
+```ts
+args: {
+  query: tool.schema.string().describe("SQL query to execute")
+}
+```
+
+También puedes importar [Zod](https://zod.dev) directamente y devolver un objeto simple:
+
+**File**:
+
+```ts
+import { z } from "zod"
+
+export default {
+  description: "Tool description",
+  args: {
+    param: z.string().describe("Parameter description"),
+  },
+  async execute(args, context) {
+    // Tool implementation
+    return "result"
+  },
+}
+```
+
+---
+
+### [Contexto](#contexto)
+
+Las herramientas reciben contexto sobre la sesión actual:
+
+**File**: .opencode/tools/project.ts
+
+```ts
+import { tool } from "@opencode-ai/plugin"
+
+export default tool({
+  description: "Get project information",
+  args: {},
+  async execute(args, context) {
+    // Access context information
+    const { agent, sessionID, messageID, directory, worktree } = context
+    return `Agent: ${agent}, Session: ${sessionID}, Message: ${messageID}, Directory: ${directory}, Worktree: ${worktree}`
+  },
+})
+```
+
+Utilice `context.directory` para el directorio de trabajo de la sesión. Utilice `context.worktree` para la raíz del árbol de trabajo de git.
+
+---
+
+## [Ejemplos](#ejemplos)
+
+### [Escribir una herramienta en Python](#escribir-una-herramienta-en-python)
+
+Puede escribir sus herramientas en cualquier idioma que desee. Aquí hay un ejemplo que suma dos números usando Python.
+
+Primero, cree la herramienta como un script de Python:
+
+**File**: .opencode/tools/add.py
+
+```python
+import sys
+
+a = int(sys.argv[1])
+b = int(sys.argv[2])
+print(a + b)
+```
+
+Luego cree la definición de herramienta que la invoca:
+
+**File**: .opencode/tools/python-add.ts
+
+```ts
+import { tool } from "@opencode-ai/plugin"
+import path from "path"
+
+export default tool({
+  description: "Add two numbers using Python",
+  args: {
+    a: tool.schema.number().describe("First number"),
+    b: tool.schema.number().describe("Second number"),
+  },
+  async execute(args, context) {
+    const script = path.join(context.worktree, ".opencode/tools/add.py")
+    const result = await Bun.$`python3 ${script} ${args.a} ${args.b}`.text()
+    return result.trim()
+  },
+})
+```
+
+Aquí estamos usando la utilidad ``[Bun.$](https://bun.com/docs/runtime/shell) para ejecutar el script Python.

package/.utils/docs_opencode/ecosystem.md

@@ -0,0 +1,81 @@
+# Ecosistema
+
+Proyectos e integraciones construidas con OpenCode.
+
+Una colección de proyectos comunitarios construidos en OpenCode.
+
+> [!NOTE]
+> ¿Quieres agregar tu proyecto relacionado con OpenCode a esta lista? Envíe un PR.
+
+También puedes consultar [awesome-opencode](https://github.com/awesome-opencode/awesome-opencode) y [opencode.cafe](https://opencode.cafe), una comunidad que agrega el ecosistema y la comunidad.
+
+---
+
+## [Complementos](#complementos)
+ [opencode-daytona](https://github.com/daytonaio/daytona/tree/main/libs/opencode-plugin)[opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session)[opencode-type-inject](https://github.com/nick-vi/opencode-type-inject)[opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth)[opencode-gemini-auth](https://github.com/jenslys/opencode-gemini-auth)[opencode-antigravity-auth](https://github.com/NoeFabris/opencode-antigravity-auth)[opencode-devcontainers](https://github.com/athal7/opencode-devcontainers)[opencode-google-antigravity-auth](https://github.com/shekohex/opencode-google-antigravity-auth)[opencode-dynamic-context-pruning](https://github.com/Tarquinen/opencode-dynamic-context-pruning)[opencode-vibeguard](https://github.com/inkdust2021/opencode-vibeguard)[opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git)[opencode-pty](https://github.com/shekohex/opencode-pty.git)[opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy)[opencode-wakatime](https://github.com/angristan/opencode-wakatime)[opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main)[opencode-morph-plugin](https://github.com/morphllm/opencode-morph-plugin)[oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode)[opencode-notificator](https://github.com/panta82/opencode-notificator)[opencode-notifier](https://github.com/mohak34/opencode-notifier)[opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer)[opencode-skillful](https://github.com/zenobi-us/opencode-skillful)[opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory)[@plannotator/opencode](https://github.com/backnotprop/plannotator/tree/main/apps/opencode-plugin)[@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2)[opencode-scheduler](https://github.com/different-ai/opencode-scheduler)[micode](https://github.com/vtemian/micode)[octto](https://github.com/vtemian/octto)[opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents)[opencode-notify](https://github.com/kdcokenny/opencode-notify)[opencode-workspace](https://github.com/kdcokenny/opencode-workspace)[opencode-worktree](https://github.com/kdcokenny/opencode-worktree)[opencode-sentry-monitor](https://github.com/stolinski/opencode-sentry-monitor)
+
+| Nombre Descripción |
+| --- |
+| Ejecute automáticamente sesiones OpenCode en entornos sandbox aislados de Daytona con git sync y vistas previas en vivo |
+| Inyecte automáticamente encabezados de sesión de Helicone para agrupación de solicitudes |
+| Inyecte automáticamente tipos TypeScript/Svelte en lecturas de archivos con herramientas de búsqueda |
+| Utilice su suscripción ChatGPT Plus/Pro en lugar de créditos API |
+| Utilice su plan Gemini existente en lugar de la facturación API |
+| Utilice los modelos gratuitos de Antigravity en lugar de la facturación API |
+| Aislamiento de contenedores de desarrollo de múltiples ramas con clones superficiales y puertos asignados automáticamente |
+| Complemento Google Antigravity OAuth, compatible con la Búsqueda de Google y manejo más sólido de API |
+| Optimice el uso de tokens eliminando los resultados de herramientas obsoletas |
+| Redacta secretos/PII en marcadores de posición estilo VibeGuard antes de las llamadas a LLM; restaura localmente |
+| Agregue soporte de búsqueda web nativa para proveedores compatibles con el estilo basado en Google |
+| Permite a los agentes de IA ejecutar procesos en segundo plano en un PTY y enviarles información interactiva. |
+| Instrucciones para comandos de shell no interactivos: evita bloqueos de operaciones dependientes de TTY |
+| Seguimiento del uso de OpenCode con Wakatime |
+| Limpiar tablas de Markdown producidas por LLMs |
+| Edición Fast Apply, búsqueda de código con WarpGrep y compactación de contexto a través de Morph |
+| Agentes en segundo plano, herramientas LSP/AST/MCP prediseñadas, agentes seleccionados, compatible con Claude Code |
+| Notificaciones de escritorio y alertas sonoras para sesiones OpenCode |
+| Notificaciones de escritorio y alertas sonoras para eventos de permiso, finalización y error |
+| Nomenclatura automática de sesiones Zellij impulsada por IA basada en el contexto OpenCode |
+| Permitir que los agentes OpenCode carguen mensajes de forma diferida a pedido con descubrimiento e inyección de habilidades |
+| Memoria persistente entre sesiones utilizando Supermemory |
+| Revisión interactiva del plan con anotaciones visuales y uso compartido privado/sin conexión |
+| Amplíe opencode /commands a un potente sistema de orquestación con control de flujo granular |
+| Programe trabajos recurrentes usando launchd (Mac) o systemd (Linux) con sintaxis cron |
+| Lluvia de ideas estructurada → Planificar → Implementar flujo de trabajo con continuidad de sesión |
+| Interfaz de usuario interactiva del navegador para lluvia de ideas de IA con formularios de preguntas múltiples |
+| Agentes en segundo plano estilo Claude Code con delegación asíncrona y persistencia de contexto |
+| Notificaciones nativas del sistema operativo para OpenCode: sepa cuándo se completan las tareas |
+| Arnés de orquestación multiagente incluido: 16 componentes, una instalación |
+| Árboles de trabajo de Git de fricción cero para OpenCode |
+| Rastree y depure sus agentes de IA con Sentry AI Monitoring |
+
+
+---
+
+## [Proyectos](#proyectos)
+ [kimaki](https://github.com/remorses/kimaki)[opencode.nvim](https://github.com/NickvanDyke/opencode.nvim)[portal](https://github.com/hosenur/portal)[opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/)[opencode.nvim](https://github.com/sudo-tee/opencode.nvim)[ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk)[OpenChamber](https://github.com/btriapitsyn/openchamber)[OpenCode-Obsidian](https://github.com/mtymek/opencode-obsidian)[OpenWork](https://github.com/different-ai/openwork)[ocx](https://github.com/kdcokenny/ocx)[CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad)
+
+| Nombre Descripción |
+| --- |
+| Bot de Discord para controlar sesiones OpenCode, basado en el SDK |
+| Complemento Neovim para avisos compatibles con el editor, creado en API |
+| Interfaz de usuario web móvil para OpenCode a través de Tailscale/VPN |
+| Plantilla para crear complementos OpenCode |
+| Interfaz de Neovim para opencode: un agente de codificación de IA basado en terminal |
+| Proveedor Vercel AI SDK para usar OpenCode a través de @opencode-ai/sdk |
+| Aplicación web/de escritorio y extensión VS Code para OpenCode |
+| Complemento de Obsidian que incorpora OpenCode en la interfaz de usuario de Obsidian |
+| Una alternativa de código abierto a Claude Cowork, impulsada por OpenCode |
+| Administrador de extensiones OpenCode con perfiles portátiles y aislados. |
+| Aplicación de escritorio, web, móvil y de cliente remoto para OpenCode |
+
+
+---
+
+## [Agentes](#agentes)
+ [Agentic](https://github.com/Cluster444/agentic)[opencode-agents](https://github.com/darrenhinde/opencode-agents)
+
+| Nombre Descripción |
+| --- |
+| Agentes y comandos modulares de IA para un desarrollo estructurado |
+| Configuraciones, avisos, agentes y complementos para flujos de trabajo mejorados |