Threadlink

What is Threadlink?

Threadlink is a lightweight protocol and CLI for creating durable, inspectable links between ephemeral context (like AI conversations) and persistent files. It is designed for anyone who wants to trace how an idea became a file or how a file shaped downstream thinking.

How to use Threadlink?

Install via pip from GitHub (requires Python 3.8+ and Git). Use threadlink new or threadlink quick to create a thread, threadlink attach to link files, threadlink reverse to find the source conversation, and threadlink search to find threads by topic.

Key features of Threadlink

• Create durable links between conversations and files
• Reverse search: find source conversation from a file
• Search threads by tag or summary content
• Dual-mode tags: human-readable or auto-generated
• Local-first JSON index at ~/.threadlink/thread_index.json

Use cases of Threadlink

• Trace which AI conversation produced an old design file
• Find all threads discussing a topic like authentication
• Keep a new project’s context together by linking multiple files to one conversation

FAQ from Threadlink

What is Threadlink’s core functionality?

It connects AI conversations (via chat URLs) to local files using a simple JSON index, enabling later recall of context.

How is Threadlink different from other tools?

Threadlink is not another PKM or AI wrapper; it is a protocol for context memory that respects your file system and privacy.

What are the runtime requirements?

Python 3.8+ and Git must be installed on your system.

Where does Threadlink store data?

Data is stored locally in ~/.threadlink/thread_index.json.

Is Threadlink extensible?

Yes, it is designed as an open protocol and welcomes plugin development for other tools.