thread-manager

Manage conversation threads with SQLite persistence, Git integration, and semantic search.

420|63|Updated Nov 7, 2025
One-click install
npx skills add https://github.com/peterfei/ai-agent-team --skill thread-manager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: thread-manager
Source: https://github.com/peterfei/ai-agent-team/tree/main/.claude/skills/thread-manager
Command: npx skills add https://github.com/peterfei/ai-agent-team --skill thread-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires chalk, commander, sqlite3.

What problem does it solve?

Managing multiple, ongoing conversations with an AI can be challenging, leading to lost context or fragmented information. This skill provides robust tools to create, switch, list, update, and delete AI conversation threads, ensuring persistent context and traceability.

Core Features & Use Cases

  • Thread Lifecycle Management: Easily create new threads for different projects or topics, switch between them, and delete old ones.
  • Context Persistence: Automatically tracks file changes and messages within the current thread, maintaining a complete conversation history.
  • Git Integration: Records file modifications and Git status, linking AI interactions directly to development workflows.
  • Use Case: A developer is working on two separate features. They can create a thread for "Feature A" and another for "Feature B", switching between them as needed. All AI interactions, code changes, and discussions related to Feature A are stored in its dedicated thread, preventing context overlap.

Quick Start

Create a new thread named 'project-alpha-feature-x'.

Frequently Asked Questions about thread-manager

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

FAQPage Schema
How do I manage multiple AI conversation threads to keep context separate?

Thread-manager lets you create isolated conversation threads for different projects or tasks, each with its own message history and file tracking. Switch between threads to maintain separate contexts and prevent information overlap across different work streams.

Can I track file changes and git status within conversation threads?

Yes. Thread-manager automatically records file modifications and git status in each thread, linking your code changes directly to AI interactions. This creates a complete audit trail connecting development work to conversation history.

How do I search through messages across multiple threads?

Thread-manager supports embedding-based semantic search to find relevant messages across your threads. Query by meaning rather than exact keywords to retrieve conversations related to specific topics or decisions.

What's the best way to persist conversation history locally?

Thread-manager uses SQLite for local persistence, storing all threads, messages, and metadata on your machine. This ensures your conversation history remains accessible offline and under your control without external dependencies.

Can I automate thread operations in my AI assistant workflow?

Thread-manager exposes MCP tools (create_thread, switch_thread, add_message, track_file_change, and others) that integrate directly into Claude Code workflows, enabling programmatic thread management alongside your development tasks.

Do I need developer tools knowledge to set up thread management?

Thread-manager requires basic familiarity with command-line tools and git workflows, but the CLI interface keeps setup straightforward. It's designed for developers already working with context management and version control.