Agent skill
zed-threads
Read and inspect Zed AI conversation threads stored in the local SQLite database. Use when the user asks to "show Zed threads", "read my Zed AI conversations", "inspect Zed chat history", "dump Zed thread", or wants to examine past Zed AI interactions.
Install this agent skill to your Project
npx add-skill https://github.com/akaihola/skills-akaihola/tree/main/zed-threads
SKILL.md
Zed Threads Reader
Read AI conversation threads from Zed's local SQLite database and display them as human-readable YAML.
Database location
~/.local/share/zed/threads/threads.db
Quick usage
# Show the most recent thread (index 0)
uv run ~/prg/skills-akaihola/zed-threads/scripts/read_zed_threads.py
# Show thread at a specific index (0 = most recent, 1 = second most recent, …)
uv run ~/prg/skills-akaihola/zed-threads/scripts/read_zed_threads.py 5
# Disable syntax highlighting (useful when piping to a file)
uv run ~/prg/skills-akaihola/zed-threads/scripts/read_zed_threads.py --no-color
# Combine: third thread without colour
uv run ~/prg/skills-akaihola/zed-threads/scripts/read_zed_threads.py 2 --no-color
The script prints the number of threads found and the number successfully parsed to stderr, so you can see the thread count without it mixing into the YAML output.
Output format
Each thread is rendered as YAML with the following structure:
messages:
- User: "user message text"
- Agent: "assistant reply text"
- Thinking: "chain-of-thought reasoning (if present)"
- Tool:
name: read_file
input: { path: "/some/file" }
result: "file contents..."
Mentions (file references, rules) are expanded inline:
- User: |
@/path/to/file.py
```py
<file contents>
```
Can you review this?
Thread indexing
Threads are ordered by updated_at DESC, so index 0 is always the most recently
updated thread.
Requirements
uvin PATH (handles all Python dependencies via PEP 723 inline metadata)- Zed installed with at least one AI conversation recorded
- Dependencies (auto-managed):
ruamel.yaml,zstandard,pygments,pydantic
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
youtube-to-markdown
Convert a YouTube video into clean, readable Markdown using its free auto-generated captions (no paid API needed). Use when the user asks to "convert YouTube video to markdown", "get transcript from YouTube URL", "summarise this video", or wants to turn YouTube subtitles/captions into readable text. Prefer this over youtube-transcription when the video already has auto-generated subtitles — it's free and faster. Accepts YouTube URLs.
brave-search
Search the web using Brave Search API. Use when the user asks to "search the web", "look up current information", "find news about", "research a topic online", "check prices online", or needs up-to-date facts that may not be in the model's training data. Requires BRAVE_SEARCH_API_KEY. Supports structured web results (pages, FAQs, news, videos) and an optional AI summarizer.
verkkokauppa
Search products on the Verkkokauppa.com Finnish webshop. This skill uses the Verkkokauppa search API directly, requiring no browser. Use when the user asks to "search Verkkokauppa", "find products on verkkokauppa.com", "verkkokauppa product search", "check Verkkokauppa prices", or mentions searching the Verkkokauppa store.
clasohlson
Search products on the Clas Ohlson Finland webshop (clasohlson.com/fi/). This skill uses the Voyado Elevate (Apptus eSales) search API directly, requiring no browser. Use when the user asks to "search Clas Ohlson", "find products on clasohlson.com", "clas ohlson product search", "check Clas Ohlson prices", or mentions searching the Finnish Clas Ohlson store.
bauhaus
Search products on the Bauhaus webshop (bauhaus.fi). This skill uses the Algolia search API with automatic key refresh. Use when the user asks to "search Bauhaus", "find products on bauhaus.fi", "bauhaus product search", "check Bauhaus prices", or mentions searching the Bauhaus store.
library
Didn't find tool you were looking for?