You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This directory is automatically created and maintained by the SpecStory extension to preserve your AI chat history.
4
-
4
+
5
5
## What's Here?
6
-
6
+
7
7
-`.specstory/history`: Contains auto-saved markdown files of your AI coding sessions
8
8
- Each file represents a separate AI chat session
9
9
- If you enable auto-save, files are automatically updated as you work
@@ -18,16 +18,16 @@ This directory is automatically created and maintained by the SpecStory extensio
18
18
- Add `/history` to exclude the auto-saved chat history from version control
19
19
20
20
## Valuable Uses
21
-
21
+
22
22
- Capture: Keep your context window up-to-date when starting new Chat/Composer sessions via @ references
23
-
- Search: For previous prompts and code snippets
23
+
- Search: For previous prompts and code snippets
24
24
- Learn: Meta-analyze your patterns and learn from your past experiences
25
25
- Derive: Keep the AI on course with your past decisions by automatically deriving rules from your AI interactions
26
-
26
+
27
27
## Version Control
28
-
28
+
29
29
We recommend keeping this directory under version control to maintain a history of your AI interactions. However, if you prefer not to version these files, you can exclude them by adding this to your `.gitignore`:
30
-
30
+
31
31
```
32
32
.specstory/**
33
33
```
@@ -39,31 +39,31 @@ We recommend __not__ keeping the `.specstory/ai_rules_backups` directory under v
39
39
```
40
40
41
41
## Searching Your Codebase
42
-
42
+
43
43
When searching your codebase, search results may include your previous AI coding interactions. To focus solely on your actual code files, you can exclude the AI interaction history from search results.
44
-
44
+
45
45
To exclude AI interaction history:
46
-
46
+
47
47
1. Open the "Find in Files" search in Cursor or VSCode (Cmd/Ctrl + Shift + F)
48
48
2. Navigate to the "files to exclude" section
49
49
3. Add the following pattern:
50
-
50
+
51
51
```
52
52
.specstory/*
53
53
```
54
-
54
+
55
55
This will ensure your searches only return results from your working codebase files.
56
56
57
57
## Notes
58
58
59
59
- Auto-save only works when Cursor or VSCode flushes sqlite database data to disk. This results in a small delay after the AI response is complete before SpecStory can save the history.
60
60
61
61
## Settings
62
-
62
+
63
63
You can control auto-saving behavior in Cursor or VSCode:
64
-
64
+
65
65
1. Open Cursor/Code → Settings → VS Code Settings (Cmd/Ctrl + ,)
66
66
2. Search for "SpecStory"
67
67
3. Find "Auto Save" setting to enable/disable
68
-
69
-
Auto-save occurs when changes are detected in the sqlite database, or every 2 minutes as a safety net.
68
+
69
+
Auto-save occurs when changes are detected in the sqlite database, or every 2 minutes as a safety net.
0 commit comments