| name | opencode |
| description | Expertise for using OpenCode (an open-source AI coding agent) and building client applications that interact with the OpenCode HTTP server. Use this skill when the user asks about OpenCode features, how to use it, or how to build tools/clients that integrate with the OpenCode server API. |
OpenCode
Overview
OpenCode is an open source AI coding agent that runs in your terminal, IDE, or desktop. It provides a server mode that exposes an OpenAPI specification, allowing developers to build custom clients and integrations.
Using OpenCode
For general information about OpenCode features, privacy, and ecosystem, see references/overview.md.
Building Client Applications
To build a client application that interacts with OpenCode, you should communicate with the OpenCode HTTP server.
Quick Start
See scripts/simple_client.py for a complete Python example of connecting, creating a session, and sending a message.
Client Development Guide
For detailed patterns on session management, messaging loops, and event streaming, see references/client_guide.md.
Server Connection
The server typically runs on http://127.0.0.1:4096.
You can start it with opencode serve.
API Reference
For a complete list of available endpoints, see references/api.md.
The API covers:
- Sessions: Create, manage, and interact with coding sessions.
- Messages: Send prompts and receive responses.
- Files: Read and search files in the workspace.
- Projects: Manage projects.
- TUI Control: Control the Terminal UI programmatically.
Common Workflows
1. Connecting to a Session
To interact with an existing session or create a new one:
- List sessions:
GET /session - Create session:
POST /session
2. Sending a Message
To send a prompt to the agent:
POST /session/:id/messagewith the prompt content.
3. Reading Files
To read file content:
GET /file/content?path=<path>
Resources
scripts/
- simple_client.py: A Python script demonstrating basic client interactions (connect, create session, send message).
references/
- overview.md: General overview of OpenCode features and ecosystem.
- api.md: Detailed API reference for the OpenCode HTTP server.
- client_guide.md: Best practices and patterns for building OpenCode clients.