Manage shared Memory files

Memory is a shared UTF-8 filesystem for your workspace. People and coding agents can create, organize, search, read, and edit text files without copying them into a local project checkout. Open Settings → Memory to browse the whole filesystem. Open a Project’s settings to work inside that Project’s folder.

Understand the filesystem

/
├── workspace/
│   ├── instructions.md
│   ├── working-memory.md
│   ├── integrations/
│   └── skills/
├── projects/<project>/
│   ├── instructions.md
│   ├── integrations/<provider>.md
│   ├── skills/
│   └── other files you create
├── archived/<project>/             read-only archived Project files
└── legacy/                         read-only imported and retired content
    ├── workspace/
    └── projects/<project>/

Location	Purpose	Who can change it
`workspace/`	Files shared across the workspace.	Members with workspace content write access and authorized agents.
`projects/<project>/`	Instructions, integration notes, skills, and free-form files for one Project.	That Project’s agents and members with workspace content write access.
`archived/<project>/`	The Project folder and files preserved when a Project is archived. Unarchiving moves the same folder back to `projects/`.	Nobody while the Project is archived; it is read-only.
`legacy/`	Exact snapshots imported from former settings fields, plus complete folders retained when a Project is permanently deleted.	Nobody; it is read-only.

Connected workspace providers get an empty integrations/<provider>.md file in each Project when no previous instruction exists. Disconnecting an Integration does not delete that file or its edits. Archiving a Project moves its folder to archived/; unarchiving returns it to projects/. Permanently deleting a Project removes it from the active and archived Project lists, but keeps its folder and files read-only under legacy/projects/.

Cogno reserves only the locations shown above. Folders or files such as notes/, agents/, and README.md are free-form content created by a person or agent, or preserved from an earlier trial. Cogno does not create them as part of the standard layout.

Memory files are not automatically inserted into every prompt. Coding agents list, search, and read the files they need. Workspace-wide reads are the default, so an agent can read other Project folders but can only change its own Project folder.

Edit Memory files

Open Settings → Memory

Open Settings → Memory. The Explorer shows workspace, live projects, archived Projects, and legacy in that order. The archived and legacy sections start collapsed.

Create or open a file

Select New file or New folder, or select an existing file. Markdown files open in Preview or Markdown mode; other UTF-8 files open as Plain text.

Edit and let Cogno save

Type in the editor. Changes save automatically after you stop typing; ⌘S saves immediately.

Copy the agent-visible path

Select Copy path when you want to reference the exact path in a task or conversation.

If an agent or another member saves the same file while you edit it, Cogno shows This file changed while you were editing. Choose Load latest or Overwrite with mine. Cogno never silently overwrites the other version.

Deleting a file or folder cannot be undone. Deleting a folder also deletes every file inside it.

Reference

Property	Behavior
Content	UTF-8 text files only. Binary files are not supported.
Paths	Case-sensitive. `.` and `..` path segments are not accepted.
Agent reads	`memory_bash` and `memory_read` show the workspace by default; relative paths still begin in the current Project.
Agent writes	`memory_write` and filesystem edits remain limited by grants; a Project cannot change another Project, `archived/`, or `legacy/`.
Project visibility	Project Settings shows that Project’s subtree; Workspace Memory shows the entire filesystem.
Saving	Autosave with conflict detection based on the file version that was opened.
Migration	Existing instructions and working memory are copied verbatim; Cogno does not summarize or split them. Orphan folders from previously deleted Projects are preserved under `legacy/projects/`.

Start

Release notes

Concepts

Guides

Reference

Help

Manage shared Memory files

Understand the filesystem

Edit Memory files

Reference

​Understand the filesystem

​Edit Memory files

​Reference

​Related docs

Understand the filesystem

Edit Memory files

Reference

Related docs