The Chat panel lets you talk to an AI about your project without creating a task — useful for quick questions, investigating an issue, or drafting a plan before you commit to a pipeline run.

Chat

Safe mode vs. Full mode

Chat has two modes:

  • Safe mode — read-only. The AI can explore and explain your codebase but cannot make any changes. This is the default and the right choice for questions and exploration.
  • Full mode — allows the AI to make direct edits during the conversation. Use this sparingly, for genuinely trivial fixes only — anything more substantial should go through a Task so it gets worktree isolation, review, and tests.

Contract-aware answers

Before answering, Chat receives a current summary of the project's relevant contracts and variables, so answers are grounded in your project's actual current state rather than guessed. You can click into any contract Chat references to see its full detail — files covered, danger zones, and related tasks.

Chat panel
The Chat panel.
Chat referencing a contract
Chat referencing a project contract in its answer.
Contract detail opened from Chat
Full contract detail opened from a Chat reference.

History and cost tracking

Every Chat conversation is saved per project, so you can come back to it later. Each message shows the running token cost, so you always know what a conversation is costing you before it grows.

Convert to Task

Once a Chat conversation has converged on a clear plan, click Convert to Task to turn that conversation into a proper pipeline Task — the context you built up in Chat carries over into the Task prompt, so you don't have to retype it.

Reference inserts

Chat supports the same _variable and @file reference inserts as the New Task modal, so you can point the AI at exact variables or files instead of describing them.

Variable explorer used from Chat
The Variable Explorer opened from the Chat view.
Searching the variable explorer
Searching the Variable Explorer by full text from Chat.

Tips

  • Default to Safe mode — switch to Full mode only for a genuinely tiny, one-line fix.
  • Use Chat to explore and refine an idea, then Convert to Task once you know exactly what you want built.
  • Watch the running cost indicator on long conversations — splitting into a fresh conversation is often cheaper than continuing a very long one.