Skip to Content
DocumentationQuick Start

Quick Start

Get Chloe running in your project in under 5 minutes.

Prerequisites

Installation

The fastest way to get started:

curl -fsSL getchloe.sh/install.sh | bash

This downloads the latest release and installs it to your path.

Starting Your First Session

Initialize Your Project

Navigate to your project directory and initialize Chloe:

cd your-project chloe init

This creates a .chloe/ directory to store your tasks and configurations. The directory is automatically added to .gitignore.

Launch Chloe

Start Chloe:

chloe

You’ll see the main interface with four tabs:

  • Tasks - Your Kanban board
  • Instances - Terminal panes
  • Roadmap - Project planning
  • Worktree - Git worktree management

Create Your First Task

  1. Press a to add a new task
  2. Type your task description
  3. Press Enter to save

The task appears in the “To Do” column.

Open a Terminal Instance

  1. Press 2 to switch to the Instances tab
  2. Press c to create a new terminal pane
  3. Start Claude Code or any other command
  1. Press 1 to go back to Tasks
  2. Navigate to your task with h/j/k/l or arrow keys
  3. Press Enter to move it to “In Progress”
  4. The task is now linked to your active instance

Data Storage

Chloe stores all state in .chloe/state.json in your project directory:

  • Tasks and their statuses
  • Instance configurations
  • Roadmap items
  • View settings

What’s Next?

Last updated on