Skill opencode-server-api
✓ VérifiéEffectuez des requêtes en lecture seule sur le serveur OpenCode 2.x pour inspecter les sessions, l'historique des messages, le statut MCP, les skills et les agents.
- Étoiles GitHub
- 13
- Fichiers
- 1
- Dernier commit
- 30 oct. 2026
- Licence
- MIT
- Outils autorisés
- —
Que fait la skill opencode-server-api ?
Effectuez des requêtes en lecture seule sur le serveur OpenCode 2.x pour inspecter les sessions, l'historique des messages, le statut MCP, les skills et les agents.
Résumé généré à partir du SKILL.md de la skill.
À propos du skill opencode-server-api
Cette skill permet aux développeurs et aux agents IA d'inspecter l'état et l'historique de votre serveur OpenCode 2.x. Elle fournit une interface en lecture seule pour interroger les informations du serveur, les sessions actives, l'historique des messages et le statut des MCP servers connectés. Un agent devrait charger cet outil lorsqu'un utilisateur pose des questions sur sa session actuelle, les skills disponibles, les outils connectés ou les demandes de permission en attente.
Les utilisateurs interagissent avec le serveur via des requêtes GET en utilisant l'authentification HTTP basic avec un mot de passe stocké dans la variable d'environnement OPENCODE_SERVER_PASSWORD. La skill s'appuie sur la récupération d'une spécification OpenAPI en direct depuis le serveur pour garantir l'exactitude de tous les appels de routes et de paramètres. Elle peut récupérer des détails spécifiques tels que les résultats de session, les types de messages et même une liste de tâches en analysant l'entrée de l'appel d'outil todowrite le plus récent dans l'historique des messages. Elle est strictement limitée aux opérations de lecture seule et ne peut pas être utilisée pour modifier l'état du serveur, répondre à des formulaires ou accéder aux fichiers de configuration bruts.
Ce qu'un agent peut faire avec
- 1Récupérer les listes de tâches activesTrouvez la liste actuelle des tâches en attente en inspectant le dernier appel d'outil todowrite.
Rédigé à partir du SKILL.md du skill. Chaque cas d'utilisation est vérifié par rapport à une citation de celui-ci.
Comment installer la skill opencode-server-api
Chaque commande copie le dossier de la skill dans le répertoire des skills du client. Redémarrez le client ou démarrez une nouvelle session pour la charger.Installer la skill opencode-server-api dans 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-apiInstaller la skill opencode-server-api dans 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-apiInstaller la skill opencode-server-api dans Codex
~/.agents/skills/opencode-server-api/SKILL.md
$ npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.agents/skills/opencode-server-apiInstaller la skill opencode-server-api dans 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-apiInstaller la skill opencode-server-api dans 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
Vérifications automatisées
Exécuté le 16 nov. 2026Rapport complet →A réussi nos vérifications automatiques. Ce n'est pas un audit de sécurité : lisez les scripts avant de laisser un agent les exécuter. Fonctionnement des vérifications
- Dépôt source lié et accessiblekevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api is public and reachablegithub.com/kevinlin/cowork-z/tree/HEAD/src-tauri/resources/s ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit 2026-10-30github.com/kevinlin/cowork-z/commits ↗Réussi
- Aucun téléchargement-exécution ni vol d'identifiants dans les scriptsNo scripts in the skill folderRéussi
- Aucune instruction cachée dans SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Réussi
- Les outils préautorisés sont limitésNo pre-approved tools; the agent asks before using onegithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Réussi
- SKILL.md respecte le format Agent SkillsValid name and description; says when to use it; 91 linesgithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Réussi
SKILL.md
Voir sur 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.
Fichiers de cette skill
1Questions sur la skill opencode-server-api
Comment installer la skill opencode-server-api dans Claude Code ?
Exécutez npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.claude/skills/opencode-server-api. Claude Code charge les skills depuis ~/.claude/skills (tous les projets) ou .claude/skills (un seul projet) et utilise une skill lorsque sa description correspond à la tâche.
Quels clients peuvent utiliser la skill opencode-server-api ?
Tout client qui lit le format Agent Skills : Claude Code, Codex, Gemini CLI et claude.ai (envoi sous forme de ZIP). Les scripts de la skill ne s'exécutent que si le client autorise l'exécution de code.
Comment puis-je vérifier l'état de santé du serveur OpenCode ?
Vous pouvez utiliser le point de terminaison /api/info pour récupérer la version du serveur, le PID et les URL, ce qui fait office de test de santé (health check).
Comment accéder à ma liste de tâches via l'API ?
Il n'existe pas de route dédiée aux tâches ; vous devez plutôt lire l'historique des messages par ordre décroissant, trouver le premier élément de l'outil 'todowrite' et extraire le champ 'state.input.todos'.
Que dois-je faire avant d'appeler un point de terminaison d'API ?
Vous devez toujours récupérer la spécification OpenAPI en direct au préalable pour vous assurer d'avoir les bonnes routes, les bons paramètres et les bonnes structures de réponse.