screenpipe-chats

Search and send messages to existing screenpipe, Codex, Claude, Cursor, and Gemini CLI chats.

21.3k|2.2k|Updated Jun 19, 2024
One-click install
npx skills add https://github.com/screenpipe/screenpipe --skill screenpipe-chats
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: screenpipe-chats
Source: https://github.com/screenpipe/screenpipe/tree/main/crates/screenpipe-core/assets/skills/screenpipe-chats
Command: npx skills add https://github.com/screenpipe/screenpipe --skill screenpipe-chats

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When you work across multiple AI agents, conversations get scattered and hard to find. This Skill lets you search what was said in existing screenpipe, Codex, Claude, Cursor, and Gemini CLI chats, then continue or steer one exact chat when you explicitly ask.

Core Features & Use Cases

  • Cross-runtime chat search: Find conversations by title, message content, workspace, or exact id across screenpipe, Codex, Claude, Cursor, and Gemini CLI using the search_chats tool.
  • Targeted message sending: Send a message to one exact chat with send_to_chat, using queue mode by default or steer mode to redirect a currently running screenpipe chat.
  • Safety guardrails: Requires explicit user authorization before sending, refuses self-sends, guessed ids, and unconfirmed sends, and treats Gemini CLI chats as search-only.
  • Use Case: You remember discussing a database schema with Claude last week but forgot the details. Search your chats for the phrase, find the exact conversation, then send a follow-up message to continue that thread.

Quick Start

Search my existing agent chats for the conversation where we discussed the database migration plan.

Frequently Asked Questions about screenpipe-chats

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search my previous Claude or Codex chat conversations?

Use the search_chats tool with a short title, message phrase, workspace, or exact id. The query matches the transcript content, so a phrase said mid-conversation finds the chat even when the title never mentions it.

How do I send a message to an existing agent chat?

First run search_chats to get an exact result, then get explicit user authorization for that target and message. Call send_to_chat with the exact source, id, message, and confirmed set to true, using queue mode by default.

Can I send messages to Gemini CLI chats?

No, Gemini CLI chats are search-only because Gemini has no non-interactive resume. The send_to_chat tool rejects them instead of opening an interactive session, so you can only read and summarize what those chats contain.

What is the difference between queue and steer mode when sending to a chat?

Queue mode is the default and delivers the message normally to the target chat. Steer mode redirects a currently running screenpipe chat and should only be used when the user explicitly asks to redirect an active conversation.

Why did my chat search not find an older conversation?

Transcript reading is bounded to the most recent chats per runtime, so older chats are not searched. Check the warnings array in the search results, which reports when older chats were excluded rather than claiming a phrase was never said.