Agent skill

Opencode

by taracodlabs in taracodlabs/aiden

Delegate coding to OpenCode CLI (multi-LLM open-source coding agent)

Apache-2.0Auto-check: notesAI & LLM Engineering

Install Opencode

skills CLI
$ npx skills add taracodlabs/aiden --skill opencode -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install taracodlabs/aiden opencode --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/opencode .claude/skills/opencode && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
opencode
GitHub stars
849
Token cost
~917 tokens
SKILL.md length
279 words
Files
2
Skills in repo
63
Repo updated
First seen
Licence
Apache-2.0

At a glance

Delegate coding to OpenCode CLI (multi-LLM open-source coding agent)

  • Works in 7 steps: Install OpenCode → Configure providers → Run an interactive coding session → …
  • Tasks that involve LLM inference and serving
  • SKILL.md covers When to Use, How to Use, Examples and Cautions
  • Calls opencode, npm and ollama; reaches opencode.ai; needs ANTHROPIC_API_KEY and OPENAI_API_KEY

What it does

Opencode is an agent skill from taracodlabs/aiden. Delegate coding to OpenCode CLI (multi-LLM open-source coding agent)

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `skill.json`).

It sits in AI & LLM Engineering, covering LLM inference and serving. It works with Ollama and OpenAI. The repository describes itself as: Aiden — an autonomous AI agent and work engine built solo. It can operate your browser, terminal, files, apps, APIs, skills and tools, remember context, recover from failures… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve LLM inference and serving

Example prompts

  • “/opencode”

Requirements

  • Python 3
  • Node.js
  • A credential in ANTHROPIC_API_KEY
  • A credential in OPENAI_API_KEY

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Install OpenCode
  2. Configure providers
  3. Run an interactive coding session
  4. Run a specific task non-interactively
  5. Use local Ollama model (no cloud API costs)
  6. Run on a specific file
  7. Generate a new file

What it can do on your machine

Read from SKILL.md and the folder at commit 3704204. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • opencode
    • npm
    • ollama

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • opencode.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ANTHROPIC_API_KEY
    • OPENAI_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Opencode loads about 917 tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 279 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~19
When it runs · the whole SKILL.md, loaded when a task matches
~917

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePipes a well-known installer script into a shellSKILL.md:32
    Invoke-WebRequest -Uri "https://opencode.ai/install" -UseBasicParsing | Invoke-Expression

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from taracodlabs/aiden at commit 3704204, republished under its Apache-2.0 licence (© taracodlabs). 279 words, ~917 tokens.

Download SKILL.mdSave it as .claude/skills/opencode/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
opencode
description
Delegate coding to OpenCode CLI (multi-LLM open-source coding agent)
category
agent-bridge
version
1.0.0
origin
aiden
license
Apache-2.0
tags
opencode, ai-coding, agent-bridge, open-source, multi-model, coding, delegation, claude, gpt

OpenCode CLI Agent Bridge

Delegate coding tasks to OpenCode — an open-source AI coding CLI that supports multiple LLM providers (Anthropic, OpenAI, Gemini, local Ollama). Provides a terminal UI for interactive coding sessions.

When to Use

  • User wants an open-source, self-hostable AI coding agent
  • User wants to use local Ollama models for coding without cloud API costs
  • User wants to switch between multiple LLM providers for the same task
  • Task requires a coding agent with a built-in terminal UI
  • User wants to run coding sessions with custom model configurations

How to Use

1. Install OpenCode
powershell
# Install via npm
npm install -g opencode-ai

# Or install via the installer script
Invoke-WebRequest -Uri "https://opencode.ai/install" -UseBasicParsing | Invoke-Expression

# Verify
opencode --version
2. Configure providers

OpenCode reads from ~/.config/opencode/config.json:

powershell
$config = @{
  providers = @{
    anthropic = @{ apiKey = $env:ANTHROPIC_API_KEY }
    openai    = @{ apiKey = $env:OPENAI_API_KEY }
    ollama    = @{ baseUrl = "http://localhost:11434" }
  }
  model = "anthropic/claude-opus-4-5"
} | ConvertTo-Json -Depth 5

$configDir = "$env:USERPROFILE\.config\opencode"
New-Item -ItemType Directory -Force -Path $configDir | Out-Null
Set-Content -Path "$configDir\config.json" -Value $config
3. Run an interactive coding session
powershell
Set-Location "C:\Users\<you>\myproject"
opencode
# Opens terminal UI — type your task in the prompt
4. Run a specific task non-interactively
powershell
# Run task without TUI
opencode run "Add pagination to the GET /users endpoint"

# Run with a specific model
opencode run --model "openai/gpt-4o" "Refactor the auth middleware to handle OAuth2"
5. Use local Ollama model (no cloud API costs)
powershell
# Ensure Ollama is running with a code-capable model
# ollama pull qwen2.5-coder:7b

opencode run --model "ollama/qwen2.5-coder:7b" "Write a Python script to parse CSV files"
6. Run on a specific file
powershell
opencode run "Review and fix the error handling in" src/api/payments.ts
7. Generate a new file
powershell
opencode run "Create a new TypeScript module at src/cache/redis.ts that wraps ioredis with:
- connect(), disconnect() methods
- get(key), set(key, value, ttlSeconds) methods
- Proper error handling and type safety"

Examples

"Use the local Qwen model to add tests to my utility functions" → Use step 5 with --model "ollama/qwen2.5-coder:7b" and ask it to generate tests for your utils file.

"Run an interactive coding session on my project" → Use step 3 — navigate to the project first, then run opencode to open the TUI.

"Refactor this module but use GPT-4o instead of Claude" → Use step 4 with --model "openai/gpt-4o".

Cautions

  • OpenCode requires at least one provider configured with a valid API key (or Ollama running locally)
  • The TUI mode (step 3) requires a terminal that supports ANSI escape codes — works in Windows Terminal
  • Local models via Ollama are free but slower and less capable than cloud models for complex refactoring
  • OpenCode may request file system access — review the project scope before running on sensitive codebases
  • Check https://opencode.ai for the latest install instructions as the project is actively developed

© taracodlabs, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/opencode of taracodlabs/aiden.

  • SKILL.md
  • skill.json

Open the folder on GitHubat commit 3704204

Compare with similar skills

Opencode next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Opencode compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Opencode this skilltaracodlabs/aiden849—~917Automated safety check: NotesApache-2.0
Aider DelegateamElnagdy/delegate-skills2.3k2 repos~3kAutomated safety check: PassMIT
Perfupraullenchai/Rapid-MLX3.9k—~1.6kAutomated safety check: NotesCustom licence
Ideer Daily Paper ChatbotAI45Lab/iDeer416—~3kAutomated safety check: NotesAGPL-3.0
Agent Frameworkjihadkhawaja/Egroo178—~1.9kAutomated safety check: PassApache-2.0
Tanstack AIsecondsky/claude-skills2271 repos~3.6kAutomated safety check: NotesMIT

Similar skills

  • Aider Delegate

    amElnagdy/delegate-skills

    Delegate a coding task to Aider (aider) as a background implementer, then review its diff and land it yourself.

    2.3k GitHub starsUsed in 2 repos~3k tokens
    AI & LLM EngineeringAuto-check passed
  • Perfup

    raullenchai/Rapid-MLX

    Autonomous performance optimization: research, PoC, benchmark, implement, review, PR

    3.9k GitHub stars~1.6k tokensUpdated today
    AI & LLM EngineeringAuto-check: notes
  • Use iDeer as a daily paper-reading workflow for chatbot-first users such as Codex, Gemini, or ChatGPT.

    416 GitHub stars~3k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check: notes
  • Agent Framework

    jihadkhawaja/Egroo

    Build, extend, and debug AI agents in Egroo using the Microsoft Agent Framework (C .NET).

    178 GitHub stars~1.9k tokensUpdated 6 mo ago
    AI & LLM EngineeringAuto-check passed
  • Tanstack AI

    secondsky/claude-skills

    TanStack AI (alpha) provider-agnostic type-safe chat with streaming for OpenAI, Anthropic, Gemini, Ollama.

    227 GitHub starsUsed in 1 repo~3.6k tokens
    AI & LLM EngineeringAuto-check: notes
  • Configuring Vision

    oxbshw/watch-skill

    The user wants to connect an LLM or vision provider, already has an API key, asks "can I use OpenAI/Anthropic/Gemini/OpenRouter", wants local Ollama, or needs different cheap and strong models.

    452 GitHub stars~509 tokensUpdated 22 days ago
    AI & LLM EngineeringAuto-check: notes

More from taracodlabs/aiden

All 63 skills in this repo
  • Google Flights Search

    taracodlabs/aiden

    Searches Google Flights for prices, schedules and availability through browser automation with URL-based queries, and stops short of booking.

    849 GitHub stars~1.5k tokensUpdated 24 days ago
    Auto-check passed
  • OpenAI Codex CLI Bridge

    taracodlabs/aiden

    Delegates code generation, editing and explanation tasks to the OpenAI Codex CLI, with commands for interactive, auto-edit, question-only and model-specific runs.

    849 GitHub starsUsed in 1 repo~826 tokens
    Auto-check passed
  • Google Hotels Search

    taracodlabs/aiden

    Searches Google Hotels through the agent-browser tool for prices, ratings, amenities and availability, building a search URL from the location and dates and reporting a results table.

    849 GitHub stars~1.5k tokensUpdated 24 days ago
    Auto-check passed
  • Generates dark-themed architecture, component, data-flow and network diagrams as self-contained HTML and SVG files that open in any browser.

    849 GitHub stars~1.3k tokensUpdated 24 days ago
    Auto-check passed
  • Aggregates holdings across Zerodha, Upstox and Angel One and normalizes order parameters into one format, with confirmation required before any routing.

    849 GitHub stars~1.1k tokensUpdated 24 days ago
    Auto-check passed
  • arXiv Paper Search

    taracodlabs/aiden

    Searches arXiv by keyword, category, author or paper ID through its public API and downloads PDFs, with no API key needed.

    849 GitHub stars~1k tokensUpdated 24 days ago
    Auto-check passed

Works with

Questions about Opencode

What does Opencode do?

Delegate coding to OpenCode CLI (multi-LLM open-source coding agent). Opencode is an agent skill from taracodlabs/aiden.

When should I use Opencode?

Opencode fits situations like: tasks that involve LLM inference and serving.

How do I install Opencode in Claude Code?

Run `npx skills add taracodlabs/aiden --skill opencode -a claude-code`. Or copy the skill folder (skills/opencode in taracodlabs/aiden) into .claude/skills/opencode in your project. Claude Code loads it when a task matches its description.

How do I install Opencode in Codex?

Run `npx skills add taracodlabs/aiden --skill opencode -a codex`. Or copy the skill folder (skills/opencode in taracodlabs/aiden) into .agents/skills/opencode in your project. Codex loads it when a task matches its description.

Can I use Opencode in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add taracodlabs/aiden --skill opencode -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/opencode, .gemini/skills/opencode, .github/skills/opencode and .opencode/skills/opencode in your project.

What does Opencode need to run?

Going by SKILL.md and its folder, Opencode needs the command-line tools its instructions call (opencode, npm and ollama) and credentials named ANTHROPIC_API_KEY and OPENAI_API_KEY. Our summary lists: Python 3; Node.js; A credential in ANTHROPIC_API_KEY; A credential in OPENAI_API_KEY.

Does Opencode access the network?

SKILL.md names 1 domain. In commands or code: opencode.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Opencode safe to install?

Our automated static check of SKILL.md found notes only (pipes a well-known installer script into a shell), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Opencode use?

Opencode is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Opencode use?

About 917 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Opencode?

Skills that share tags, products or a category with Opencode: Aider Delegate (amElnagdy/delegate-skills, 2.3k stars), Perfup (raullenchai/Rapid-MLX, 3.9k stars), Ideer Daily Paper Chatbot (AI45Lab/iDeer, 416 stars) and Agent Framework (jihadkhawaja/Egroo, 178 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Opencode?

taracodlabs (a GitHub organization) maintains it in taracodlabs/aiden, which has 849 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on September 13, 2026.

Source: taracodlabs/aiden on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.