First project
Pick a folder, describe what the project is for, and Rna initializes it with the model you configured.
Open a folder
In the workbench, click Open project folder and choose an existing folder or create a new one. The desktop app uses the system folder picker; in a browser you browse real folders on the daemon’s machine, or type an absolute path.
The folder is the project’s identity. Opening the same folder again (including with a trailing slash or through a symlink) reuses the same project ID, prompt, skills and sessions without re-initializing.
The CLI equivalent:
./rna project-new "Checkout redesign" "Move checkout to the new design system with all regression tests passing" --workspace /absolute/path/to/shop
./rna project-open /absolute/path/to/shop # registers first, reuses after
./rna project PROJECT_ID # initialization progress and capability assignmentsWhat initialization does
Initialization is queued in the background and generated by your chosen model from the title and description:
- a project overview, current focus and milestones;
- the project prompt and the skills, tools and MCP it needs, each with a reason;
- editable acceptance criteria, and a project capability package that passed real script smoke checks.
Without a real model the project stays “waiting to initialize”; no template pretends to be model output. Retry on failure:
./rna project-init PROJECT_IDProject instructions file
If the project root has an AGENTS.md (or CLAUDE.md), Rna reads it into the system prompt. The file is yours: evolution only reads it and never rewrites it, so edit it directly to change it. Only that one root file is read.
Start talking
A project can have several sessions. Each keeps its full history, progress and drafts. A finished turn does not end the session, and closing a session does not stop the project’s initiative.
./rna new "Implementation" --project PROJECT_ID
./rna chat SESSION_IDDescribe what you want, for example “check the checkout layout at 390px width”. While it works you can:
- Steer: affects the current turn at the next safe boundary;
- Queue: handled right after this turn;
- Withdraw: anything not yet in the context can be taken back;
- Stop: stops this turn only; the project’s background work continues.
Archive and delete
The “⋯” menu on projects and sessions offers rename, archive and delete.
- Archive keeps history and the outgoing queue and pauses running work. Unarchiving restores visibility only; paused paid requests need you to continue them.
- Deleting a session removes chat records, attachments and session-only runtime files. Files in the project folder and extracted project memory stay.
- With unfinished execution or a failed remote cleanup, the state stays “pending cleanup” instead of pretending it is gone.