Guide / Getting Started / Create Your First Workspace and Project
← All Articles
Getting Started

Create Your First Workspace and Project

Link local machine folders into Jerico workspaces without shell scripts or folder wrangling.

Demonstrating Create Your First Workspace and Project in Jerico

On this page

Overview

Jerico organizes agent execution around Workspaces and Projects. A Workspace links one or more local developer machines running the Jerico daemon, while a Project points to a specific directory on your machine.

Creating a Project in One Step

To link a folder and start orchestrating agents:

  1. Click the + New Project button on the workspace welcome screen.
  2. Enter a descriptive Project Name and select the target Machine running your Jerico daemon.
  3. Specify or browse to your local codebase directory path (e.g. /Users/dev/projects/my-app).
  4. Click Create Project. Jerico stores the project and opens its page — no filesystem or permission check runs at this point.

Tip: No custom setup scripts or folder wrangling are required. The connected daemon has already detected the CLI agents installed on that machine, and Jerico can query the folder's git status on demand once the project is open.