Quickstart

This page takes you from a fresh install to your first workspace. If you haven’t installed Mooj yet, start here.

Mooj revolves around a single concept: the Workspace. Every feature, bug, or improvement you’re working on gets its own — an isolated git worktree so you can make code changes in isolation.

Add a repo

Click ”+” to Add repository and point it at a local git repo. You will be able to create workspaces for this repo.

Create a workspace

A workspace is a git worktree at ~/mooj/workspaces/<repo>/<codename>/. The workspace’s codename will be dependent on how you create it:

Prompt mode

Click New workspace for a repo, describe the task, and press Create. Mooj creates the workspace and opens up a terminal session with your default agent and begins to execute the task. The workspace codename is initially set to a random dog breed name, but is automatically changed to a more relevant name based on the task description.

Branch mode

Click New workspace for a repo, press Tab to switch to Clone from branch, type a local, remote, or new branch name and press Create. Mooj creates a workspace with that branch checked out. If the branch doesn’t exist, Mooj creates it for you. The workspace codename is set to the branch name.