Skip to main content
The selected folder defines the workspace available to built-in file and table tools.

​
Open a workspace

1

Choose the folder

Click choose a folder below the composer, drag a folder into the window, or use /open.
2

Review the catalog

Run /files to see loaded tables and documents plus noticed files that could not be used.
3

Ask or refine the scan

Ask a question, or add .fellaignore and run /reindex to change what is catalogued.

​
What the scan does

Fella walks to a bounded depth, silently skips hidden entries, does not follow symlinks, and applies .fellaignore from the workspace root. A root fella.md is skipped as data because it is user-authored context. The default scan depth is eight directories. FELLA_SCAN_DEPTH can override it for a controlled environment. After scanning, Fella reports both usable sources and files it noticed but could not load. Use /files to inspect the catalog and /reindex after changing the folder.

​
Workspace names

Tabular files become table names derived from their filename:
Names are lowercased, punctuation becomes underscores, leading digits get a t_ prefix, and collisions get a numeric suffix. Multi-sheet workbooks append the sheet name to the file stem. /schema <name> shows row count, columns, types, and null percentages.

​
Ignore a path

Create .fellaignore in the workspace root. Put one filename or workspace-relative path prefix on each line:
Blank lines and lines starting with # are ignored. Other entries match an exact filename, an exact workspace-relative path, or a workspace-relative directory prefix. Glob patterns are not supported.

​
Reopen safely

Fella starts without mounting the last workspace. The welcome screen can offer a one-click reopen; pressing Enter with an empty composer can also reopen it. Reopening a conversation from history mounts its saved workspace when that folder still exists.
The built-in workspace tools stay within the catalogued folder, and run_python runs in an embedded guest without filesystem access. See privacy and security.

Understand file types

See which files become tables and which stay documents.

Add workspace context

Explain your own vocabulary with fella.md.