Projects - agentic coding in chat

Open a project folder and the conversation becomes a workbench: your AI reads files, proposes edits as colored diffs, runs builds and tests with output streaming live, and asks before every action. Everything it does lands in the same signed conversation record as everything it says.

Setup (once)

Projects need Your Own AI Build, a free ~50 MB add-on. The app offers it when you first reach for a project; it downloads in the background while you keep chatting, and also lives on Settings → Components.

Opening a project

• The folder button in the header,
• "Open a project..." in the sparkle menu, or
• drop a folder onto the message field.

The header shows the project chip with a status dot while it's open.

Permissions, not surprises

Every command and edit asks first - the exact command shown in full, never truncated; diffs expandable; touched paths listed. "Don't ask again" applies only to the action it names, only in this project. Answered asks collapse to one-line receipts so the conversation stays an audit log.

Watching the work

Each working turn shows its whole story live: steps with their real results, the model's thinking, a live plan checklist, and long-running commands streaming their output - full scrollback, following the newest line until you scroll up. When the turn ends it folds to a single summary line you can reopen anytime. A "Simple project view" setting trims the verbosity, never the liveness.

The project remembers

Decisions and conventions save to a project memory all your AIs share - the AI can ask to save a note (you approve each one), and each session's takeaways are distilled when you finish. Reopening a project conversation picks up where it left off.

Proving what happened

Export the conversation - steps, diffs, and commands included - as a file, optionally signed so anyone can verify it. See Export and receipts.

Good to know

• Project work only routes to models that can drive tools; the app offers a switch rather than silently substituting.
• Two cost levers in Settings → Routing keep project side-work - or whole sessions - on your device when your hardware fits them.
• Shell commands an AI writes can hand off to your own terminal, pre-filled at your prompt - you stay the one who presses enter.