Skill opencode-server-api
✓ VerifiedLakukan query read-only terhadap OpenCode 2.x server untuk memeriksa session, riwayat pesan, status MCP, skill, dan agent.
- Bintang GitHub
- 13
- File
- 1
- Commit terakhir
- 30 Okt 2026
- Lisensi
- MIT
- Tool yang diizinkan
- —
Apa fungsi skill opencode-server-api?
Lakukan query read-only terhadap OpenCode 2.x server untuk memeriksa session, riwayat pesan, status MCP, skill, dan agent.
Ringkasan dibuat dari SKILL.md skill ini.
Tentang skill opencode-server-api
Skill ini memungkinkan developer dan AI agent untuk memeriksa state dan riwayat OpenCode 2.x server Anda. Skill ini menyediakan interface read-only untuk melakukan query informasi server, session aktif, riwayat pesan, dan status MCP server yang terhubung. Seorang agent harus memuat tool ini saat user bertanya tentang session mereka saat ini, skill yang tersedia, tool yang terhubung, atau permintaan izin yang tertunda.
User berinteraksi dengan server melalui request GET menggunakan HTTP basic authentication dengan password yang tersimpan di environment variable OPENCODE_SERVER_PASSWORD. Skill ini mengandalkan pengambilan live OpenAPI spec dari server untuk memastikan semua panggilan route dan parameter sudah akurat. Skill ini dapat mengambil detail spesifik seperti hasil session, tipe pesan, dan bahkan daftar todo dengan memparsing input dari pemanggilan tool todowrite terbaru dalam riwayat pesan. Skill ini dibatasi secara ketat hanya untuk operasi read-only dan tidak dapat digunakan untuk mengubah state server, menjawab form, atau mengakses file konfigurasi mentah.
Apa yang bisa dilakukan agent dengannya
- 1Mengambil daftar todo aktifTemukan daftar tugas yang tertunda saat ini dengan memeriksa pemanggilan tool todowrite terbaru.
Ditulis dari SKILL.md milik skill tersebut. Setiap use case diverifikasi dengan kutipan darinya.
Cara install skill opencode-server-api
Setiap perintah menyalin folder skill ke direktori skills client. Restart client atau mulai sesi baru untuk memuatnya.Install skill opencode-server-api di 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-apiInstall skill opencode-server-api di 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-apiInstall skill opencode-server-api di Codex
~/.agents/skills/opencode-server-api/SKILL.md
$ npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.agents/skills/opencode-server-apiInstall skill opencode-server-api di 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-apiInstall skill opencode-server-api di 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
Pengecekan otomatis
Berjalan 16 Nov 2026Laporan lengkap →Lolos cek otomatis kami. Ini bukan audit keamanan: baca skripnya sebelum membiarkan agent menjalankannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkaukevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api is public and reachablegithub.com/kevinlin/cowork-z/tree/HEAD/src-tauri/resources/s ↗Lolos
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit 2026-10-30github.com/kevinlin/cowork-z/commits ↗Lolos
- Skrip tanpa unduh-lalu-jalankan atau pencurian kredensialNo scripts in the skill folderLolos
- Tidak ada instruksi tersembunyi di SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Lolos
- Tool yang diizinkan otomatis dibatasiNo pre-approved tools; the agent asks before using onegithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Lolos
- SKILL.md mengikuti format Agent SkillsValid name and description; says when to use it; 91 linesgithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Lolos
SKILL.md
Lihat di 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.
Berkas dalam skill ini
1Pertanyaan seputar skill opencode-server-api
Bagaimana cara install skill opencode-server-api di Claude Code?
Jalankan npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.claude/skills/opencode-server-api. Claude Code memuat skill dari ~/.claude/skills (semua proyek) atau .claude/skills (satu proyek) dan menggunakan skill saat deskripsinya cocok dengan tugas.
Client mana saja yang bisa menggunakan skill opencode-server-api?
Client apa pun yang membaca format Agent Skills: Claude Code, Codex, Gemini CLI, dan claude.ai (unggah sebagai ZIP). Script dalam skill hanya berjalan di client yang mengizinkan eksekusi kode.
Bagaimana cara memeriksa kesehatan OpenCode server?
Anda dapat menggunakan endpoint /api/info untuk mendapatkan versi server, PID, dan URL, yang berfungsi sebagai health check.
Bagaimana cara mengakses daftar todo saya melalui API?
Tidak ada route khusus untuk todo; sebagai gantinya, Anda harus membaca riwayat pesan secara descending, temukan item tool 'todowrite' pertama, dan ekstrak field 'state.input.todos'.
Apa yang harus saya lakukan sebelum memanggil endpoint API apa pun?
Anda harus selalu mengambil live OpenAPI spec terlebih dahulu untuk memastikan Anda memiliki route, parameter, dan bentuk response yang benar.