Skip to main content
OpenCode is a powerful terminal-based AI coding assistant written in Go. it implements the Agent Skills open standard, which means screenpipe skills work out of the box.

​
setup

OpenCode discovers skills from multiple locations. copy the screenpipe skills to any of these:

​
option 1: project-level

# copy to current project
mkdir -p .opencode/skills
cp -r /path/to/screenpipe/.claude/agents/* .opencode/skills/

​
option 2: user-level (global)

# copy to home directory for all projects
mkdir -p ~/.opencode/skills
cp -r /path/to/screenpipe/.claude/agents/* ~/.opencode/skills/

​
option 3: clone directly

# clone screenpipe and symlink skills
git clone https://github.com/mediar-ai/screenpipe ~/screenpipe
ln -s ~/screenpipe/.claude/agents ~/.opencode/skills/screenpipe
OpenCode uses the same Agent Skills format as Claude Code. files in .claude/agents/ work in .opencode/skills/ and vice versa.

​
available skills

skilldescription
screenpipe-querysearch screen OCR, audio transcriptions, UI elements
screenpipe-healthcheck status, diagnose issues, verify permissions
screenpipe-logsretrieve and analyze screenpipe logs

​
usage

OpenCode automatically discovers installed skills. invoke them in your prompts: 
# start OpenCode
opencode

> @screenpipe-query find what I was reading about docker compose

> @screenpipe-health check if recording is working

> @screenpipe-logs show me errors from today
or let OpenCode choose automatically: 
> what was I working on in VS Code this morning?
# OpenCode will invoke screenpipe-query

> is my screen recording working?
# OpenCode will invoke screenpipe-health

​
MCP alternative

OpenCode also supports MCP servers. if you prefer MCP over skills: 
# add to your opencode config
opencode config mcp add screenpipe "npx -y screenpipe-mcp"
skills are more token-efficient than MCP. the OpenCode team recommends skills for most use cases, with MCP for external API integrations.

​
example workflows

context-aware coding: 
> I was looking at a react component earlier that had a cool
> animation effect, use screenpipe to find it and help me
> implement something similar
recall documentation: 
> use screenpipe to find that kubernetes docs page I was
> reading about pod scheduling
meeting follow-up: 
> what did we discuss in the team call about the database
> migration? use screenpipe to find it
debug from memory: 
> there was an error in my terminal earlier, use screenpipe
> to find it and help me fix it

​
skill format reference

screenpipe skills follow the Agent Skills standard: 
---
name: screenpipe-query
description: Query screen recordings and audio transcriptions
tools:
  - Bash
  - WebFetch
---

# Screenpipe Query Agent

Instructions for querying screenpipe data...
you can customize these skills or create your own following the same format.

​
requirements

  • screenpipe running on localhost:3030
  • OpenCode installed (go install github.com/opencode-ai/opencode@latest)
  • skills copied to .opencode/skills/ or ~/.opencode/skills/

​
troubleshooting

skills not discovered?
  • run opencode skills list to see available skills
  • verify files are in correct location with valid yaml frontmatter
  • check skill file ends in .md
queries returning no data?
  • verify screenpipe is running: curl http://localhost:3030/health
  • check data exists: curl "http://localhost:3030/search?limit=1"
  • ensure screenpipe has screen recording permissions
OpenCode not using skills?
  • mention the skill explicitly: @screenpipe-query find...
  • check skill description matches your query intent