Rename the TaskForge folder in your vault
Shipped in version 3.0.0
TaskForge keeps a small folder at the root of your vault. It holds your
settings and the agent contract files that describe your task format to tools
like Claude Code and Cursor. By default it's called taskforge. If that name
doesn't fit how you organize your vault, you can now change it from inside the
app.
Where to find it
Open Settings, then AI & Agents, and look for the Folder row. It shows the current folder name. Tap it to rename.
What happens when you rename
You type a new name and confirm. TaskForge does three things:
- Moves the existing folder to the new name, keeping every file inside it.
- Updates the internal pointers that tell the app where its settings live, so nothing breaks and you don't have to re-select the folder.
- Refreshes the agent contract files (
agents.md,dialect.json,spaces.json), so their references keep pointing at the new folder path.
Your settings and generated docs are the same after the move. Only the folder name changed.
Rules the rename checks
The name can be a nested path: System/TaskForge
puts the folder inside a System folder at your vault root. Slashes separate
folders, and on Windows typed backslashes are treated the same way. Empty
path parts and names that start with a dot are rejected as you type. If a
folder with the new name already exists and isn't a TaskForge settings folder,
the rename stops and tells you, rather than merging into it or overwriting
anything. If it is an earlier TaskForge settings folder, the two are merged.
Keep it within 16 levels of your vault root. The rename accepts deeper paths, but if the folder ever goes missing from its configured place, TaskForge only searches 16 levels down to find it again, and it reads tasks and notes only 32 levels down.
A note on the older hidden folder
Vaults created by earlier versions used a hidden .taskforge folder, which the
Files app and Obsidian's file browser don't show. On this version the folder is
visible by default. The rename can't hide it again, because a name that starts
with a dot is rejected.
Platform notes
The Folder row and the rename flow work the same on iOS, Android, macOS, and Windows. A rename made on one device travels to your others through whatever already syncs your vault, such as iCloud or Obsidian Sync.