> ## Documentation Index
> Fetch the complete documentation index at: https://docs.screenpipe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCode - terminal AI with screen memory

> Integrate Screenpipe with OpenCode to give your terminal AI assistant access to your screen history, audio transcriptions, and app context.

[OpenCode](https://github.com/opencode-ai/opencode) is a powerful terminal-based AI coding assistant written in Go. It implements the [Agent Skills](https://opencode.ai/docs/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

```bash theme={"system"}
# copy to current project
mkdir -p .opencode/skills
cp -r /path/to/screenpipe/.claude/agents/* .opencode/skills/
```

### Option 2: user-level (global)

```bash theme={"system"}
# copy to home directory for all projects
mkdir -p ~/.opencode/skills
cp -r /path/to/screenpipe/.claude/agents/* ~/.opencode/skills/
```

### Option 3: clone directly

```bash theme={"system"}
# clone screenpipe and symlink skills
git clone https://github.com/screenpipe/screenpipe ~/screenpipe
ln -s ~/screenpipe/.claude/agents ~/.opencode/skills/screenpipe
```

<Note>
  OpenCode uses the same Agent Skills format as Claude Code. Files in `.claude/agents/` work in `.opencode/skills/` and vice versa.
</Note>

## Available skills

| Skill | Description |
| - | - |
| `screenpipe-query` | Search accessibility-first screen text, audio transcriptions, and UI events (keyboard input, clicks, app switches, clipboard) |
| `screenpipe-health` | Check status, diagnose issues, verify permissions |
| `screenpipe-logs` | Retrieve and analyze Screenpipe logs |

## Usage

OpenCode automatically discovers installed skills. Invoke them in your prompts:

```bash theme={"system"}
# 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:

```bash theme={"system"}
> 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:

```bash theme={"system"}
# add to your opencode config
opencode config mcp add screenpipe "npx -y screenpipe-mcp"
```

<Tip>
  Skills are more token-efficient than MCP. The OpenCode team recommends skills for most use cases, with MCP for external API integrations.
</Tip>

## 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:

```markdown theme={"system"}
---
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

Still stuck? [ask in our Discord](https://discord.gg/screenpipe).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.