OpenSana Docs

Threads and AI Chats

Work with project and task-scoped AI conversations backed by connected CLIs.

Threads are persistent AI conversations attached to project work.

What Threads Are For

Use threads when you want:

  • codebase-aware implementation help
  • reviews and planning tied to a project
  • conversations connected to one or more tasks

How Thread Execution Works

The web app stores your message and queues it for processing.

A connected CLI session claims the thread, runs the selected runtime, and streams assistant output back into the thread.

Context You Can Add

  • message text
  • task attachments
  • file attachments
  • selected working directory or profile context

Practical Workflow

  1. Open a project thread or start a new one.
  2. Attach a relevant task if the conversation is about tracked work.
  3. Send the prompt.
  4. Review streamed output, runtime notices, and tool output.
  5. Retry or continue the thread as needed.

Requirements

Threads only execute live if at least one compatible CLI profile is connected for the project.

On this page