Workspace and files

nod has its own Linux computer, called the workspace, where it runs commands and keeps files for your conversation.

The workspace is separate from your computer. nod can write documents, convert files, run code and keep notes there without touching your own files.

What nod can use

For	The workspace has
Office files	LibreOffice, to convert, render and recalculate documents and sheets
PDFs	qpdf, Ghostscript and pypdf, to fill forms and repair files
Text in any language	Noto fonts for other scripts and emoji
Video from a link	`save-video`, which saves a video as an MP4 of 50 MB or less to send, or the full video with `--full`
Anything else in Python	`pip install`, which adds libraries to `~/.local`

save-video refuses live streams and videos too long to fit at a watchable quality. save-video --full keeps the whole video at full quality in the workspace instead, for example to transcribe or cut it.

What the workspace can't reach

flowchart LR
  you([You]):::accent
  home[(Your home folder)]:::muted
  server[nod server<br/>keys stay here]
  subgraph nod ["nod's computer"]
    ws[Workspace]
    br[Browser]
  end
  you -- attach files --> server
  server -- copies files in --> ws
  ws -- shared files --> server
  server -- attachments in chat --> you
  server -- drives --> br

Your files. The workspace doesn't see your home folder. It only gets the files you attach or that nod fetches.
Keys. Model provider keys and nod's access key never enter the workspace. If you connect a command-line tool, its token reaches only that tool, never code nod writes.
The browser. nod's browser runs in its own container. The workspace can't read its saved sign-ins.

Give nod files

Attach them in chat. Each file can be 90 MB or smaller. nod gets a copy in the workspace and sees images directly.
From your apps. Files from a connected app, such as an email attachment, are saved privately in the workspace.
From the web. Files that nod downloads in its browser go into the workspace.

Get files from nod

When nod shares a file, it appears as an attachment in the nod app, up to 90 MB. Select it to open it in a panel next to the chat, so you can keep talking to nod while you read. Press the arrow keys to move through every file in the conversation, drag the panel's edge to resize it, and press Escape to close it. Select Download to save a file.

File	How it opens
Images, video and audio	At full size. Select an image to zoom; audio shows its waveform
PDF	Every page, with zoom
Word (`.docx`) and PowerPoint (`.pptx`)	As a page or slides. The layout is close to, not exactly, Office's
Excel, CSV and TSV	As a table with its sheets, up to the first 200 rows
Markdown, HTML and SVG	Rendered, with a Code view
Code, JSON and text	With syntax highlighting
ZIP	The list of files inside

HTML files run in a sandbox, apart from nod. Their scripts work, but they can't reach nod or your accounts, load anything from the internet, send forms or open windows. If a page navigates to a website, its preview closes. Other files open without running any code.

Previews have size limits: 4 MB for text, Markdown, HTML and spreadsheets, 25 MB for Word documents and 60 MB for presentations. Download larger files to open them.

Files nod saves along the way stay private in the workspace until it shares them. Ask for one by name if you want it. On Telegram, shared files arrive as documents, up to 50 MB each. WhatsApp can't receive files from nod, so open nod to get them. See Telegram and WhatsApp.

One workspace for all tasks

The main chat and all saved tasks use the same conversation workspace. Each task has a folder under tasks/, with drafts/ for working files and outputs/ for results. shared/ holds common files.

A task can read files from another task's output folder. These folders organize work; they do not create separate computers or file access boundaries. Each task keeps its own saved conversation history. Sharing a file does not automatically add its content to every active task's context.

See Task sessions for how files, memory and owner updates keep the work connected.

How long files stay

Files stay in the workspace for the whole conversation. nod can come back to them days later.

In a development run, Clear messages gives nod a new, empty workspace folder. See Start with an empty chat.