cli.md

 1# CLI Reference
 2
 3When MCP tools are unavailable, use `lune` CLI.
 4
 5## Creating tasks
 6
 7```bash
 8lune task add "Title" -a AREA_KEY -n "$(cat <<'EOF'
 9Intro paragraph
10
11# Section
12
13Content
14
15EOF
16)"
17```
18
19<task_add_flags>
20-a --area   Area key (required)
21-s --status Status (workflow-dependent)
22-n --note   Task note (use - for stdin)
23-g --goal   Goal key
24</task_add_flags>
25
26Output includes the task ID.
27
28## Updating notes
29
30```bash
31lune task update ID -n "$(cat <<'EOF'
32Intro paragraph
33
34# Section
35
36Content
37
38---
39
40Appended content
41
42EOF
43)"
44```
45
46Notes are replaced entirely, so reproduce original content when appending.
47
48## Listing
49
50```bash
51lune area list
52lune goal list -a projects # goals in area 'projects'
53```