tomevault-io 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
opencodewithout 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
-por--promptflag ifrunis not applicable in your specific version, butopencode runis 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
-cor--cwdflag:opencode run "prompt" --cwd /path/to/dir
Command Reference
| Action | Command Pattern |
|---|---|
| Run Prompt | opencode run "Your instruction here" |
| Check Version | opencode --version |
| List Models | opencode models |
| Auth Status | opencode auth list |
| Set Directory | opencode run "..." --cwd ./subdir |
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."
---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/radema) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->