Skip to main content
Get up and running with OpenCode Agents in under a minute. This guide walks you through installing your first agent and using it in an OpenCode session.

​
Prerequisites

  • Node.js 20 or higher — the CLI requires Node.js 20+
  • OpenCode installed and configured (opencode.ai)

​
Install your first agent

The fastest way to get started is the interactive TUI browser. It auto-launches when you run the CLI:
1

Launch the TUI

Run the CLI without arguments:
npx github:dmicheneau/opencode-template-agent
The TUI will detect your terminal and launch automatically.
2

Browse and select agents

  • Navigate categories with ← → or Tab
  • Move through agents with ↑ ↓
  • Press Space to select agents
  • Press Enter to install selected agents
  • Press / to search
3

Confirm installation

Review your selections and confirm. Agents will be installed to .opencode/agents/ in your project directory.

​
Or install via CLI

If you prefer the command line, install a single agent directly: 
npx github:dmicheneau/opencode-template-agent install typescript-pro
Agent files are installed to .opencode/agents/ in your current directory. If you don’t have a .opencode/ folder yet, the installer will guide you through setup.

​
Use your agent in OpenCode

Once installed, invoke the agent in any OpenCode session: 
opencode
Then type: 
/agent typescript-pro
The agent is now active and will guide the conversation with its specialized expertise.

​
Install a pack

Packs are curated collections of agents for common workflows. Install an entire stack in one command: 
npx github:dmicheneau/opencode-template-agent install --pack backend
See all available packs: 
npx github:dmicheneau/opencode-template-agent list --packs

​
Next steps

Installation Methods

Explore all 3 installation modes: TUI, CLI, and bash script

Agent Catalog

Browse all 69 agents across 10 categories

Packs

Discover 15 predefined packs for common workflows

OpenCode Plugin

Install the OpenCode plugin for LLM-powered agent discovery

​
Common commands

npx github:dmicheneau/opencode-template-agent list
Agents are grouped by category with descriptions.
npx github:dmicheneau/opencode-template-agent search docker
Search by name, description, or tags.
npx github:dmicheneau/opencode-template-agent install --category devops
Install all agents in one or more categories:
npx github:dmicheneau/opencode-template-agent install --category languages,data-api

npx github:dmicheneau/opencode-template-agent install --all
Install the full registry of 69 agents.

Build docs developers (and LLMs) love

Get started for freeTalk to us