Work in a project¶

A project connects chats to a real folder on your computer. Nawa edits that folder directly. A chat outside a project has its own workspace under the Nawa profile.

Hover over Projects in the sidebar and use its plus control to add a project. Choose the intended folder, not a parent such as all of Downloads.
Start a chat under that project. Describe the task and any files to leave alone.
Use Files in the chat menu to inspect the workspace. Open a delivered file or app from the answer to see it in the drawer.
Open the code-review control or files changed pill to inspect changes before relying on them.

For repeatable project instructions, create a root AGENTS.md; see Instructions, agents and skills. Different chats in the same project share its files. Avoid simultaneous edits to the same files from two chats or another editor.

Undo and remove¶

Nawa saves each change it makes to the folder as a Git checkpoint: the assistant's own changes in a reply, and each piece of work it hands to the coder. Changes you make yourself, in another editor or by adding files, are not part of them: before Nawa commits a change of its own, it commits yours separately, as they were. Ask to undo the latest change, or the latest few, and inspect the result. A Git undo is not a universal undo for installed packages, messages sent to a service, or other external effects. Keep your own commits and backups for valuable work.

Removing a project from Nawa is different from deleting its folder. Read the confirmation and its chat options before proceeding. To delete actual files, make that request explicitly; do not assume removing a sidebar entry removes the files from disk.