$M.
The workspace is per-session and ephemeral — created fresh at the start of each session. Agents use it for scratch work, plans, research notes, and sharing context between subagents. If you want to inspect generated plans or other session files directly, you can find them under ~/.magnitude.
Your project is exposed inside that workspace at $M/project. project/ is a symlink to your actual project directory, so the real files stay in their original location. This gives the agent one logical root for both temporary session files and project files. Agents can also import from the project in any scripts they write in the workspace.
File paths in chat
Assistant messages can include clickable file links, including:- project files, for example
[app](cli/src/app.tsx), - workspace files, for example
[plan]($M/plan.md), - heading links, for example
[Approach]($M/plan.md#Approach).
$M/... paths refer to files in the session workspace. $M/project/... refers to files in your actual project through the project/ symlink.
Opening files from assistant messages
Selecting a file link opens the file viewer side panel. Markdown links with heading fragments scroll to the matching section. Open files refresh as their contents change.Path handling
Magnitude normalizes file references before opening them.- Unsafe traversal-style paths are rejected.
- Web URLs in markdown links are treated as URLs, not local file references.