Quick Start

This guide walks you through creating a repository, making changes, and submitting your first stack for review.

First, authenticate with your Dojo server:

dojo auth login

2. Initialize a repository

Create a new project directory and initialize it:

mkdir my-project
cd my-project
dojo init

This creates a .dojo directory and connects to the remote server.

Create a file and Dojo will automatically track it:

echo "# My Project" > README.md

Check the status — your working copy already has the change:

dojo status

Working copy changes:
A README.md

In Dojo, your working copy is always a commit. Describe what you did:

dojo commit -m "Add README"

This describes the current working copy and creates a new empty change on top.

Make more changes — they’ll be tracked in the new working copy:

echo "console.log('hello')" > index.js
dojo commit -m "Add entry point"

dojo log

@  ksqvpmyr  (empty)
○  zrmntqqr  Add entry point
○  wvuyspkx  Add README
◆  zzzzzzzz  (root)

Group your commits into a stack and submit for review:

dojo stack submit --title "Initial project setup"

Your teammates (or AI agents) can now review your changes.