claude_storage 1.7.1

CLI tool for exploring Claude Code filesystem storage
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

# Command :: `.status`

Integration tests for the `.status` command. Tests verify storage overview, statistics output, and verbosity behavior.

**Source:** [command/01_status.md](../../../../docs/cli/command/01_status.md)

## Test Case Index

| ID | Test Name | Category |
|----|-----------|----------|
| INT-1 | Default output with real storage | Read Operations |
| INT-2 | Verbosity 0 machine-readable output | Output Format |
| INT-3 | Verbosity 2 detailed per-project output | Output Format |
| INT-4 | Custom storage path via path:: | Configuration |
| INT-5 | Custom storage path via CLAUDE_STORAGE_ROOT env | Configuration |
| INT-6 | Exit code 0 on success | Exit Codes |
| INT-7 | Exit code 2 on unreadable storage path | Exit Codes |
| INT-8 | Output contains project count and session count | Read Operations |

## Test Coverage Summary

- Read Operations: 2 tests (INT-1, INT-8)
- Output Format: 2 tests (INT-2, INT-3)
- Configuration: 2 tests (INT-4, INT-5)
- Exit Codes: 2 tests (INT-6, INT-7)

## Test Cases

---

### INT-1: Default output with real storage

**Command:**
```
CLAUDE_STORAGE_ROOT=/tmp/test-fixture clg .status
```

**Expected behavior:**
- Fixture: 2 projects, 3 sessions total in storage
- Stdout contains a summary table with project count `2` and session count `3`
- Exit code: 0
- **Source:** [command/01_status.md](../../../../docs/cli/command/01_status.md)

---

### INT-2: Verbosity 0 machine-readable output

**Command:**
```
CLAUDE_STORAGE_ROOT=/tmp/test-fixture clg .status verbosity::0
```

**Expected behavior:**
- Fixture: 2 projects, 3 sessions total in storage
- Stdout contains exactly `projects: 2` and `sessions: 3` (no table borders, no labels)
- Exit code: 0
- **Source:** [command/01_status.md](../../../../docs/cli/command/01_status.md)

---

### INT-3: Verbosity 2 detailed per-project output

**Command:**
```
CLAUDE_STORAGE_ROOT=/tmp/test-fixture clg .status verbosity::2
```

**Expected behavior:**
- Fixture: 2 projects, each with 1 session containing known entry counts
- Stdout contains summary table plus per-project rows showing session counts and entry type breakdown (user/assistant)
- Exit code: 0
- **Source:** [command/01_status.md](../../../../docs/cli/command/01_status.md)

---

### INT-4: Custom storage path via path::

**Command:**
```
clg .status path::/tmp/alt-fixture
```

**Expected behavior:**
- Fixture: `/tmp/alt-fixture` has 1 project, 1 session; default storage has different counts
- Stdout shows counts from `/tmp/alt-fixture` (1 project, 1 session), not from default storage
- Exit code: 0
- **Source:** [command/01_status.md](../../../../docs/cli/command/01_status.md)

---

### INT-5: Custom storage path via CLAUDE_STORAGE_ROOT env

**Command:**
```
CLAUDE_STORAGE_ROOT=/tmp/test-fixture clg .status
```

**Expected behavior:**
- Fixture: 2 projects, 3 sessions in `CLAUDE_STORAGE_ROOT`
- Stdout reflects the fixture's 2 projects and 3 sessions, not the real `~/.claude/` counts
- Exit code: 0
- **Source:** [command/01_status.md](../../../../docs/cli/command/01_status.md)

---

### INT-6: Exit code 0 on success

**Command:**
```
CLAUDE_STORAGE_ROOT=/tmp/test-fixture clg .status
```

**Expected behavior:**
- Normal summary output on stdout
- Exit code: 0
- **Source:** [command/01_status.md](../../../../docs/cli/command/01_status.md)

---

### INT-7: Exit code 2 on unreadable storage path

**Command:**
```
CLAUDE_STORAGE_ROOT=/tmp/nonexistent-storage-xyz clg .status
```

**Expected behavior:**
- Error message on stderr indicating storage read failure
- No summary on stdout
- Exit code: 2
- **Source:** [command/01_status.md](../../../../docs/cli/command/01_status.md)

---

### INT-8: Output contains project count and session count

**Command:**
```
CLAUDE_STORAGE_ROOT=/tmp/test-fixture clg .status
```

**Expected behavior:**
- Fixture: 3 projects, 5 sessions total in storage
- Output includes labeled project count (`3`) and labeled session count (`5`)
- Exit code: 0
- **Source:** [command/01_status.md](../../../../docs/cli/command/01_status.md)