Skip to main content
dotbot is a PowerShell-native framework that brings structure and accountability to AI-assisted software development. Rather than generating code in a black box, dotbot runs each task through a transparent, version-controlled pipeline where your team can see what was decided, why, and how to pick up where it left off. Every AI session, question, answer, and code change is tracked directly in your repository.

Quick Start

Install dotbot and run your first AI-assisted workflow in five steps.

Installation

Install on Windows, macOS, or Linux via one-liner, Scoop, or Homebrew.

Core Concepts

Understand workflows, stacks, task types, and the two-phase execution model.

CLI Reference

Full reference for every dotbot CLI command and flag.

MCP Server

Connect Claude, Warp, and other AI tools to dotbot’s 33-tool MCP server.

Dashboard

Monitor workflows, inspect audit trails, and manage settings from the web UI.

​
What dotbot does

Most AI coding tools produce output without a record of how they got there. dotbot solves this by wrapping AI execution in a managed workflow engine where every task runs in isolation and every decision is captured.

Workflow pipelines

Define multi-step AI pipelines in workflow.yaml with tasks, dependencies, and form configuration.

Two-phase execution

Analysis resolves ambiguity and builds context. Implementation writes code. No guesswork.

Git worktree isolation

Every task runs on its own branch. Parallel tasks never conflict.

Multi-provider AI

Switch between Claude, Codex, and Gemini. Set models per task to control cost.

Enterprise registries

Publish and share workflows across your organization via git-hosted registries.

Human-in-the-loop

Route AI questions to stakeholders via Teams, Email, or Jira when input is needed.

​
Get started in three steps

1

Install dotbot globally

Run the one-liner installer in PowerShell 7+:
irm https://raw.githubusercontent.com/andresharpe/dotbot/main/install-remote.ps1 | iex
After installation, restart your terminal and verify with dotbot status.
2

Initialize your project

Navigate to your project directory and run:
dotbot init
This creates a .bot/ directory with the MCP server, web UI, runtime, and default workflow.
3

Launch the dashboard

Start the built-in web dashboard:
.bot\go.ps1
The dashboard opens at http://localhost:8686. From here you can run workflows, monitor tasks, and review session history.
dotbot requires PowerShell 7+, Git, and at least one AI CLI — Claude, Codex, or Gemini. No npm, pip, or Docker required.