Use this quickstart to install the Droid CLI, start an interactive terminal session, and delegate a first scoped task. You will see how Droid reads your codebase, proposes changes, and waits for review before editing.

Before you begin#

Make sure you have:

• A terminal open in a code project

• A Git repository (recommended for the full workflow demonstration)

Step 1: Install and start Droid#

Then navigate to your project and start the Droid CLI.

You'll see Droid's welcome screen in a full-screen terminal interface. If prompted, sign in via your browser to connect to Factory's development agent.

Step 2: understand your codebase#

Start by asking Droid to map the project before it edits anything:

> analyze this codebase and explain the overall architecture

> where are the main entry points, test commands, and code conventions?

Droid reads the files it needs, summarizes the architecture, and identifies the checks it should run before making changes.

Step 3: run your first reviewable change#

Ask for one small, verifiable change:

> add structured logging to the app entry point and replace the existing console calls

Droid will:

1. 1
   Inspect the current implementation.
2. 2
   Propose a plan when the task needs one.
3. 3
   Show the exact diff.
4. 4
   Wait for approval before editing.
5. 5
   Run the relevant validators when you ask it to finish the task.

Review the diff and run the relevant tests before accepting the change. This propose-and-approve loop is how you keep control as you delegate more work.

Step 4: pick a goal to go deeper#

Step 5: handle version control#

Droid makes Git operations conversational and intelligent:

> review my uncommitted changes and suggest improvements before I commit

> create a well-structured commit with a descriptive message following our team conventions

Essential controls#

Here are the key interactions you'll use daily:

Useful slash commands#

Quick shortcuts to common actions:

Learn how to create custom slash commands →