Skip to content

Add ty-qmd extension for QMD search integration#391

Open
bborn wants to merge 2 commits intomainfrom
task/1025-add-qmd-extensionsidecar
Open

Add ty-qmd extension for QMD search integration#391
bborn wants to merge 2 commits intomainfrom
task/1025-add-qmd-extensionsidecar

Conversation

@bborn
Copy link
Owner

@bborn bborn commented Feb 5, 2026

Summary

This PR introduces ty-qmd, a new extension that integrates QMD (an on-device semantic search engine by @tobi) with TaskYou. QMD combines BM25 full-text search, vector semantic search, and LLM re-ranking - all running locally.

What this enables:

  • Task history search - Completed tasks become searchable knowledge
  • Project documentation indexing - Index markdown, meeting notes, docs alongside tasks
  • MCP sidecar mode - Claude can query past work during task execution

Use case example:

Task: "Implement OAuth login"

Claude searches: "OAuth authentication implementation"
Finds: Task #42 "Add Google OAuth" - completed 2 weeks ago
Context: Used passport.js, stored tokens in Redis, added refresh logic

Commands

# Sync completed tasks to QMD
ty-qmd sync

# Search indexed content
ty-qmd search "authentication patterns"

# Run MCP server for Claude
ty-qmd serve

# Index project docs
ty-qmd index-project ~/Projects/myapp --mask "**/*.md"

# Check status
ty-qmd status

Architecture

┌─────────────────────────────────────────────────────────┐
│                  Task Execution Environment             │
│                                                         │
│   Claude ──MCP──▶ taskyou-mcp ──proxy──▶ qmd mcp       │
│                        │                   │           │
│                        │                   ▼           │
│                        │          ┌───────────────┐    │
│                        │          │  QMD Index    │    │
│                        │          │  - tasks      │    │
│                        │          │  - docs       │    │
│                        ▼          └───────────────┘    │
│                 ┌─────────────┐                        │
│                 │ TaskYou DB  │◀──── ty-qmd sync      │
│                 └─────────────┘                        │
└─────────────────────────────────────────────────────────┘

Files Added

File Purpose
extensions/ty-qmd/README.md User documentation
extensions/ty-qmd/DESIGN.md Technical design and integration strategies
extensions/ty-qmd/cmd/main.go CLI entry point (cobra)
extensions/ty-qmd/internal/qmd/qmd.go QMD CLI wrapper
extensions/ty-qmd/internal/tasks/tasks.go TaskYou DB access
extensions/ty-qmd/internal/exporter/exporter.go Task → Markdown export
extensions/ty-qmd/config.example.yaml Example configuration

Test plan

  • Build extension: cd extensions/ty-qmd && go build -o ty-qmd ./cmd
  • Install QMD: bun install -g github:tobi/qmd
  • Verify sync: ty-qmd sync --all
  • Verify search: ty-qmd search "some query"
  • Verify MCP serve: ty-qmd serve

Future work (tracked in DESIGN.md)

  • Pre-execution context injection
  • Auto-sync daemon mode
  • Project-specific collections
  • TUI integration

🤖 Generated with Claude Code

bborn and others added 2 commits February 5, 2026 10:31
Introduces a new extension that integrates QMD (an on-device semantic search
engine) with TaskYou to provide:

- Task history search - completed tasks become searchable knowledge
- Project documentation indexing - index markdown, meeting notes, docs
- MCP sidecar mode - Claude can search during task execution

Features:
- ty-qmd sync: Export completed tasks to QMD index
- ty-qmd search: Query indexed content with hybrid search
- ty-qmd serve: Run QMD MCP server for Claude integration
- ty-qmd index-project: Add project documentation to index
- ty-qmd status: Show sync and index status

The extension follows the same pattern as ty-email, using the ty CLI as
a bridge to TaskYou. Task exports include frontmatter metadata and are
formatted for optimal semantic search.

See DESIGN.md for integration strategies and implementation phases.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Integrates QMD (on-device semantic search) into the task detail view:

- Add internal/qmd/client.go: Go wrapper for QMD CLI with caching
- Add Related Tasks section to detail view showing semantically similar
  past tasks when QMD is available
- Load related tasks asynchronously to not block the UI
- Display relevance indicators (●/◐/○) based on match score

The Related Tasks section appears between Description and Dependencies,
showing up to 5 most relevant past tasks. This helps Claude and users
find context from prior work when tackling similar problems.

Integration points:
- Detail view automatically queries QMD on task open
- Results cached to avoid repeated searches for same task
- Gracefully degraded when QMD not installed (section hidden)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant