Rename the TaskForge folder in your vault

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, as deep as you like: System/TaskForge tucks 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 in your vault, the rename stops and tells you, rather than merging into it or overwriting anything.

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. If you'd rather keep it hidden, rename it back to a name that starts with a dot, and it drops out of those file listings again.

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.