Creating your first workspace

A workspace in AgentDock is just a project folder you've pointed the app at. To create one, use the "Add project" (or equivalent) action in the sidebar — it opens your OS's native folder picker.

What happens when you add one

Once you pick a folder, AgentDock stores its path and a display name (derived from the folder name) in its local database. That's the entire workspace record — there's no additional project configuration file, and no git-specific metadata attached at this level. Agents you start sessions with will operate against that folder as their working directory.

You can add multiple workspaces and switch between them from the sidebar. Renaming, collapsing, and removing workspaces are all available from there too.

See Workspace overview and Adding projects for the full picture, including what happens if a workspace's folder has moved or no longer exists.

Next: start a session

Once a workspace is open, continue to Starting your first session to pick an agent and begin a conversation.