-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathwhy.html
More file actions
272 lines (252 loc) · 18.5 KB
/
why.html
File metadata and controls
272 lines (252 loc) · 18.5 KB
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
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Why dumpall? - The Smart File Aggregator for AI Context</title>
<meta name="description" content="Discover why dumpall is the pragmatic way to get code context - simple, fast, and reliable.">
<link rel="icon" href="favicon.ico" type="image/x-icon">
<script src="https://cdn.tailwindcss.com"></script>
<script>
// Customizing Tailwind's default theme to match Terminalist branding
tailwind.config = {
theme: {
extend: {
colors: {
'midnight-blue': '#1A1B26',
'light-gray': '#D4D4D4',
'terminal-green': '#39FF14',
'muted-gray': '#5A5A5A',
'border-dark': '#333440',
},
fontFamily: {
mono: ['"JetBrains Mono"', 'monospace'],
},
}
}
}
</script>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;700&display=swap" rel="stylesheet">
</head>
<body class="text-light-gray font-mono antialiased" style="background: linear-gradient(225deg, #1a1b26 0%, #0f1019 30%, #1a1b26 60%, #252642 100%);">
<!-- Navigation -->
<nav class="w-full border-b border-border-dark">
<div class="max-w-4xl mx-auto px-4 py-4 flex justify-between items-center">
<a href="index.html" class="text-2xl font-bold text-terminal-green">dumpall.</a>
<div class="flex items-center space-x-6">
<a href="index.html" class="text-light-gray hover:text-terminal-green transition-colors">Home</a>
<a href="why.html" class="text-terminal-green font-semibold">Why</a>
<a href="https://github.com/ThisIsntMyId/dumpall" target="_blank" rel="noopener noreferrer" class="text-light-gray hover:text-terminal-green transition-colors flex items-center gap-2">
GitHub
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" class="w-6 h-6">
<path fill="#39FF14" d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3 .3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5 .3-6.2 2.3zm44.2-1.7c-2.9 .7-4.9 2.6-4.6 4.9 .3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM252.8 8c-138.7 0-244.8 105.3-244.8 244 0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1 100-33.2 167.8-128.1 167.8-239 0-138.7-112.5-244-251.2-244zM105.2 352.9c-1.3 1-1 3.3 .7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3 .3 2.9 2.3 3.9 1.6 1 3.6 .7 4.3-.7 .7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3 .7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3 .7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"/>
</svg>
</a>
</div>
</div>
</nav>
<!-- Hero Section -->
<section class="w-full max-w-4xl mx-auto px-4 pt-8 pb-4 text-center">
<h1 class="text-4xl sm:text-5xl font-bold text-terminal-green mb-6">
Why <span class="text-light-gray">dumpall</span>?
</h1>
<p class="text-xl sm:text-2xl mb-8 max-w-3xl mx-auto">
Simple Context, <span class="text-terminal-green">Powerful Workflows</span>
</p>
<p class="text-lg text-muted-gray max-w-2xl mx-auto">
In a world of complex tools, <code class="text-terminal-green">dumpall</code> embraces Unix philosophy: do one thing well.
It's a simple CLI tool that aggregates selected files into a single, structured output – transforming scattered code into actionable context for any need.
</p>
</section>
<!-- Philosophy Section -->
<section class="w-full max-w-4xl mx-auto px-4 py-4">
<div class="bg-border-dark p-8 rounded-lg shadow-lg text-center">
<h2 class="text-3xl font-bold text-terminal-green mb-6">Like <code class="text-light-gray">cat</code> or <code class="text-light-gray">ls</code>, it's a lean building block</h2>
<p class="text-xl text-muted-gray mb-6">
No magic, just structured aggregation you can use anywhere.
<span class="text-terminal-green">Deterministic, local, unlimited, predictable</span> input prep.
</p>
<div class="bg-midnight-blue p-4 rounded-md max-w-2xl mx-auto">
<code class="text-terminal-green">npx dumpall . -e node_modules -e .git</code>
</div>
</div>
</section>
<!-- CLI vs Agents Section -->
<section class="w-full max-w-4xl mx-auto px-4 py-16">
<h2 class="text-3xl font-bold text-terminal-green mb-12 text-center">Why Not Just Use AI Agents?</h2>
<div class="grid md:grid-cols-2 gap-8">
<div class="bg-border-dark p-8 rounded-lg shadow-lg">
<h3 class="text-2xl font-bold text-light-gray mb-4">AI Agents</h3>
<ul class="space-y-3 text-muted-gray">
<li>• Dynamic but opaque</li>
<li>• Limited by tokens & daily caps</li>
<li>• Sometimes unpredictable</li>
<li>• Hide complexity, silently drop files</li>
<li>• Expensive at scale</li>
</ul>
</div>
<div class="bg-border-dark p-8 rounded-lg shadow-lg border-2 border-terminal-green">
<h3 class="text-2xl font-bold text-terminal-green mb-4">dumpall</h3>
<ul class="space-y-3 text-light-gray">
<li>• Deterministic & transparent</li>
<li>• Unlimited, local control</li>
<li>• Always predictable</li>
<li>• Shows exactly what it processes</li>
<li>• Free forever</li>
</ul>
</div>
</div>
</section>
<!-- Use Cases Section -->
<section class="w-full max-w-4xl mx-auto px-4 py-16">
<h2 class="text-3xl font-bold text-terminal-green mb-12 text-center">8 Practical Use Cases</h2>
<div class="space-y-12">
<!-- Use Case 1 -->
<div class="bg-border-dark p-8 rounded-lg shadow-lg">
<h3 class="text-2xl font-bold text-terminal-green mb-4">1. Rapid Code Review & Debugging Prep</h3>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">Pain Point:</h4>
<p class="text-muted-gray">Reviewing a large pull request or debugging a bug across several interconnected files often means constantly opening new tabs, scrolling, and losing context.</p>
</div>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">dumpall Solution:</h4>
<p class="text-muted-gray">Quickly gather all files related to a feature branch or a specific bug. The aggregated output gives you a single, unified view of the relevant code, making it easier to spot inconsistencies, architectural issues, or the root cause of a bug.</p>
</div>
<div class="bg-midnight-blue p-4 rounded-md">
<code class="text-terminal-green">npx dumpall feature-x/ --color</code>
</div>
</div>
<!-- Use Case 2 -->
<div class="bg-border-dark p-8 rounded-lg shadow-lg">
<h3 class="text-2xl font-bold text-terminal-green mb-4">2. Instant Code Sharing & Ad-Hoc Documentation</h3>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">Pain Point:</h4>
<p class="text-muted-gray">Need to share a few related code files with a colleague, put them in a Slack thread, or quickly prepare snippets for a blog post? Manual copying can be slow, especially with formatting.</p>
</div>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">dumpall Solution:</h4>
<p class="text-muted-gray">dumpall aggregates your files into a clean, Markdown-formatted output. Copy to clipboard (--clip) and paste anywhere. This provides a consistent, readable format that includes file paths as headings, maintaining context better than raw text dumps.</p>
</div>
<div class="bg-midnight-blue p-4 rounded-md">
<code class="text-terminal-green">npx dumpall ./src --clip</code>
</div>
</div>
<!-- Use Case 3 -->
<div class="bg-border-dark p-8 rounded-lg shadow-lg">
<h3 class="text-2xl font-bold text-terminal-green mb-4">3. Effortless Context for AI (Smart Prompting)</h3>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">Pain Point:</h4>
<p class="text-muted-gray">Modern AI agents hide complexity and silently drop files, overshoot token limits, or misinterpret context. Even with @ mentions, they often fail to reference critical files. Web-based AI chat versions work better with document input, but getting that document is manual. Plus, even pro plans (Cursor, Claude, Gemini) hit daily/token caps fast.</p>
</div>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">dumpall Solution:</h4>
<p class="text-muted-gray">dumpall gives you unlimited, local control. Precisely curate the exact set of files (and exclude noise like node_modules) to feed to an AI. It produces a clean, structured Markdown document perfect for pasting into an AI chat (web or CLI) or for generating embeddings. No token limits, no daily caps, no hidden complexity.</p>
</div>
<div class="bg-midnight-blue p-4 rounded-md">
<code class="text-terminal-green">npx dumpall . -e node_modules -e .git --clip</code>
</div>
</div>
<!-- Use Case 4 -->
<div class="bg-border-dark p-8 rounded-lg shadow-lg">
<h3 class="text-2xl font-bold text-terminal-green mb-4">4. Bridging CLI to Browser-based AI</h3>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">Pain Point:</h4>
<p class="text-muted-gray">You're working in your terminal, but your preferred AI model is a web-based chat interface (e.g., ChatGPT, Claude, GitHub Copilot Chat in browser). Manually opening, copying, and pasting multiple files is tedious and error-prone.</p>
</div>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">dumpall Solution:</h4>
<p class="text-muted-gray">With a single command, dumpall . --clip, you can scoop up your entire folder's relevant code (excluding specified files) and instantly have it ready in your clipboard. Just a quick Ctrl/Cmd+V in your browser, and your AI has all the context it needs.</p>
</div>
<div class="bg-midnight-blue p-4 rounded-md">
<code class="text-terminal-green">npx dumpall . --clip</code>
</div>
</div>
<!-- Use Case 5 -->
<div class="bg-border-dark p-8 rounded-lg shadow-lg">
<h3 class="text-2xl font-bold text-terminal-green mb-4">5. Building Custom Knowledge Bases & Code Snippet Collections</h3>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">Pain Point:</h4>
<p class="text-muted-gray">Managing a personal or team-shared knowledge base of useful code patterns. Copying and organizing snippets from live projects can be a fragmented process.</p>
</div>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">dumpall Solution:</h4>
<p class="text-muted-gray">Extract specific folders or file types to quickly populate your custom knowledge base. The structured output ensures your snippets retain their source context, making them more discoverable and reusable later.</p>
</div>
<div class="bg-midnight-blue p-4 rounded-md">
<code class="text-terminal-green">npx dumpall utils/sql --clip</code>
</div>
</div>
<!-- Use Case 6 -->
<div class="bg-border-dark p-8 rounded-lg shadow-lg">
<h3 class="text-2xl font-bold text-terminal-green mb-4">6. Scripting & Automation Input</h3>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">Pain Point:</h4>
<p class="text-muted-gray">Many automation tasks (e.g., custom linters, static analysis, transformation scripts) require feeding an aggregated view of code, not just individual files. Building this aggregation logic from scratch in scripts can be complex.</p>
</div>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">dumpall Solution:</h4>
<p class="text-muted-gray">dumpall adheres to Unix principles by being pipe-friendly. Its output can be easily redirected or piped directly to other CLI tools, making it a powerful building block in custom shell scripts, CI/CD pipelines, or automation workflows.</p>
</div>
<div class="bg-midnight-blue p-4 rounded-md">
<code class="text-terminal-green">npx dumpall . > all_code.md</code>
</div>
</div>
<!-- Use Case 7 -->
<div class="bg-border-dark p-8 rounded-lg shadow-lg">
<h3 class="text-2xl font-bold text-terminal-green mb-4">7. Overcoming Manual Copy-Pasting Headaches</h3>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">Pain Point:</h4>
<p class="text-muted-gray">The sheer inefficiency and frustration of manually navigating a file tree, selecting text from multiple files, and copy-pasting them one by one. This is a repetitive, error-prone task that breaks focus.</p>
</div>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">dumpall Solution:</h4>
<p class="text-muted-gray">This tool exists to eliminate this tedious manual labor. One command, and all your desired files are instantly consolidated, formatted, and ready for use. It's about saving developer time and cognitive load, focusing on what matters: solving problems, not tedious data aggregation.</p>
</div>
<div class="bg-midnight-blue p-4 rounded-md">
<code class="text-terminal-green">npx dumpall . -e node_modules -e .git</code>
</div>
</div>
<!-- Use Case 8 -->
<div class="bg-border-dark p-8 rounded-lg shadow-lg">
<h3 class="text-2xl font-bold text-terminal-green mb-4">8. Lean, Unix-Philosophied Simplicity</h3>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">Pain Point:</h4>
<p class="text-muted-gray">Many "all-in-one" code tools are bloated, slow, or have steep learning curves. Sometimes you just need a straightforward utility that does one job extremely well.</p>
</div>
<div class="mb-4">
<h4 class="text-lg font-semibold text-light-gray mb-2">dumpall Solution:</h4>
<p class="text-muted-gray">dumpall is designed to be minimal, fast, and easy to use. It sticks to the Unix philosophy: a simple CLI command that combines files. It doesn't try to be an IDE, a linter, or a full AI agent; it's a powerful pre-processing step that empowers other tools and workflows.</p>
</div>
<div class="bg-midnight-blue p-4 rounded-md">
<code class="text-terminal-green">npx dumpall --help</code>
</div>
</div>
</div>
</section>
<!-- Call to Action -->
<section class="w-full max-w-4xl mx-auto px-4 py-16 text-center">
<h2 class="text-3xl font-bold text-terminal-green mb-8">Ready to Get Started?</h2>
<p class="text-lg text-muted-gray mb-8 max-w-2xl mx-auto">
Experience the power of simple, structured code aggregation. One command, infinite possibilities.
</p>
<div class="bg-border-dark p-4 rounded-lg flex items-center justify-center space-x-4 mb-8">
<code class="text-lg text-light-gray">npx dumpall . -e node_modules</code>
<button class="bg-terminal-green text-midnight-blue px-4 py-2 rounded-md font-bold text-lg hover:bg-opacity-80 transition-colors duration-200"
onclick="navigator.clipboard.writeText('npx dumpall . -e node_modules -e .git'); alert('Command copied!')">
Copy
</button>
</div>
<a href="index.html" class="text-terminal-green hover:underline text-lg">← Back to Home</a>
</section>
<!-- Footer -->
<footer class="w-full py-8 text-center border-t border-border-dark mt-16">
<p class="text-muted-gray text-sm">© 2023 dumpall. All rights reserved.</p>
<p class="mt-2">
<a href="https://github.com/ThisIsntMyId/dumpall" target="_blank" rel="noopener noreferrer"
class="text-terminal-green hover:underline">View on GitHub</a>
</p>
</footer>
</body>
</html>