Commands

Repository commands

dojo init

Initialize a new Dojo repository in the current directory.

dojo init

Creates a .dojo directory and registers the repository with the remote server.

dojo clone

Clone an existing repository.

dojo clone <repository-url>

Example:

dojo clone https://dojo.ninja/api/repos/mies/my-project

dojo status

Show the current state of the working copy.

dojo status

Displays modified, added, and deleted files, current bookmark, and working copy change ID.

Commit commands

dojo commit

Describe the current working copy and create a new empty change on top.

dojo commit -m "Your commit message"

Options:

Flag	Description
`-m, --message`	Commit message
`--intent-goal`	What this commit aims to achieve
`--intent-plan`	Steps taken
`--intent-confidence`	Confidence level: `low`, `medium`, `high`

Example with intent metadata:

dojo commit -m "Add user model" \
  --intent-goal "Create database schema" \
  --intent-plan "Define types, create Drizzle schema" \
  --intent-confidence high

dojo describe

Change the message of an existing commit without creating a new one.

dojo describe -m "Updated message" <commit>

dojo edit

Move the working copy to an existing commit for editing.

dojo edit <commit>

Accepts @ (current), @- (parent), @-- (grandparent), bookmark names, or commit/change IDs.

dojo new

Create a new empty change on top of a parent.

dojo new --parent <commit> --message "description"

History commands

dojo log

Show the commit history graph.

dojo log

Options:

Flag	Description
`-n <count>`	Limit number of entries

dojo show

Show details of a specific commit.

dojo show <commit>
dojo show @        # current working copy
dojo show @-       # parent

dojo diff

Show changes in the working copy vs its parent.

dojo diff

dojo evolution

Show how a change evolved through rewrites and snapshots.

dojo evolution <commit>

Sync commands

dojo sync push

Push local commits to the remote server.

dojo sync push

dojo sync pull

Pull new changes from the remote server.

dojo sync pull

dojo remote

Show the remote server URL.

dojo remote

Stack commands

dojo stack submit

Submit commits as a stack for code review.

dojo stack submit --title "Stack title"

dojo stack list

List all stacks.

dojo stack list
dojo stack list --status review    # filter by status
dojo stack list --status merged

dojo stack show

Show details of a specific stack.

dojo stack show <number>

Review commands

dojo review list

List stacks awaiting your review.

dojo review list

dojo review diff

View changes in a stack.

dojo review diff --number <stack-number>
dojo review diff --number 42 --delta     # only changes since last review
dojo review diff --number 42 --commit <id>  # specific commit

dojo review approve

Approve a stack.

dojo review approve --number 42

dojo review reject

Request changes on a stack.

dojo review reject --number 42 --message "Missing error handling"

dojo review comment

dojo review comments

View comments on a stack.

dojo review comments --number 42
dojo review comments --number 42 --unresolved  # only unresolved

Rewrite commands

dojo rewrite split

Split a commit into multiple commits by file groups.

dojo rewrite split <commit> --specs "file1.ts,file2.ts:First part" "file3.ts:Second part"

dojo rewrite reorder

Reorder commits in a chain.

dojo rewrite reorder <commit-id-1> <commit-id-2> <commit-id-3>

dojo undo

Undo the last operation.

dojo undo

dojo ops log

Show the operation log.

dojo ops log

Workspace commands

Workspaces are remote sandboxes for agents (or any automation) to work in isolation.

dojo workspace create

dojo workspace create --name "feature-name" --agent "agent-name"

dojo workspace list

dojo workspace list

dojo workspace show

dojo workspace show <workspace-id>

dojo workspace write

Write a local file to the workspace.

dojo workspace write <workspace-id> <local-file> [remote-path]

dojo workspace read

Read a file from the workspace.

dojo workspace read <workspace-id> <path>

dojo workspace status

Show changed files in the workspace.

dojo workspace status <workspace-id>

dojo workspace commit

Commit workspace changes.

dojo workspace commit <workspace-id> -m "Commit message"

dojo workspace submit

Submit workspace as a stack for review.

dojo workspace submit <workspace-id> -t "Stack title"

dojo workspace check-conflicts

Check for conflicts with other workspaces.

dojo workspace check-conflicts <workspace-id>

dojo workspace delete

Delete a workspace (committed changes are preserved).

dojo workspace delete <workspace-id>

Authentication commands

dojo auth login

Credentials are stored in ~/.dojo/credentials.json.