> ## Documentation Index
> Fetch the complete documentation index at: https://docs.capy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizing threads

> Folders, pins, tags, search, and titles: how to keep a growing pile of threads findable.

Threads accumulate fast when every piece of work gets one. Folders, tags, search, and titles keep them findable; none of them changes what a thread does. Organization is a view over threads, never a setting on them.

## Folders

Folders are flat, org-level groupings of threads. A folder is either **private** (only you see and edit it) or **shared** (every member of your organization sees and edits it), and a thread can sit in any number of folders at once. Folder membership changes nothing about the thread itself (not its project, permissions, or execution), and the All threads, status, and search views stay complete: filing a thread adds a view, it never removes the thread from ordinary results.

**Pinned** is a reserved private folder that always renders first. Pinning a thread is just membership in that folder, so pins reorder like any other folder and unpinning is removal. Pinning an already-pinned thread again moves it to the front.

Folder and tag memberships survive archiving, so an unarchived thread comes back exactly where you filed it.

## Tags

Tags are organization-wide labels: one shared vocabulary across every project, each tag with a name and color. A thread carries up to 20 tags. Tags filter and decorate thread lists; they don't place threads anywhere, so use folders for "where does this live" and tags for "what kind of thing is this".

## Search

Search is full-text over titles, thread codes, task titles, and message content, both what you wrote and what the agent replied. That matters because most thread titles are auto-generated: searching for the error string you pasted three weeks ago finds the thread even if its title never mentioned it. Search from Cmd+K anywhere, or from the search box on the threads page.

## Titles

Every thread titles itself from your first message: a compact phrase of at most 50 characters, generated while the agent starts working. After that the title holds still: no background run or follow-up message ever renames a thread, so the name you learned to scan for stays put.

Two manual controls, both in the thread's context menu:

* **Rename** sets your own title. Explicit titles stick; regeneration and auto-titling never overwrite a name you typed.
* **Regenerate** asks for a fresh title from the conversation so far, and clears the explicit-title mark so the thread is auto-titled again.