Back to Exercises
Getting Started beginner 15 min

Set Up Beads

Use Claude Code to install Beads and create your first task.

Objectives

  • Install Beads CLI
  • Initialize .beads/ in a project
  • Create and complete a task
  • Learn the workflow: create → work → close → sync

Beads Tasks

Create these tasks in Beads before starting. You learn Beads by using Beads.

bd create "Install Beads CLI" --type=task--labels=learn,getting-started
bd create "Run bd init in a project" --type=task--labels=learn
bd create "Create first task with bd create" --type=task--labels=learn
bd create "Complete task with bd close" --type=task--labels=learn

Claude Code Prompt

Copy this prompt into Claude Code to build YOUR own version:

## Setup: Track this exercise with Beads

```bash
bd create "Install Beads CLI" --type=task --labels=learn,getting-started
bd create "Run bd init in a project" --type=task --labels=learn
bd create "Create first task with bd create" --type=task --labels=learn
bd create "Complete task with bd close" --type=task --labels=learn
```

---

Help me install Beads and set up agent-native task tracking.

I want to:
1. Install the Beads CLI (bd command)
2. Initialize Beads in my current project
3. Create a few test tasks
4. Learn the core workflow: create → work → close → sync

Walk me through each step. After installation, help me understand:
- How bd ready surfaces unblocked work
- How bd dep add creates dependencies
- How bd sync integrates with git

My operating system: [macOS/Linux]
My project directory: [YOUR_PROJECT_PATH]

Your Solution

Write code that addresses the objectives above. Apply the principles from the Getting Started path.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Review the lesson