# Setup guide — Daily Planning Agent

## 1. Install and connect (read-only)

Install the agent and connect your calendar and tasks with read-only scope.

```
pipx install daily-planner-agent
daily-planner-agent connect --calendar google:readonly --tasks todoist:readonly
daily-planner-agent doctor
```

## 2. Configure boundaries

Propose-only and no-overcommit are enforced here.

```
cp .env.example .env
ANTHROPIC_API_KEY=sk-ant-...
CALENDAR_WRITE=false        # never edits your calendar
INCLUDE_BREAKS=true
NO_OVERCOMMIT=true
```

## 3. Set your day constraints

Tell it your hours, breaks, and focus preferences.

```
# day.yml
working_hours: '09:00-17:30'
lunch: '12:30-13:15'
focus_blocks_min: 90
buffer_between_meetings_min: 10
do_not_schedule: ['after 18:00']
```

## 4. Try a plan

Generate a plan and review the blocks, deferrals, and suggestions.

```
daily-planner-agent plan --date today --explain
# prints time-blocked plan + overcommit flag + suggestions (no changes made)
```

## 5. Wire into your morning

Generate a proposed plan each morning for you to apply yourself.

```
# morning trigger -> proposed plan to your notes/chat; you apply changes manually
```
