Skill opencode-server-api
✓ VerificadoRealiza consultas de solo lectura contra el servidor OpenCode 2.x para inspeccionar sesiones, historial de mensajes, estado de MCP, skills y agentes.
- Estrellas en GitHub
- 13
- Archivos
- 1
- Último commit
- 30 oct 2026
- Licencia
- MIT
- Herramientas permitidas
- —
¿Qué hace la skill opencode-server-api?
Realiza consultas de solo lectura contra el servidor OpenCode 2.x para inspeccionar sesiones, historial de mensajes, estado de MCP, skills y agentes.
Resumen generado a partir del SKILL.md de la skill.
Sobre la skill opencode-server-api
Esta skill permite a desarrolladores y agentes de IA inspeccionar el estado y el historial de su servidor OpenCode 2.x. Proporciona una interfaz de solo lectura para consultar información del servidor, sesiones activas, historiales de mensajes y el estado de los MCP servers conectados. Un agente debería cargar esta herramienta cuando un usuario pregunte sobre su sesión actual, las skills disponibles, las herramientas conectadas o las solicitudes de permiso pendientes.
Los usuarios interactúan con el servidor mediante solicitudes GET utilizando autenticación básica HTTP con una contraseña almacenada en la variable de entorno OPENCODE_SERVER_PASSWORD. La skill se basa en obtener una especificación OpenAPI en vivo desde el servidor para garantizar que todas las llamadas a rutas y parámetros sean precisas. Puede recuperar detalles específicos como resultados de sesiones, tipos de mensajes e incluso una lista de tareas pendientes analizando la entrada de la llamada más reciente a la herramienta todowrite en el historial de mensajes. Está estrictamente limitada a operaciones de solo lectura y no puede utilizarse para cambiar el estado del servidor, responder formularios o acceder a archivos de configuración sin procesar.
Lo que un agente puede hacer con ella
- 1Recuperar listas de tareas pendientesEncuentra la lista actual de tareas pendientes inspeccionando la última llamada a la herramienta todowrite.
Escrito a partir del SKILL.md de la skill. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar la skill opencode-server-api
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill opencode-server-api en Claude Code
~/.claude/skills/opencode-server-api/SKILL.md
$ npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.claude/skills/opencode-server-apiInstalar la skill opencode-server-api en Claude Code (project)
.claude/skills/opencode-server-api/SKILL.md
$ npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api .claude/skills/opencode-server-apiInstalar la skill opencode-server-api en Codex
~/.agents/skills/opencode-server-api/SKILL.md
$ npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.agents/skills/opencode-server-apiInstalar la skill opencode-server-api en Gemini CLI
~/.gemini/skills/opencode-server-api/SKILL.md
$ npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.gemini/skills/opencode-server-apiInstalar la skill opencode-server-api en Claude.ai
npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api opencode-server-api && zip -r opencode-server-api.zip opencode-server-api # claude.ai → Customize → Skills → + → Create skill → Upload a skill → opencode-server-api.zip
Verificaciones automáticas
Ejecutado 16 nov 2026Informe completo →Superó nuestras comprobaciones automáticas. No es una auditoría de seguridad: lee los scripts antes de dejar que un agente los ejecute. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblekevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api is public and reachablegithub.com/kevinlin/cowork-z/tree/HEAD/src-tauri/resources/s ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit 2026-10-30github.com/kevinlin/cowork-z/commits ↗Aprobado
- Sin descargar y ejecutar ni robo de credenciales en los scriptsNo scripts in the skill folderAprobado
- Sin instrucciones ocultas en SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Aprobado
- Las herramientas preaprobadas están acotadasNo pre-approved tools; the agent asks before using onegithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Aprobado
- SKILL.md sigue el formato de Agent SkillsValid name and description; says when to use it; 91 linesgithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Aprobado
SKILL.md
Ver en GitHubOpenCode Server API
This skill lets you inspect the OpenCode server you run on — server info, sessions, message history (including your todo lists), pending permission and question requests, MCP status, skills and agents. It is read-only: use GET requests only.
Authentication
The server port is in your system prompt, inside the <server-access> block. The basic-auth password is already in your shell environment as OPENCODE_SERVER_PASSWORD; your shell expands it locally. Every request needs HTTP basic auth:
curl -s -u "opencode:$OPENCODE_SERVER_PASSWORD" http://localhost:$PORT/<endpoint>
Replace $PORT with the port from your system prompt. Use $OPENCODE_SERVER_PASSWORD exactly as written (PowerShell: $env:OPENCODE_SERVER_PASSWORD).
NEVER print, echo, log, or write the password's value anywhere — not to the chat, not to files, not to command output. Only reference it as a shell variable inside commands.
IMPORTANT: Fetch the API Spec First
Before calling ANY endpoint, fetch the live OpenAPI spec. It is the source of truth for routes, parameters and response shapes, and it may be newer than this skill.
curl -s -u "opencode:$OPENCODE_SERVER_PASSWORD" http://localhost:$PORT/openapi.json
Do not guess from the examples below; verify against the spec first.
Conventions
- All API routes live under
/api/. Answers are wrapped:{"data": ...}, plus"location"on location-scoped routes. - Location-scoped routes (
/api/mcp,/api/skill,/api/agent) take the workspace folder as alocation[directory]query parameter. The brackets break plain curl URLs, so pass it with-G --data-urlencode:
curl -s -G -u "opencode:$OPENCODE_SERVER_PASSWORD" \
--data-urlencode "location[directory]=<workspace path>" \
http://localhost:$PORT/api/mcp
The workspace path is given in your system prompt (<workspace-conventions>). Session routes need no location.
Endpoints (all GET)
| Route | Returns |
|---|---|
/api/info |
Server version, pid, urls. Use it as the health check. |
/api/session |
{data: [session]} — your sessions. Optional directory, limit, search. |
/api/session/{id} |
{data: session} — id, model, outcome, time, location, permissions. |
/api/session/{id}/message |
{data: [message], cursor} — history. Pass order=desc for newest first, order=asc for oldest first. |
/api/session/{id}/permission |
{data: [request]} — permission requests waiting for an answer. |
/api/session/{id}/form |
{data: [form]} — questions waiting for an answer. |
/api/mcp |
{data: [{name, status: {status, error?}}]} — MCP servers. |
/api/skill |
{data: [{id, name, path, content}]} — available skills. |
/api/agent |
{data: [agent]} — available agents and their models. |
Find your own session in /api/session (filter with directory=<workspace path>).
/api/session/{id}/message
Messages have a type (user, assistant, idle, …). An assistant message has a content array of text, reasoning and tool items. A tool item is {type: "tool", name, state: {status, input, content}}.
Your todo list is the input.todos of your newest todowrite call: read the history newest first (order=desc), find the first tool item named todowrite and take state.input.todos ([{content, status}], status pending, in_progress or completed). There is no todo route.
curl -s -u "opencode:$OPENCODE_SERVER_PASSWORD" "http://localhost:$PORT/api/session/ses_abc123/message?order=desc"
/api/mcp
status.status is one of connected, pending (still connecting), disabled, failed or needs_auth; error is set on the last two. The list also includes servers from the user's global OpenCode config.
/api/session/{id}/permission and /form
Pending permission request: {id, action, resources, metadata, message?}. Pending form: {id, title, fields: [{key, type, options?}]}. Both are empty when nothing is waiting.
Out of scope
Do not call routes that change state (creating or deleting sessions, prompting, interrupting, answering permissions or forms, editing config or MCP servers). The user decides those in the app. Do not call any route that handles credentials or provider sign-in either; they are not part of this skill. Do not call /api/config: it returns the user's raw config files, which can hold API keys.
Usage Guidance
- Check health (
/api/info) before other calls when the server seems unresponsive. - Review your own work (
/api/session/{id}/message) to see what you have said and done. - Check todos by reading your newest
todowritecall from the message history. - List skills (
/api/skill) when asked about your capabilities. - Check MCP status (
/api/mcp) when asked about connected tools or servers. - List agents (
/api/agent) to understand your current setup.
Archivos de esta skill
1Preguntas sobre la skill opencode-server-api
¿Cómo instalo la skill opencode-server-api en Claude Code?
Ejecuta npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.claude/skills/opencode-server-api. Claude Code carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill opencode-server-api?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
¿Cómo puedo comprobar el estado del servidor OpenCode?
Puedes usar el endpoint /api/info para obtener la versión del servidor, el PID y las URLs, lo cual sirve como una comprobación de estado.
¿Cómo accedo a mi lista de tareas pendientes a través de la API?
No existe una ruta dedicada para los todos; en su lugar, debes leer el historial de mensajes en orden descendente, encontrar el primer elemento de la herramienta 'todowrite' y extraer el campo 'state.input.todos'.
¿Qué debo hacer antes de llamar a cualquier endpoint de la API?
Siempre debes obtener primero la especificación OpenAPI en vivo para asegurarte de tener las rutas, los parámetros y las estructuras de respuesta correctos.