# Filesystem

Concept · [Building with AI](https://ecosystem.samcarlton.com/ai)

Also called: file system, files and folders, file tree, local files, disk

The files and folders on a computer. For a [coding agent](https://ecosystem.samcarlton.com/coding-agent) it is where the work lives and the main way to keep anything after a [session](https://ecosystem.samcarlton.com/session) ends, including code, notes, plans and instruction files.

**For example:** A [founder](https://ecosystem.samcarlton.com/founder) asks the [agent](https://ecosystem.samcarlton.com/ai-agent) to save its plan as a file in the project, so the next day's [session](https://ecosystem.samcarlton.com/session) can read it.

## Connects to (7)

- [Agent environment](https://ecosystem.samcarlton.com/agent-environment): Everything outside the agent's own software that it can look at or change: your files, terminal, browser, databases and connected services.
- [Repository](https://ecosystem.samcarlton.com/repository): The folder where a project's code lives, together with the full history of every change made to it.
- [AGENTS.md](https://ecosystem.samcarlton.com/agents-md): A plain text file in a project that many coding agents read automatically at the start of every session.
- [Memory system](https://ecosystem.samcarlton.com/memory-system): A setup that tries to give an agent memory across sessions by saving notes to files or a database and loading them back when a new session…
- [Sandbox](https://ecosystem.samcarlton.com/sandbox): A walled-off space where an agent can run commands and change files without reaching the rest of your computer, your accounts or the open…
- [Tool use](https://ecosystem.samcarlton.com/tool-use): A way for a model to ask the software around it to run a defined action, such as a search or a database lookup, and send back the result.
- [Handoff artifact](https://ecosystem.samcarlton.com/handoff-artifact): The written document that carries a handoff, produced by one session for another to read.

Map view: https://ecosystem.samcarlton.com/filesystem