Modding

Modding documentation

• Getting started

• Writing mods in bfscript

• Writing mods in TypeScript and JavaScript

• Permissions

• Hooks

• UI surfaces

• Publishing to the mod index

• Using the MCP server

• Troubleshooting

• Examples

• Generated reference

Real world examples

Five published mods, each a TypeScript package with a signed release in the mod index. Install them from Settings → Mods → Browse.

Mod	What it does
weather-panel	Slide-out panel with current weather and a 3 day forecast. Only talks to Open-Meteo.
drop-stack	Stash files from anywhere, then copy or move the pile into the folder you are in.
folder-notes	Sticky notes per folder, using a panel textField and mod storage.
size-heat	Heat column with a small text bar showing each item's size against its siblings.
trash-cat	Status bar cat that eats what you trash and keeps score.

Generated pages and editor declarations are copied from betterfinder-mod docs --out <temporary-directory>. Regenerate them with the same reviewed CLI after catalog changes; only relative Markdown link suffixes are adapted for repository browsing.