Create Your First Project

After Docker is running, use the local web app at http://localhost:4748 to create your first research workflow.

1. Create a project

Create a project for the niche, product idea, audience, or market you want to research. Use a specific name that will still make sense when you review older runs later.

2. Add queries

Add project queries for the sources you want to scout:

Reddit for forum-style problem discussions.
Bluesky for shorter posts and public social conversation.
Google Search for pages, comparisons, and intent-rich search results.

Keep early queries narrow enough that you can inspect results manually.

3. Run a scout

Start with one source and wait for the scout run to complete. ThreadLens records each run so you can review whether it completed, failed, or was cancelled.

4. Review findings

Use scores, statuses, and filters to separate high-signal findings from noise. Statuses help you track what is new, starred, excluded, drafted, or already handled.

5. Generate a report

Select promising findings and generate a research report. Reports cluster recurring pain themes, extract supporting quotes, and suggest product angles.

6. Schedule recurring research

Add a schedule only after the query quality is good enough that repeated runs produce useful results.