Навык opencode-server-api
✓ ПровереноВыполняйте запросы только для чтения к серверу OpenCode 2.x, чтобы проверять сессии, историю сообщений, статус MCP, навыки и агентов.
- Звёзды на GitHub
- 13
- Файлы
- 1
- Последний коммит
- 30 окт. 2026 г.
- Лицензия
- MIT
- Разрешённые инструменты
- —
Что делает навык opencode-server-api?
Выполняйте запросы только для чтения к серверу OpenCode 2.x, чтобы проверять сессии, историю сообщений, статус MCP, навыки и агентов.
Сводка сгенерирована из SKILL.md навыка.
О skill opencode-server-api
Этот навык позволяет разработчикам и ИИ-агентам проверять состояние и историю вашего сервера OpenCode 2.x. Он предоставляет интерфейс только для чтения для запроса информации о сервере, активных сессиях, истории сообщений и статусе подключенных MCP серверов. Агенту следует загрузить этот инструмент, если пользователь спрашивает о текущей сессии, доступных навыках, подключенных инструментах или ожидающих запросах на разрешение.
Пользователи взаимодействуют с сервером через GET-запросы с использованием HTTP basic authentication и паролем, хранящимся в переменной окружения OPENCODE_SERVER_PASSWORD. Работа навыка основана на получении актуальной спецификации OpenAPI с сервера, что гарантирует точность всех вызовов маршрутов и параметров. Он может извлекать такие специфические данные, как результаты сессий, типы сообщений и даже список дел, анализируя входные данные последнего вызова инструмента todowrite в истории сообщений. Инструмент строго ограничен операциями только для чтения и не может использоваться для изменения состояния сервера, заполнения форм или доступа к исходным конфигурационным файлам.
Что агент может делать с ним
- 1Получение активных списков делНайдите текущий список незавершенных задач, проанализировав последний вызов инструмента todowrite.
Написано на основе skill SKILL.md. Каждый сценарий использования проверен по цитате из него.
Как установить навык opencode-server-api
Каждая команда копирует папку навыка в каталог навыков клиента. Перезапустите клиент или начните новую сессию, чтобы загрузить его.Установка навыка opencode-server-api в 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-apiУстановка навыка opencode-server-api в 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-apiУстановка навыка opencode-server-api в Codex
~/.agents/skills/opencode-server-api/SKILL.md
$ npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.agents/skills/opencode-server-apiУстановка навыка opencode-server-api в 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-apiУстановка навыка opencode-server-api в 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
Автоматические проверки
Запущено 16 нояб. 2026 г.Полный отчёт →Прошёл наши автоматические проверки. Это не аудит безопасности: прочитайте скрипты, прежде чем агент их запустит. Как работают проверки
- Связанный и доступный исходный репозиторийkevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api is public and reachablegithub.com/kevinlin/cowork-z/tree/HEAD/src-tauri/resources/s ↗Пройдено
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit 2026-10-30github.com/kevinlin/cowork-z/commits ↗Пройдено
- В скриптах нет загрузки с запуском и кражи учётных данныхNo scripts in the skill folderПройдено
- В SKILL.md нет скрытых инструкцийNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Пройдено
- Заранее разрешённые инструменты ограниченыNo pre-approved tools; the agent asks before using onegithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Пройдено
- SKILL.md соответствует формату Agent SkillsValid name and description; says when to use it; 91 linesgithub.com/kevinlin/cowork-z/blob/HEAD/src-tauri/resources/s ↗Пройдено
SKILL.md
Открыть на 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.
Файлы в этом навыке
1Вопросы о навыке opencode-server-api
Как установить навык opencode-server-api в Claude Code?
Выполните npx degit kevinlin/cowork-z/src-tauri/resources/skills/opencode-server-api ~/.claude/skills/opencode-server-api. Claude Code загружает навыки из ~/.claude/skills (все проекты) или .claude/skills (один проект) и использует навык, когда его описание соответствует задаче.
Какие клиенты могут использовать навык opencode-server-api?
Любой клиент, который читает формат Agent Skills: Claude Code, Codex, Gemini CLI и claude.ai (загрузить как ZIP). Скрипты в навыке выполняются только там, где клиент разрешает выполнение кода.
Как проверить состояние сервера OpenCode?
Вы можете использовать эндпоинт /api/info, чтобы получить версию сервера, PID и URL-адреса, что служит проверкой работоспособности.
Как получить доступ к моему списку дел через API?
Отдельного маршрута для todo нет; вместо этого вам нужно прочитать историю сообщений в обратном порядке, найти первый элемент инструмента todowrite и извлечь поле state.input.todos.
Что нужно сделать перед вызовом любого эндпоинта API?
Перед началом работы всегда следует загрузить актуальную спецификацию OpenAPI, чтобы убедиться в правильности маршрутов, параметров и структуры ответов.