A project groups the documents for one job (storyboard, script, cut, key art, mini app) and owns no content itself. A document belongs to a project by carrying its id, and the project card reads status, stills, and spend from those documents. A workspace is different: a folder of files a run reads and writes.
The Personal project
Every account has a Personal project. It is where documents land when you have not switched to a named project. You cannot archive or delete it, and it does not appear as a card in the project list.
The project list
Open Projects in the left rail to see every named project as a card, with a Search projects field and a + New project button.

Each card shows:
- Up to three rendered stills from the project’s documents, or “No stills yet”.
- A pill over the media, such as
clips 3/8for a storyboard orcut · 0:30for a timeline. - The project name and when it last changed.
- A status line, such as
8 shots · stills 8/8 · voiced 12/14 · cut 6 clips · 0:30. - What the project has cost, labelled “provider rates”. A figure like
$4.12 · 2 unpricedmeans two calls had no price. A leading≥marks a lower bound. See Costs & Credits.
Click a card to open the project. The dashed Start a project card does the same as + New project.
Start a project
+ New project, on the Projects page or at the top of the Project selector, asks for a project name. Create project adds the project to the list, makes it the active project, and opens its home surface, titled “What would you like to create?”.

- Describe the work in the prompt. Type
/to pick a skill, or@to attach an asset or an entity. - Optionally add Reference images and pick Entities. A picked entity goes to the agent as an
entity://reference. - Pick a model with Select a model. If no language model is connected, NodeTool opens provider setup first.
- Click Send to chat.
A starter is a skill: the saved instructions a chat turn loads when it reads /<name>. The pills under the prompt list skills NodeTool ships, such as product-commercial and short-film, and skills you wrote. Skills you used on earlier projects come first, and the rest fold behind a N more pill. Picking a pill writes /<name> into the prompt, and deleting the command from the prompt clears the pill. You can also start with no skill, and then the prompt is the whole ask.
Send to chat opens a chat tab in the active project. The agent plans the documents the work needs and builds them. See Global Chat for how chat tabs work and Entities for the library.
The estimate line, for example est. $3.10–$5.80 · from 2 past projects · provider rates, no markup, appears next to the send button once at least two of your own past projects of the same kind finished with fully priced spend of $1 or more and a cut with clips. Until then there is no estimate.
Below the prompt, Start with a guided flow offers short step-by-step setups that each end in a document, and examples for apps, workflows, storyboards, timelines, sketches, 3D models, and games. See the Templates Gallery.
Switch projects
The Project selector at the left of the tab bar lists Personal and your named projects, with a search field. Choosing one opens its tabs as you left them. When a project’s tabs are grouped in the bar, the project chip at the start of the group offers Open editor home, Close group, and Switch to each other project.
Where new documents land
Every new document goes into the active project: the one shown in the selector. With no project open it goes into Personal. This holds for the + New menu, guided flows, and chats. The Documents panel lists the active project’s documents by kind: Workflows, Apps, Creative documents, and Agents & code.
File a document into a project
Documents that belong to no project appear under Not in a project at the bottom of the project list, newest first (12 at most, with a count when there are more). Drag one onto a project card to move it in. This works for storyboards, scripts, timelines, sketches, apps, games, and JavaScript scripts.
Copy a document to another project
On a document card, Copy opens a dialog with a Destination project field. The copy brings the referenced assets, entities, and supported documents with it, and the source stays unchanged. Workflows are listed but cannot be copied this way.
Export and import a project
Export on a project card downloads the whole project as one
.nodetool-project file. The file holds the project’s documents, workflows,
mini apps, games, and JavaScript scripts with their version history, its
conversations, its assets with their media, and every file in its workspaces.
Jobs, run history, and spend records are not included.
Import project at the top of the project list reads such a file and creates a new project from it, then opens it. Importing never changes an existing project. Every document, asset, and conversation gets a new id, and references between them are rewritten to point at the new copies, so the same file can be imported twice. Imported workflows are private, and a project exported from Personal arrives as an ordinary named project.
The same files move through the command line with nodetool projects export
and nodetool projects import. See the CLI reference.
Archive, restore, and delete
Each card carries Export, Archive, and Delete buttons. They are absent for Personal.
- Archive hides the project from the selector and deletes nothing. Archived projects are listed under Archived projects at the end of the list, where Restore brings one back.
- Delete asks for confirmation in a dialog titled “Delete name?”. It removes the project and all of its documents, conversations, generated outputs, assets, jobs, and project files. This cannot be undone.
There is no rename control in the project list. Ask the agent to rename a project, as described next.
The agent and projects
A project’s conversations are chats filed under it, and the server can also hold one agent thread per project, created the first time it is asked for and titled with the project’s name. Agents can manage projects with four tools:
| Tool | What it does |
|---|---|
list_projects |
Lists your projects, newest first. Pass archived to list archived ones. |
search_projects |
Finds projects by name or kind. Every word must match. |
update_project |
Renames a project, changes its kind, or archives and restores it. |
delete_project |
Permanently deletes a project. It refuses the Personal project and the project the conversation belongs to. |
The agent is told to confirm with you before deleting and to prefer archiving.