PortaCodigo

Generate a TXT file with the directory structure and content of selected files in your Visual Studio Code project. Perfect for quick code reviews, documentation, or sharing snippets.

📦 Installation

Clone the repository:

git clone https://github.com/GuillermoEstefaniMonarrez/portacodigo.git

Install dependencies and compile:bash

cd portacodigo pnpm install pnpm run compile

Launch the extension in a development environment from VS Code by pressing F5.

FeaturesSelection View: A tree in the VS Code Explorer to add or remove files and code snippets. Set Management: Create, clone, rename, delete, and split sets of selected files. TXT Generation: Generate a .txt file including:Directory structure. Full content of selected files. Optional date, project, and context details.

ZIP Generation: Package selected files into a .zip. Editable Preview: View and edit generated content before exporting. Clipboard Support: Copy preview content directly to the clipboard. Character Limits: Configure limits with options like "ChatGPT Free" or "Custom". Automatic Localization: English and Spanish support based on VS Code’s language.

Available CommandsCommand Description portacodigo.addToSelection Add a file or folder to the selection. portacodigo.removeFromSelection Remove an item from the selection. portacodigo.generateTxt Generate and open a .txt file with your selection. portacodigo.openEditablePreview Open an editable preview of the content. portacodigo.saveEditedPreview Save the edited preview as a .txt file. portacodigo.copyToClipboard Copy the preview content to the clipboard. portacodigo.generateZip Generate a .zip with the selected files. portacodigo.savePreviewAs Save the current preview with a custom name. portacodigo.clearSelection Clear the current selection. portacodigo.createNewSet Create a new selection set. portacodigo.cloneSet Clone an existing set. portacodigo.renameSet Rename a set46. portacodigo.deleteSet Delete a set. portacodigo.addToAnotherSet Add files to another set. portacodigo.moveToAnotherSet Move files to another set. portacodigo.splitSet Split a set exceeding the character limit. portacodigo.setCharLimit Set the character limit for the set.

ConfigurationAdd or adjust these options in your settings.json:json

{ // Default limit selection (ChatGPT Free, Grok Premium, Custom) "portacodigo.selectedLimit": "Custom",

// Character limits per option "portacodigo.charLimit": { "ChatGPT Free": 4096, "Grok Premium": 10000, "Custom": 10000 },

// Glob patterns to exclude "portacodigo.excludePatterns": [ "node_modules/**", "*.log" ],

// Sort files alphabetically in the TXT "portacodigo.sortAlphabetically": true,

// Confirm removal of an item "portacodigo.confirmRemove": false }

Usage ExampleRight-click a file or folder:Select PortaCodigo: Add to Selection.

Add multiple items (full files or selected lines). Open the Command Palette (Ctrl+Shift+P) and run PortaCodigo: Generate TXT. Edit in the preview or save directly. To create a ZIP, run PortaCodigo: Generate ZIP.

Known IssuesIf the character limit is exceeded, the extension suggests splitting into parts or by file. Complex exclusion patterns are not supported (only simple globs).

Version History0.0.4: Added advanced set management, ZIP generation, and localization enhancements. 0.0.3: Introduced savePreviewAs command, improved state and localization. 0.0.2: Fixed bugs in preview and character counting. 0.0.1: Initial release with file selection, tree view, and TXT generation.

PortaCodigo

Guillermo Estefani Monarrez

PortaCodigo

📦 Installation