← All help

Build a Project from a Folder of Documents

Open an empty project in Filamental, then tell a connected AI such as Claude Code or Cowork to read your folder of documents, and it builds the project for you, with every person, organisation, decision and obligation as a node and the relationships between them drawn as connectors.

Where: your AI app, connected through Settings › AI (Connect an AI App)

What it is

You have a folder of documents: contracts, reports, meeting notes, research, a client's whole file. An AI that can read that folder, and that's connected to Filamental, can turn it into a project. Your documents are only read. Nothing in them is moved or changed.

This is the route for an AI outside Filamental, running on your own plan or your own model. Filamental doesn't read your documents and doesn't send them anywhere. If you'd rather stay inside the app, Folder Exploration does the same job with the AI you've connected there, see Explore a Folder or Document with AI.

What you need is an AI that can read a folder on your computer and is connected to Filamental over MCP:

  • Claude Code or Cowork, which read folders directly.
  • Claude Desktop, LM Studio or any other MCP app, as long as it can also read your files.

How to use it

  1. Start an empty project. Create a new project in Filamental, ideally beside your documents rather than inside the folder you want read, and leave it open. An app connected with no project named in its settings works on whichever project you last opened. One whose settings name a project with --vault works on that one, see Connect Other AI Apps.
  2. Point the AI at the folder. Tell it where your documents are and what you want, for example: "Read everything in this folder and build a Filamental project from it. Propose the classifications and connectors first and wait for me."
  3. Approve the vocabulary. After reading, the AI proposes the classifications (the kinds of node, such as Person or Contract) and the connector types (the kinds of relationship, such as funds or reports to), each with a colour and a weight. Change anything you like. Then add the approved ones yourself, in Classifications and Connector Types in the left panel. An AI connected over MCP can use types but can't create them, so this step is yours.
  4. Let it build. Tell the AI the types are ready. It creates the nodes, with the reasoning behind each one written into its notes, and then the connectors between them. Watch it appear.
  5. Read the report. The AI finishes by saying what it made and what it left out. Ask it about anything it skipped.

Connected AIs are briefed on this way of working when they connect, so they'll usually propose and wait without being asked.

Tips

  • Start smaller than the whole folder. A first pass of a few dozen nodes is easy to review. Ask for more once the shape is right.
  • Ask for the reasoning. A node with a bare title isn't much use. Notes that say why something is connected are what make the project worth reading later.
  • Re-run it. When new documents arrive, ask the AI to read the folder again and add only what's new.
  • Its changes aren't on Filamental's undo list. Ask the AI to put things back, see Undo and Redo.
  • Use the result as a folder. The project is plain Markdown files, so you can hand it to another person, and their AI can read it the same way. See Working with Obsidian if that person keeps their notes there.

How this helps you

Use it when you already work in Claude Code or Cowork and want the documents, the conversation and the project in one place, or when the folder is too large or too varied for a single exploration and you'd rather steer it document by document.

Related

Still stuck? Email [email protected].