Opencode CLI Skill

Goal

This skill allows the agent to utilize the opencode command-line tool to perform coding tasks, query the Opencode agent, and manage configuration. It is specifically optimized for non-interactive usage to prevent the agent from getting stuck in Terminal UI (TUI) modes.

Usage Rules

1. Non-Interactive Execution (CRITICAL)

• •NEVER run the bare command opencode without arguments. This launches an interactive TUI that will hang the agent session.
• •ALWAYS use opencode run "<prompt>" for generation, questions, or coding tasks.
• •ALWAYS use the -p or --prompt flag if run is not applicable in your specific version, but opencode run is the standard for delegation.

2. Output Handling

• •The output from Opencode is standard text. Read the output to confirm the task was completed or to retrieve the generated code.
• •If the user asks for JSON output and the CLI supports it, append --output-format json.

3. Context & Directories

• •If the user specifies a working directory, use the -c or --cwd flag: opencode run "prompt" --cwd /path/to/dir

Command Reference

Examples

Example 1: Generative Task

User: "Use opencode to write a Python script that calculates Fibonacci numbers." Agent Execution:

opencode run "Write a Python script that calculates Fibonacci numbers and prints the first 10."