opencode

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.