Docs03 of 14

Projects and chats

A project is a name. A chat carries its own vendor, model and effort.

Projects

  • A project is a name. Source folders and references are optional, added later. Several folders are allowed.
  • Add a reference to keep a URL or a note on the project. Remember this… keeps a note.
  • The project home lists its chats. Archive a project and keep or delete its chats; Unarchive later.

Chats

  • Chats belong to a project. Rename (/rename), archive (/archive), delete (/delete), or drag one to another project.
  • Chat settings sit on the chat: Provider, Available models, Reasoning level, Approval behavior, File access, Environment. Nothing here is per app.
  • Fork (/fork) branches this chat from the latest turn to try a different model on the same history. When the project has a Git folder, the fork gets its own isolated worktree — the same isolation subagents use.
  • Rewind to an earlier turn.
  • A portable transcript follows a chat when its vendor changes, and portable checkpoints restore compacted context for vendors without native compaction. /compact compresses the context with an optional keep-note.
  • Search all chats from the sidebar runs over titles and message text across every project.
  • Each chat row shows how old the last prompt is — 25m, 2h, 3d. Hover for the full time.

Reading a turn

A turn's work stays on one compact line while it runs. Open it for the ordered detail: think, tools, think. Consecutive tool calls share one fold — expand it to see the calls listed underneath. When a turn runs long, earlier thoughts and tools roll into an Earlier fold you can open again; the current hop stays open. The visible reply stays below that. /copy copies the latest reply.

Files you can hand a chat

Drag them onto the window, or paste them in.

  • Images — png, jpg, jpeg, webp, gif, bmp
  • Audio — mp3, wav, m4a, aac, flac, ogg, opus, webm
  • Video — mp4, mov, m4v, webm, avi, mkv
  • Documents — pdf, doc, docx, ppt, pptx, xls, xlsx, rtf, odt
  • Text and code — txt, md, json, csv, tsv, ts, tsx, js, py, rs, go, java, rb, php, c, cpp, cs, sql, yml, toml, sh, and the rest of the usual list
  • Folders — dropped whole, with dotfiles and build output skipped

A chat can also read media the agent wrote, so a generated image shows in the transcript rather than as a path.