code-context-extractor 0.1.1 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -10
- package/dist/config.js +2 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -16,9 +16,9 @@ CodeContextExtractor is a local-only CLI that captures a deterministic snapshot
|
|
|
16
16
|
npx code-context-extractor extract . --verbose
|
|
17
17
|
```
|
|
18
18
|
|
|
19
|
-
The output is written to
|
|
19
|
+
The output is written to `code-context/` with a timestamped filename like:
|
|
20
20
|
```
|
|
21
|
-
|
|
21
|
+
code-context/<root>_context_YYYY-MM-DD_HHMMSS.txt
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
## Install from npm
|
|
@@ -28,11 +28,11 @@ npx code-context-extractor extract C:\projects\MyNewProject --verbose
|
|
|
28
28
|
|
|
29
29
|
## Important: .gitignore your outputs
|
|
30
30
|
> **Warning ⚠️**
|
|
31
|
-
> CodeContextExtractor writes files into a
|
|
31
|
+
> CodeContextExtractor writes files into a `code-context/` folder inside your project root. If that folder is not ignored, you may accidentally commit and push your context exports.
|
|
32
32
|
|
|
33
33
|
Add this line to your project's `.gitignore`:
|
|
34
34
|
```
|
|
35
|
-
|
|
35
|
+
code-context/
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
## npm and npx (for beginners)
|
|
@@ -64,7 +64,7 @@ code-context-extractor extract . --verbose
|
|
|
64
64
|
|
|
65
65
|
The output will be saved to:
|
|
66
66
|
```
|
|
67
|
-
|
|
67
|
+
.\code-context\MyNewProject_context_YYYY-MM-DD_HHMMSS.txt
|
|
68
68
|
```
|
|
69
69
|
|
|
70
70
|
### macOS/Linux variant
|
|
@@ -75,7 +75,7 @@ code-context-extractor extract . --verbose
|
|
|
75
75
|
```
|
|
76
76
|
The output will be saved to:
|
|
77
77
|
```
|
|
78
|
-
|
|
78
|
+
./code-context/MyNewProject_context_YYYY-MM-DD_HHMMSS.txt
|
|
79
79
|
```
|
|
80
80
|
|
|
81
81
|
## Install from GitHub (beginner-friendly)
|
|
@@ -118,7 +118,7 @@ node dist/cli.js extract . --verbose
|
|
|
118
118
|
- Streaming output (does not load large files into memory)
|
|
119
119
|
- Conservative redaction enabled by default
|
|
120
120
|
- Optional Markdown output
|
|
121
|
-
- Automatic output folder
|
|
121
|
+
- Automatic output folder `code-context/`
|
|
122
122
|
|
|
123
123
|
## Commands
|
|
124
124
|
### Extract
|
|
@@ -132,7 +132,7 @@ code-context-extractor extract ./project --format md --depth 3 --verbose
|
|
|
132
132
|
|
|
133
133
|
## Options
|
|
134
134
|
```bash
|
|
135
|
-
--out <file> Output file (default:
|
|
135
|
+
--out <file> Output file (default: code-context/<root>_context_YYYY-MM-DD_HHMMSS.txt)
|
|
136
136
|
--format <text|md> Output format (default: text)
|
|
137
137
|
--depth <n> Tree depth (default: 4)
|
|
138
138
|
--include <glob> Include glob (repeatable)
|
|
@@ -173,7 +173,7 @@ node_modules
|
|
|
173
173
|
dist
|
|
174
174
|
build
|
|
175
175
|
out
|
|
176
|
-
|
|
176
|
+
code-context
|
|
177
177
|
.next
|
|
178
178
|
.turbo
|
|
179
179
|
.git
|
|
@@ -196,7 +196,7 @@ id_ed25519
|
|
|
196
196
|
Use an optional JSON file (example: `example-config.json`) to set defaults.
|
|
197
197
|
```json
|
|
198
198
|
{
|
|
199
|
-
"outFile": "
|
|
199
|
+
"outFile": "code-context/project_context_2026-01-19_145227.txt",
|
|
200
200
|
"format": "text",
|
|
201
201
|
"depth": 4,
|
|
202
202
|
"include": [],
|
package/dist/config.js
CHANGED
|
@@ -13,7 +13,7 @@ exports.DEFAULT_EXCLUDES = [
|
|
|
13
13
|
'dist/**',
|
|
14
14
|
'build/**',
|
|
15
15
|
'out/**',
|
|
16
|
-
'
|
|
16
|
+
'code-context/**',
|
|
17
17
|
'.next/**',
|
|
18
18
|
'.turbo/**',
|
|
19
19
|
'.git/**',
|
|
@@ -87,7 +87,7 @@ function buildAutoOutFile(rootPath, format) {
|
|
|
87
87
|
pad(now.getDate())
|
|
88
88
|
].join('-');
|
|
89
89
|
const time = [pad(now.getHours()), pad(now.getMinutes()), pad(now.getSeconds())].join('');
|
|
90
|
-
return path_1.default.join('
|
|
90
|
+
return path_1.default.join('code-context', `${rootName}_context_${stamp}_${time}.${ext}`);
|
|
91
91
|
}
|
|
92
92
|
function normalizeFormat(value) {
|
|
93
93
|
return value === 'md' ? 'md' : 'text';
|
package/package.json
CHANGED