| name | opencode |
| description | Manage OpenCode configuration, credentials, and OpenCode Zen API access to list available models and navigate XDG-compliant directory structures. You MUST load this skill when working with OpenCode configuration or listing models. |
| license | MIT |
opencode Skill
OpenCode uses XDG base directories for configuration and data. Access the OpenCode Zen API to list available models.
When to Use
- To locate or modify OpenCode's internal configurations, credentials, and state.
- When needing to verify the current set of supported AI models via the Zen API.
- If an agent needs to programmatically inject configurations directly into the OpenCode XDG base directories.
When Not to Use
- When debugging general code issues in a repository completely unrelated to OpenCode's own configuration.
- For interacting with standard GitHub Copilot CLI configurations (
~/.copilot).
- When executing standard
git or bash commands.
Common Pitfalls
- Hardcoding
~/.opencode: Assuming OpenCode uses a single dotfolder in the user's home directory instead of correctly utilizing XDG directories (like ~/.config/opencode).
- Ignoring API Updates: Hardcoding the list of supported models in a script instead of dynamically querying
https://opencode.ai/zen/v1/models.
- Committing Auth Data: Accidentally backing up
~/.local/share/opencode/auth.json into a public repository.
OpenCode Zen API
List available models via the OpenCode Zen API:
https://opencode.ai/zen/v1/models
Directory Structure
OpenCode uses XDG base directories instead of a single ~/.opencode directory:
| Directory | Purpose |
|---|
~/.local/share/opencode | Data and auth credentials (auth.json lives here) |
~/.config/opencode | User configuration (opencode.json/opencode.jsonc) |
~/.cache/opencode | Ephemeral binary cache - not worth persisting |
~/.local/state/opencode | Runtime state - not worth persisting |
Core Principles
- XDG Compliance: Always respect XDG base directory environment variables (
XDG_CONFIG_HOME, XDG_DATA_HOME, etc.) when locating OpenCode files.
- API First: Use the OpenCode Zen API for the most up-to-date model information.
Commands / Usage Patterns
Listing Models
To list models using curl (if available):
curl https://opencode.ai/zen/v1/models
Related Skills
- gh: OpenCode integrates with GitHub CLI for many operations.
