feat(output): Add tree-only mode for structure-only output

Add -T/--tree-only flag to output just the file structure without
file contents. This is useful for sharing project layout with LLMs
without overwhelming context with full file contents.

- Add CLI flag with short (-T) and long (--tree-only) forms
- Add T keybinding to toggle tree-only mode in interactive TUI
- Update markdown and text templates to conditionally render files
- Update documentation with new option and example usage

Author: epilande

README.md

@@ -27,6 +27,7 @@ to your clipboard, ready for LLM processing.
 - ⏳ **Temp File**: Generate the output file in your system's temporary directory
 - 📋 **Clipboard Integration**: Copy content or output file directly to your clipboard
 - 🌲 **Directory Tree View**: Display a tree-style view of your project structure
+- 🌳 **Tree-Only Mode**: Output just the file structure without contents using `-T` flag
 - 🧮 **Token Estimation**: Get estimated token count for LLM context windows
 - 🛡️ **Secret Detection & Redaction**: Uses [gitleaks](https://github.com/gitleaks/gitleaks) to identify potential secrets and prevent sharing sensitive information
 - 🔗 **Dependency Resolution**: Automatically include dependencies for Go, JS/TS, Python when using the `--deps` flag
@@ -108,6 +109,7 @@ grab [options] [directory]
 | `--theme <name>`         | Set the UI theme. Available: catppuccin-latte, catppuccin-frappe, catppuccin-macchiato, catppuccin-mocha, rose-pine, rose-pine-dawn, rose-pine-moon, dracula, nord. (default: `"catppuccin-mocha"`). |
 | `--show-tokens`          | Show the number of tokens for each file in file tree.                                                                                                                                                |
 | `--icons`                | Display Nerd Font icons.                                                                                                                                                                             |
+| `-T, --tree-only`        | Output only file structure without contents. Useful for sharing project layout with LLMs.                                                                                                           |
 
 ### 📖 Examples
 
@@ -177,6 +179,12 @@ grab [options] [directory]
     grab git@github.com:user/repo.git
     ```
 
+12. Output only the project structure (no file contents):
+
+    ```bash
+    grab -T -n
+    ```
+
 ## ⌨️ Keyboard Controls
 
 ### Navigation
@@ -211,6 +219,7 @@ grab [options] [directory]
 | Toggle Dependency Resolution | <kbd>D</kbd>                       | Enable/disable automatic dependency resolution for Go & JS/TS (Default: Off) |
 | Cycle output formats         | <kbd>F</kbd>                       | Cycle through available output formats (markdown, text, xml)                 |
 | Toggle Secret Redaction      | <kbd>S</kbd>                       | Enable/disable automatic secret redaction (Default: On)                      |
+| Toggle Tree-Only Mode        | <kbd>T</kbd>                       | Output only file structure without contents (Default: Off)                   |
 
 ### View Options
 

cmd/grab/main.go

@@ -50,6 +50,7 @@ func main() {
 	var maxFileSizeStr string
 	var showIcons bool
 	var showTokenCount bool
+	var treeOnly bool
 
 	flag.BoolVar(&showHelp, "help", false, "Display help information")
 	flag.BoolVar(&showHelp, "h", false, "Display help information (shorthand)")
@@ -92,6 +93,9 @@ func main() {
 
 	flag.BoolVar(&showTokenCount, "show-tokens", false, "Show the number of tokens for each file")
 
+	flag.BoolVar(&treeOnly, "tree-only", false, "Output only file structure without contents")
+	flag.BoolVar(&treeOnly, "T", false, "Output only file structure (shorthand)")
+
 	flag.Parse()
 
 	if showHelp {
@@ -187,7 +191,7 @@ func main() {
 	}
 
 	if nonInteractive {
-		runNonInteractive(root, filterMgr, outputPath, useTempFile, formatName, skipRedaction, resolveDeps, maxDepth, maxFileSize)
+		runNonInteractive(root, filterMgr, outputPath, useTempFile, formatName, skipRedaction, resolveDeps, maxDepth, maxFileSize, treeOnly)
 	} else {
 		config := model.Config{
 			RootPath:       root,
@@ -201,6 +205,7 @@ func main() {
 			ShowTokenCount: showTokenCount,
 			MaxDepth:       maxDepth,
 			MaxFileSize:    maxFileSize,
+			TreeOnly:       treeOnly,
 		}
 
 		m := model.NewModel(config)
@@ -213,7 +218,7 @@ func main() {
 }
 
 // runNonInteractive processes files and generates output without user interaction
-func runNonInteractive(rootPath string, filterMgr *filesystem.FilterManager, outputPath string, useTempFile bool, formatName string, skipRedaction bool, resolveDeps bool, maxDepth int, maxFileSize int64) {
+func runNonInteractive(rootPath string, filterMgr *filesystem.FilterManager, outputPath string, useTempFile bool, formatName string, skipRedaction bool, resolveDeps bool, maxDepth int, maxFileSize int64, treeOnly bool) {
 	gitIgnoreMgr, err := filesystem.NewGitIgnoreManager(rootPath)
 	if err != nil {
 		log.Fatalf("Error reading .gitignore: %v\n", err)
@@ -301,6 +306,7 @@ func runNonInteractive(rootPath string, filterMgr *filesystem.FilterManager, out
 	format := formats.GetFormat(formatName)
 	gen.SetFormat(format)
 	gen.SetRedactionMode(!skipRedaction)
+	gen.SetTreeOnlyMode(treeOnly)
 
 	gen.SelectedFiles = selectedFiles
 

internal/generator/formats/markdown.go

@@ -44,13 +44,12 @@ const markdownTemplate = `# Project Structure
 
 ` + "```" + `
 {{.Structure}}` + "```" + `
-
+{{if .Files}}
 # Project Files
 {{range .Files}}
 ## File: ` + "`" + `{{.Path}}` + "`" + `
 
 ` + "```" + `{{.Language}}
 {{.Content}}
 ` + "```" + `
-{{end}}
-`
+{{end}}{{end}}`

internal/generator/formats/text.go

@@ -57,7 +57,7 @@ PROJECT STRUCTURE
 {{separator}}
 
 {{.Structure}}
-
+{{if .Files}}
 {{separator}}
 PROJECT FILES
 {{separator}}
@@ -67,5 +67,4 @@ FILE: {{.Path}}
 {{separator .Path}}
 
 {{.Content}}
-{{end}}
-`
+{{end}}{{end}}`

internal/generator/generator.go

@@ -26,6 +26,7 @@ type Generator struct {
 	UseGitIgnore    bool
 	ShowHidden      bool
 	RedactSecrets   bool
+	TreeOnly        bool
 	lastSecretCount int
 }
 
@@ -75,6 +76,11 @@ func (g *Generator) SetRedactionMode(redact bool) {
 	g.RedactSecrets = redact
 }
 
+// SetTreeOnlyMode enables or disables tree-only output (structure without file contents).
+func (g *Generator) SetTreeOnlyMode(treeOnly bool) {
+	g.TreeOnly = treeOnly
+}
+
 // Generate creates an output file in the specified format
 func (g *Generator) Generate() (string, int, int, error) {
 	if len(g.SelectedFiles) == 0 {
@@ -211,7 +217,9 @@ func (g *Generator) PrepareTemplateData() (TemplateData, error) {
 	}
 
 	var filesData []FileData
-	collectFiles(rootNode, &filesData, g.RootPath, &g.SecretScanner)
+	if !g.TreeOnly {
+		collectFiles(rootNode, &filesData, g.RootPath, &g.SecretScanner)
+	}
 
 	secretCount := 0
 

internal/model/init_update.go

@@ -471,6 +471,15 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 			}
 			m.warningMsg = ""
 			m.refreshViewportContent()
+		case "T":
+			m.treeOnly = !m.treeOnly
+			m.generator.SetTreeOnlyMode(m.treeOnly)
+			if m.treeOnly {
+				m.successMsg = "Tree-only mode enabled (structure only)"
+			} else {
+				m.successMsg = "Tree-only mode disabled (full output)"
+			}
+			m.refreshViewportContent()
 		case "P":
 			// Toggle preview pane
 			m.showPreview = !m.showPreview

internal/model/model.go

@@ -70,6 +70,7 @@ type Model struct {
 	currentPreviewPath    string
 	currentPreviewContent string
 	currentPreviewIsDir   bool
+	treeOnly              bool
 	lastKeyTime           int64  // Last key press time
 	lastKey               string // Last key pressed
 	tokenCache            *TokenCache
@@ -87,6 +88,7 @@ type Config struct {
 	ResolveDeps    bool
 	ShowIcons      bool
 	ShowTokenCount bool
+	TreeOnly       bool
 }
 
 // updatePreview reads the content of the file at the cursor and updates the preview viewport
@@ -193,6 +195,7 @@ func NewModel(config Config) Model {
 	format := formats.GetFormat(config.Format)
 	gen.SetFormat(format)
 	gen.SetRedactionMode(!config.SkipRedaction)
+	gen.SetTreeOnlyMode(config.TreeOnly)
 
 	moduleName := dependencies.ReadGoModFile(config.RootPath)
 
@@ -225,6 +228,7 @@ func NewModel(config Config) Model {
 		cursor:         0,
 		showTokenCount: config.ShowTokenCount,
 		showPreview:    false,
+		treeOnly:       config.TreeOnly,
 		tokenCache:     NewTokenCache(),
 	}
 }

internal/ui/help.go

@@ -21,6 +21,7 @@ Selection & Output:
   D                        Toggle automatic dependency resolution (Go, TS/JS)
   F                        Cycle through output formats (md, txt, xml)
   S                        Toggle secret redaction (Default: On)
+  T                        Toggle tree-only mode (structure without contents)
 
 View Options:
   i                        Toggle .gitignore filter
@@ -66,6 +67,7 @@ const UsageText = `Usage:
                              rose-pine-moon, dracula, nord. (default: "catppuccin-mocha").
     --show-tokens            Show the number of tokens for each file in file tree.
     --icons                  Display Nerd Font icons.
+    -T, --tree-only          Output only file structure without contents.
 
   Examples:
     # Run interactively in the current directory