opencode-server-api skill
✓ DoğrulandıOpenCode 2.x sunucusuna yönelik salt okunur sorgular gerçekleştirerek oturumları, mesaj geçmişini, MCP durumunu, yetenekleri ve ajanları inceleyin.
- GitHub yıldızları
- 13
- Dosyalar
- 1
- Son commit
- 30 Eki 2026
- Lisans
- MIT
- İzin verilen araçlar
- —
opencode-server-api skill ne işe yarar?
OpenCode 2.x sunucusuna yönelik salt okunur sorgular gerçekleştirerek oturumları, mesaj geçmişini, MCP durumunu, yetenekleri ve ajanları inceleyin.
Özet, skill'in SKILL.md dosyasından oluşturuldu.
opencode-server-api skilli hakkında
Bu yetenek, geliştiricilerin ve yapay zeka ajanlarının OpenCode 2.x sunucu durumunu ve geçmişini incelemesine olanak tanır. Sunucu bilgilerini, aktif oturumları, mesaj geçmişlerini ve bağlı MCP sunucularının durumunu sorgulamak için salt okunur bir arayüz sağlar. Bir ajan; kullanıcı mevcut oturumu, mevcut yetenekleri, bağlı araçları veya bekleyen izin isteklerini sorduğunda bu aracı yüklemelidir.
Kullanıcılar, OPENCODE_SERVER_PASSWORD ortam değişkeninde saklanan bir şifre ile HTTP temel kimlik doğrulaması kullanarak GET istekleri aracılığıyla sunucuyla etkileşime girerler. Bu yetenek, tüm rota ve parametre çağrılarının doğru olduğundan emin olmak için sunucudan canlı bir OpenAPI spesifikasyonu çekilmesine dayanır. Mesaj geçmişindeki en son todowrite araç çağrısından gelen girdiyi ayrıştırarak oturum sonuçları, mesaj türleri ve hatta bir yapılacaklar listesi gibi belirli ayrıntıları getirebilir. Tamamen salt okunur işlemlerle sınırlıdır; sunucu durumunu değiştirmek, formları yanıtlamak veya ham yapılandırma dosyalarına erişmek için kullanılamaz.
Bir agent bununla neler yapabilir
- 1Aktif yapılacaklar listelerini getirmeEn son todowrite araç çağrısını inceleyerek bekleyen görevlerin güncel listesini bulun.
Skill'in SKILL.md dosyasından yazılmıştır. Her kullanım durumu oradaki bir alıntı ile kontrol edilir.
opencode-server-api skill nasıl kurulur
Her komut, skill klasörünü istemcinin skills dizinine kopyalar. Yüklemek için istemciyi yeniden başlatın veya yeni bir oturum başlatın.opencode-server-api skill'ini Claude Code uygulamasına kur
~/.claude/skills/opencode-server-api/SKILL.md
$ npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.claude/skills/opencode-server-apiopencode-server-api skill'ini Claude Code (project) uygulamasına kur
.claude/skills/opencode-server-api/SKILL.md
$ npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api .claude/skills/opencode-server-apiopencode-server-api skill'ini Codex uygulamasına kur
~/.agents/skills/opencode-server-api/SKILL.md
$ npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.agents/skills/opencode-server-apiopencode-server-api skill'ini Gemini CLI uygulamasına kur
~/.gemini/skills/opencode-server-api/SKILL.md
$ npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.gemini/skills/opencode-server-apiopencode-server-api skill'ini Claude.ai uygulamasına kur
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
Otomatik kontroller
Çalıştırıldı 16 Kas 2026Tam rapor →Otomatik kontrollerimizi geçti. Bu bir güvenlik denetimi değil: bir ajanın çalıştırmasına izin vermeden önce betikleri okuyun. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirkevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api is public and reachablegithub.com/kevinlin/cowork-z/tree/HEAD/src-tauri/resources/s ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit 2026-10-30github.com/kevinlin/cowork-z/commits ↗Geçti
- Betiklerde indir-çalıştır veya kimlik bilgisi hırsızlığı yokNo scripts in the skill folderGeçti
- SKILL.md içinde gizli talimat yokNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Geçti
- Önceden izin verilen araçlar sınırlıNo pre-approved tools; the agent asks before using onegithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Geçti
- SKILL.md, Agent Skills biçimine uyuyorValid name and description; says when to use it; 91 linesgithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Geçti
SKILL.md
GitHub'da görüntüleOpenCode 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.
Bu becerideki dosyalar
1opencode-server-api skill soruları
opencode-server-api skill'ini Claude Code uygulamasına nasıl kurarım?
npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.claude/skills/opencode-server-api komutunu çalıştırın. Claude Code, skill'leri ~/.claude/skills (tüm projeler) veya .claude/skills (tek proje) konumundan yükler ve açıklaması görevle eşleştiğinde skill'i kullanır.
opencode-server-api skill'ini hangi istemciler kullanabilir?
Agent Skills biçimini okuyan her istemci: Claude Code, Codex, Gemini CLI ve claude.ai (ZIP olarak yükleyin). Skill içindeki betikler yalnızca istemcinin kod çalıştırmaya izin verdiği yerlerde çalışır.
OpenCode sunucusunun sağlığını nasıl kontrol edebilirim?
Sunucu sürümünü, PID değerini ve URL'leri almak için /api/info uç noktasını kullanabilirsiniz; bu işlem bir sağlık kontrolü görevi görür.
API aracılığıyla yapılacaklar listeme (todo list) nasıl erişebilirim?
Özel bir todo rotası bulunmamaktadır; bunun yerine mesaj geçmişini azalan sırada okumalı, ilk 'todowrite' araç öğesini bulmalı ve 'state.input.todos' alanını ayıklamalısınız.
Herhangi bir API uç noktasını çağırmadan önce ne yapmalıyım?
Doğru rotalara, parametrelere ve yanıt yapılarına sahip olduğunuzdan emin olmak için her zaman önce canlı OpenAPI spesifikasyonunu çekmelisiniz.