Workspaces & Projects

What is a Workspace?

A workspace is the root directory for your projects. FiveForge operates within the boundaries of the selected workspace, providing the AI with context about your codebase structure.

You will be prompted to select a workspace on first launch, and you can switch at any time.

Switching Workspaces

Click workspace name

Click the workspace name displayed in the application header.

Select Switch Workspace

Select Switch Workspace from the dropdown.

Choose a directory

Choose a new directory from the file picker.

Sidecar restarts

The sidecar process restarts automatically.

Project Map regenerates

The Project Map regenerates to reflect the new directory.

Project Map

The Project Map is an automatically generated overview of your workspace structure. It helps the AI understand your project layout, file organization, and dependencies.

Rebuild the Project Map from the sidebar or the menu bar.
The map updates whenever files are added, removed, or renamed in your workspace.

Example Resource Structure

code

my-resource/
  fxmanifest.lua
  client/
    main.lua
  server/
    main.lua
  shared/
    config.lua

File Access

FiveForge uses the MCP (Model Context Protocol) for file system access. It only operates within the selected workspace directory and cannot access files outside of it.