@xelth/eck-snapshot 5.4.2 → 5.4.3
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 +18 -11
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,11 +1,20 @@
|
|
|
1
1
|
# eck-snapshot
|
|
2
2
|
|
|
3
|
-
A CLI tool that packs your entire Git repository into a single text file optimized for LLMs
|
|
3
|
+
A CLI tool that packs your entire Git repository into a single text file optimized for LLMs. Give any AI full project context in one copy-paste.
|
|
4
4
|
|
|
5
5
|
```bash
|
|
6
6
|
npm install -g @xelth/eck-snapshot
|
|
7
7
|
```
|
|
8
8
|
|
|
9
|
+
## Recommended AI Setup
|
|
10
|
+
|
|
11
|
+
For best results, we recommend splitting roles between models:
|
|
12
|
+
|
|
13
|
+
- **Architect** (large context window): Gemini, Grok Fast, ChatGPT — upload the full snapshot, design the architecture, plan tasks
|
|
14
|
+
- **Coder** (execution): Claude (via Claude Code), GLM (via OpenCode) — receive tasks from the architect, write and fix code
|
|
15
|
+
|
|
16
|
+
eck-snapshot generates tailored instructions (`CLAUDE.md`, `AGENTS.md`) for each role automatically.
|
|
17
|
+
|
|
9
18
|
## Core Workflow
|
|
10
19
|
|
|
11
20
|
### 1. Full Snapshot
|
|
@@ -17,7 +26,7 @@ eck-snapshot
|
|
|
17
26
|
# -> .eck/snapshots/eckMyProject_26-02-15_12-00_abc1234.md
|
|
18
27
|
```
|
|
19
28
|
|
|
20
|
-
|
|
29
|
+
Upload the file to your architect AI and start working.
|
|
21
30
|
|
|
22
31
|
### 2. Incremental Update
|
|
23
32
|
|
|
@@ -30,14 +39,6 @@ eck-snapshot update
|
|
|
30
39
|
|
|
31
40
|
This uses a Git anchor (saved automatically during full snapshot) to detect all modified files and includes their full content. No redundant diffs, no wasted tokens.
|
|
32
41
|
|
|
33
|
-
### 3. Lazy Loading
|
|
34
|
-
|
|
35
|
-
If the AI asks to see specific files that weren't in the snapshot, show them instantly:
|
|
36
|
-
|
|
37
|
-
```bash
|
|
38
|
-
eck-snapshot show src/auth.rs src/handlers/sync.rs
|
|
39
|
-
```
|
|
40
|
-
|
|
41
42
|
## Context Profiles
|
|
42
43
|
|
|
43
44
|
Large repositories waste tokens on irrelevant code. Profiles let you partition the codebase so the AI only sees what matters.
|
|
@@ -103,7 +104,7 @@ eck-snapshot setup-mcp --both # Setup for Claude Code + OpenCode
|
|
|
103
104
|
|
|
104
105
|
This gives your AI access to specialized workers: `glm_zai_frontend`, `glm_zai_backend`, `glm_zai_qa`, `glm_zai_refactor`, and the `eck_finish_task` commit tool.
|
|
105
106
|
|
|
106
|
-
## Skeleton Mode
|
|
107
|
+
## Skeleton Mode & Lazy Loading
|
|
107
108
|
|
|
108
109
|
For extremely large projects, skeleton mode strips function bodies and keeps only signatures, types, and structure:
|
|
109
110
|
|
|
@@ -111,6 +112,12 @@ For extremely large projects, skeleton mode strips function bodies and keeps onl
|
|
|
111
112
|
eck-snapshot --skeleton
|
|
112
113
|
```
|
|
113
114
|
|
|
115
|
+
When using skeleton mode, the AI can request full content of specific files on demand:
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
eck-snapshot show src/auth.rs src/handlers/sync.rs
|
|
119
|
+
```
|
|
120
|
+
|
|
114
121
|
Useful for initial orientation in massive codebases, but full snapshots with profiles are usually more practical.
|
|
115
122
|
|
|
116
123
|
## Other Commands
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xelth/eck-snapshot",
|
|
3
|
-
"version": "5.4.
|
|
3
|
+
"version": "5.4.3",
|
|
4
4
|
"description": "A powerful CLI tool to create and restore single-file text snapshots of Git repositories and directories. Optimized for AI context and LLM workflows.",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"type": "module",
|