# CLI Reference

When MCP tools are unavailable, use `lune` CLI.

## Creating tasks

```bash
lune task add "Title" -a AREA_KEY -n "$(cat <<'EOF'
Note content
EOF
)"
```

<task_add_flags>
-a --area   Area key (required)
-s --status Status (workflow-dependent)
-n --note   Task note (use - for stdin)
-g --goal   Goal key
</task_add_flags>

Output includes the task ID needed to replace `PLACEHOLDER_ID` in the note.

## Updating notes

```bash
lune task update ID -n "$(cat <<'EOF'
Full replacement content
EOF
)"
```

Notes are replaced entirely—reproduce original content when appending.

## Listing areas

```bash
lune area list
```