Additional workspaces
Add another directory so fx can work across repositories, such as an app and its shared library.
Add a directory
From your project directory, run:
$
fx workspace add ../sharedfx remembers the directory for future runs from this project. Inside fx, use /workspace add ../shared when fx is idle.
The project where you start fx remains the primary workspace. Added directories share its permissions; their configuration, AGENTS.md files, and skills are not loaded.
You can add up to 16 directories. fx stores the list in your workspace settings.
Add a directory for one run
$
fx --add-dir ../sharedRepeat --add-dir to add more directories. To start fx without the saved directories for this run:
$
fx --no-additional-dirsThese flags also work before ask and acp.
List or remove directories
| Command | Description |
|---|---|
fx workspace list | Show additional directories and their availability. |
fx workspace remove ../shared | Remove a saved directory. |
fx workspace clear | Remove all saved directories for this project. |
Inside fx, use /workspace list, /workspace remove ../shared, or /workspace clear.