# Opencode CLI

> Interface with the Opencode CLI to execute AI-driven coding tasks, generate code snippets, and manage agent sessions non-interactively. Use this when the user asks to "ask Opencode" or "use Opencode" to perform a task. Use when this capability is needed.

- Skill: `tomevault-io/opencode-cli` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/opencode-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/opencode-cli/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/opencode-cli

---


# 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

| 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:**
```bash
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 -->