opencode

titonio's avatarfrom titonio

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.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 31, 2025
[Developer Tools]

When & Why to Use This Skill

This Claude skill provides comprehensive expertise for OpenCode, an open-source AI coding agent. It empowers developers to integrate with the OpenCode HTTP server, manage automated coding sessions, and build custom client applications or IDE extensions using its robust OpenAPI specification and RESTful API.

Use Cases

  • Custom Client Development: Building bespoke desktop, web, or CLI-based interfaces that communicate with the OpenCode server to provide tailored AI coding experiences.
  • Workflow Automation: Creating scripts (e.g., Python) to automate session management, file reading, and messaging loops for large-scale code refactoring or documentation tasks.
  • Tool Integration: Seamlessly integrating OpenCode's AI capabilities into existing developer environments, CI/CD pipelines, or project management dashboards via its standardized API endpoints.
nameopencode
descriptionExpertise 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/message with 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.