How-to guide

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.

1. 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.
2. Start a chat under that project. Describe the task and any files to leave alone.
3. 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.
4. 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 uses Git checkpoints for coding changes. Ask to undo a particular dispatch or change, 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.