Threads and Projects

Every conversation in ɳClaw is a thread. Threads can be grouped into projects — named folders that keep related conversations together.

Projects and thread assignments are stored in your browser (localStorage). Nothing is sent to the server. They persist across restarts and are available offline.

Creating a project

There are two ways to create a project:

1. Click the + icon next to the "Projects" label in the sidebar. Type a name and press Enter.
2. Right-click any thread and choose Move to project → New project.

Project names are free-form. Keep them short — the sidebar shows up to about 20 characters before truncating.

Moving threads between projects

Right-click any thread in the sidebar. The context menu shows all your projects. Click a project name to move the thread, or choose General to remove it from any project.

Moving a thread does not affect the conversation history. It is a visual grouping only.

Starting a thread inside a project

Each project folder in the sidebar has a small + button on the right. Clicking it creates a new thread already assigned to that project.

Deleting a project

Click the trash icon next to the project name. The project is removed, and any threads assigned to it move to General (unassigned). Threads are never deleted when a project is deleted.

System prompt per project

You can give each project a custom system prompt. Threads in that project start with the project prompt instead of the global default.

1. Open the project settings by clicking the gear icon next to the project name.
2. Enter the system prompt in the text area.
3. Click Save. New threads in this project will use the prompt automatically.

The system prompt is stored locally alongside the project data. It is not sent to the server until a new message is submitted.

Auto-organization

ɳClaw can suggest a project for a new thread based on the first message. The suggestion appears as a dismissible chip below the input. Accept it with one click or ignore it — the thread stays in General either way.

Auto-organization is disabled by default. Enable it in Settings → Threads → Suggest project from first message.

Search across threads

The search bar at the top of the sidebar searches thread titles. To search message content, open the search panel with Cmd+K (Mac) or Ctrl+K (Windows/Linux) and type your query.

Searches run entirely in the browser against locally-stored messages. There is no server round-trip for search.

Exporting threads

Export a single thread or an entire project as Markdown or JSON:

• Single thread: Open the thread, click the three-dot menu at the top right, and choose Export as Markdown or Export as JSON.
• Full project: Right-click the project in the sidebar and choose Export project. All threads in the project are bundled into a single ZIP file containing one file per thread.

Keyboard shortcuts

Storage and limits

Thread data is stored in localStorage. Most browsers allow 5–10 MB per origin. If you run into the limit, export and delete old threads.

There is no server-side thread storage in the base ɳClaw configuration. Cloud sync (store threads in your nSelf backend) is planned for a future release.