VSFileTools

Een VSCode extensie met file management tools, AI-powered Git documentatie prompts, en GitHub workflow automation.

Features

Deze extensie biedt de volgende functionaliteit:

📁 File Management Tools

Merge Files: Voeg meerdere bestanden samen in één uitvoerbestand
List Files: Genereer een lijst van alle bestanden in een map
Count Lines per File: Tel het aantal regels per bestand
Insert Filename: Voeg de relatieve bestandsnaam toe aan het begin van bestanden
Generate Port Assignments: Genereer deterministische poorten voor je project
Generate Secret Keys: Genereer veilige secret keys voor .env bestanden

🚀 GitHub Issue/PR/WIP Workflow

Makefile-based GitHub workflow voor streamlined issue en PR management
Automatic branch creation van GitHub issues (feat/fix/docs)
WIP (Work In Progress) branches voor experimentation zonder issue
Auto-linking PRs to issues met "Fixes #123" syntax
Dependency management met setup scripts (git, gh CLI, jq)
Interactive VS Code commands voor alle workflow stappen
Conventional Commits workflow support

👉 Lees de volledige Makefile Workflow guide

📦 Project Makefile Integration

Dynamic Makefile parsing - Laad en parse je bestaande Makefile
Visual sidebar menu - Categorized targets met emoji icons
One-click execution - Run targets direct vanuit de sidebar
Compatibility scoring - Automatische assessment van Makefile structuur
Live reload - Automatische updates bij Makefile wijzigingen
AI-powered optimizer - Prompt om Makefile te verbeteren voor extensie

👉 Lees de volledige Project Makefile guide

🐛 GitHub Issues Browser

Interactive issue management - Browse, filter en sort GitHub issues
Smart filtering - Filter op label, zoek in titels
Flexible sorting - Sort op nummer, titel (A-Z) of datum
One-click access - Open issues in terminal of browser
Auto-detection - Herkent automatisch je GitHub repository
Real-time loading - Via GitHub CLI (gh)
Workflow integration - Creëer nieuwe issues via Makefile Workflow

👉 Lees de volledige GitHub Issues Browser guide

🤖 AI-Powered Git Documentation

20 Specialized AI Prompts voor comprehensive Git project documentation
7 Chat Participants georganiseerd per workflow:
- @vsfiletools-analysis — Strategic analysis & architecture (Group A)
- @vsfiletools-daily — Daily workflow operations (Group B)
- @vsfiletools-export — Feature bundling & export (Group C)
- @vsfiletools-governance — Governance & meta-level tracking (Group D)
- @vsfiletools-workflows — Complete end-to-end workflows (Group E)
- @vsfiletools-infrastructure — Runtime & deployment discovery (Group F)
- @vsfiletools-makefile — Makefile tools & automation (Group M)
Execution Tracking: Automatische logging in docs/meta/PROMPT_EXECUTION_LEDGER.json
Interactive Sidebar Menu: Visual overzicht van alle prompts met status indicators
Git Context Integration: Automatisch verzamelen van branch, status en commit info
Codex CLI gebruik: Open de prompt-bestanden in prompts/, volg het CODEX CONTEXT blok (negeer Copilot-instructies) en log handmatig; auto-logging werkt alleen via de extensie

🎯 Gebruik

GitHub Workflow (Quick Start)

Initialize Makefile Workflow
- Command Palette: VSFileTools: Initialize Makefile Workflow
- Checks/initializes git repository (met main branch)
- Configures GitHub remote indien nodig
- Creates .env bestand met repository configuratie
- Generates Makefile (append bij bestaande Makefile)
- Automatically runs make setup om dependencies te checken
Check Dependencies
- Command: VSFileTools: Run Makefile Setup
- Installs/verifies: git, GitHub CLI, jq
- Remote SSH? See GitHub Authentication Guide
Start Working on Issue
- Command: VSFileTools: Start Working on Issue
- Select from open issues
- Auto-creates correct branch type
Create Pull Request
- Command: VSFileTools: Create Pull Request
- Auto-links to issue with "Fixes #123"

Terminal Commands:

make help              # Show all commands
make new-issue         # Create GitHub issue
make issue 37          # Start working on issue [#37](https://github.com/brechtparmentier/vscodeExt_combineFilesToOne/issues/37)
make start-wip         # Start WIP branch
make pr 37             # Create PR for issue [#37](https://github.com/brechtparmentier/vscodeExt_combineFilesToOne/issues/37)
make cleanup-branch    # Delete merged branch

Open Explorer (Ctrl+Shift+E)
Find "Makefile Workflow" panel onderaan de sidebar
Click op buttons voor:
- 🚀 Initialize Makefile - Setup workflow in project
- 🔍 Run Setup Check - Verify dependencies
- ➕ Create New Issue - Interactive wizard
- 🌿 Start Working on Issue - Select & create branch
- 🎯 Create Pull Request - Auto-link to issue
- 🚧 Start WIP Branch - Experiment zonder issue
- 🔄 Convert WIP to Issue - Promote WIP branch

Visual interface met alle workflow commands in één overzicht! 🎨

Open Explorer (Ctrl+Shift+E)
Find "Project Makefile" panel onderaan de sidebar
Bekijk gegroepeerde targets met:
- Category sections met emoji icons (⚙️ Setup, 🔨 Build, 🧪 Test, etc.)
- Target descriptions uit je Makefile comments
- Compatibility score (80-100% = optimaal)
- Dependency tags voor .PHONY en target dependencies
Click op een target button om deze uit te voeren
Gebruik 🔄 Reload om wijzigingen te laden
Gebruik ✨ Optimize om je Makefile te verbeteren (AI prompt)

Werkt met elke Makefile - geen speciale syntax vereist, maar gestructureerde Makefiles krijgen hogere compatibility scores! 📦

Open Explorer (Ctrl+Shift+E)
Find "GitHub Issues" panel onderaan de sidebar
Klik 🔄 Reload om issues te laden van GitHub
Gebruik filter controls:
- 🔍 Title Search - Zoek in issue titels
- 🏷️ Label Filter - Filter op specifieke labels
- 📊 Sort Options - Sort op nummer, titel (A-Z) of datum
Klik op issue card om te openen in terminal
Rechts-klik op card om in browser te openen
Klik ➕ New Issue om nieuwe issue te creëren

Smart filtering en sorting voor efficiënt issue management! 🐛

File Management Tools

Rechtsklik op een bestand of map in de Explorer en kies een optie uit het VSFileTools submenu.

AI Prompts via Copilot Chat

Open Copilot Chat (Ctrl+Alt+I) en gebruik de chat participants:

@vsfiletools-daily /B1 Add new feature X to roadmap
@vsfiletools-analysis /A1 Analyze project structure
@vsfiletools-governance /D4 Show execution history

Gebruik /help om alle beschikbare prompts in een groep te zien:

@vsfiletools-daily /help

Open Explorer (Ctrl+Shift+E)
Find "VSFileTools AI Prompts" panel onderaan
Find "VSFileTools AI Prompts" panel onderaan
Click op een prompt om deze uit te voeren

Codex integration

De extensie ondersteunt nu het exporteren van prompts voor gebruik buiten VS Code (bijv. Codex/Copilot-CLI).

Run VSFileTools: Export Prompts For Codex of gebruik het command extension.exportPromptsForCodex om alle prompts te exporteren naar een prompts-codex/ map in de workspace.
Prompt-bestanden bevatten nu  metadata om platform-specifieke instructies te scheiden.
Er is een helper om ontbrekende tags toe te voegen: pnpm run prompts:tag.

De export maakt per prompt een map met meta.json en een schone .md (VS Code-specifieke COPILOT-secties verwijderd) zodat de prompts gemakkelijker buiten de extensie gebruikt kunnen worden.

Port Calculator

De Port Calculator feature genereert deterministische poorten voor je project op basis van de projectnaam:

Rechtsklik in de Explorer en selecteer VSFileTools > Generate Port Assignments
De extensie genereert poorten voor:
- Frontend - Voor web applicaties en UI
- Backend - Voor server/API backend
- API - Voor REST/GraphQL endpoints
- Docs - Voor documentatie server

De gegenereerde poorten worden:

Toegevoegd aan .env (indien het bestand bestaat)
Toegevoegd aan of aangemaakt in .env.example
Gedocumenteerd in .github/copilot-instructions.md (wordt aangemaakt indien niet aanwezig)

Voordelen:

Consistent dezelfde poorten per project
Vermijdt veelgebruikte poorten (3000, 5432, 8080, etc.)
Geen port conflicts tussen projecten
Automatische documentatie voor team members en Copilot

📚 AI Prompts Reference

De extensie bevat 17 gespecialiseerde AI prompts verdeeld over 4 groepen. Alle prompts zijn ontworpen om comprehensive Git-based documentatie te genereren voor je project.

Group A: Strategic Analysis & Architecture (@vsfiletools-analysis)

A1 - Project Mapping (Quick) (/A1)

Snelle project overview met essentiële architectuur
Top 3-5 risico's en quick wins
Compacte output (max 2000 woorden)
💡 Start hier voor eerste inzicht

A1x - Project Mapping (Extended) (/A1x)

Uitgebreide analyse met 10 gedetailleerde documenten
Volledige tech stack verdieping (Next.js/Python/clasp)
Complete module, API, en data mapping
Gebruik na A1 voor deep dive

A2 - Core Architecture (/A2)

Documenteert de core technical architecture
Analyseert design patterns en beslissingen
Output: docs/ARCHITECTURE.md

A3 - Development Guide (/A3)

Creëert een comprehensive development guide
Setup instructies, workflows, best practices
Output: docs/DEVELOPMENT.md

A4 - Strategic Roadmap (/A4)

Bouwt een strategic product roadmap
Features, milestones, technical debt tracking
Output: docs/ROADMAP.md

Group B: Daily Workflow Operations (@vsfiletools-daily)

B1 - Feature Planning (/B1)

Plan nieuwe features met impact analysis
Output: docs/features/FEATURE_[name]_PLANNING.md

B2 - Sprint Planning (/B2)

Sync project roadmap voor nieuwe sprint
Analyseer current state, plan next steps
Output: Updates docs/ROADMAP.md

B3 - Cross-Branch Sync (/B3)

Sync planning tussen branches
Track parallel development streams
Output: Updates roadmap met sync info

B4 - Feature Implementation Report (/B4)

Documenteer completed feature implementation
Inclusief changes, testing, deployment notes
Output: docs/features/FEATURE_[name]_IMPLEMENTATION.md

B5 - Session Log (/B5)

Creëer gedetailleerde session development log
Track beslissingen, changes, context
Output: docs/sessions/SESSION_[timestamp].md

B6 - Cross-Reference Update (/B6)

Synchroniseer cross-references tussen documenten
Ensure consistency across documentation
Updates: Multiple docs met reference links

B7 - Feature Manifest Update (/B7)

Update master feature manifest
Track alle features met status en metadata
Output: docs/FEATURE_MANIFEST.md

B8 - Issue Resolution (/B8)

Document bug fixes en issue resolutions
Root cause analysis en solution details
Output: docs/issues/ISSUE_[id]_RESOLUTION.md

Group C: Export & Packaging (@vsfiletools-export)

C1 - Feature Bundle Export (/C1)

Bundel een complete feature voor export/reuse
Inclusief code, docs, config, tests
Output: Gestructureerde export in features-export/

Group D: Governance & Meta-Level Tracking (@vsfiletools-governance)

D1 - Validation Report (/D1)

Valideer alle documentatie op consistency
Check broken links, outdated info, gaps
Output: docs/meta/VALIDATION_REPORT.md

D2 - Sync Activity Report (/D2)

Genereer cross-branch sync activity report
Track merge patterns, conflicts, resolution
Output: docs/meta/SYNC_ACTIVITY_REPORT.md

D3 - Governance Audit (/D3)

Complete governance en compliance audit
Review documentation standards, completeness
Output: docs/meta/GOVERNANCE_AUDIT.md

D4 - Execution History (/D4)

Show prompt execution history met analytics
Track welke prompts zijn gebruikt wanneer
Output: Console output + docs/meta/PROMPT_EXECUTION_LEDGER.json

Group E: Complete Workflows (@vsfiletools-workflows)

E1 - Issue to PR Flow (/E1)

Complete workflow: GitHub issue → branch → development → PR
Automated branch creation, commit flow, PR generation
Integrates with GitHub Issues API

E2 - Port Assignment Integration (/E2)

Workflow for port calculator integration
Generates port assignments for development services
Updates configuration files automatically

Group F: Infrastructure & Runtime (@vsfiletools-infrastructure)

F1 - Runtime Discovery (/F1)

Discover all project startup/stop/restart methods
Analyze ports, URLs (localhost, local IP, VPN)
Detect configuration conflicts across files
Output: PROJECT_RUNTIME.json + PROJECT_RUNTIME.md

Group M: Makefile Tools (@vsfiletools-makefile)

M1 - Makefile Optimizer (/M1)

Analyze and optimize existing Makefile structure
Suggest improvements for targets, dependencies, variables
Output: Optimized Makefile suggestions

M2 - Makefile Generator (/M2)

Generate complete Makefile from project structure
Auto-detect build systems, languages, frameworks
Output: Production-ready Makefile with common targets

💡 Gebruik Tips

Via Chat:

@vsfiletools-analysis /A1
@vsfiletools-daily /B2 Planning for Q2 sprint
@vsfiletools-governance /D1

Via Sidebar:

Open Explorer (Ctrl+Shift+E)
Scroll naar "VSFileTools AI Prompts" panel
Click op een prompt naam
Prompt wordt uitgevoerd in Copilot Chat

Execution Tracking: Alle prompt executions worden automatisch gelogd in docs/meta/PROMPT_EXECUTION_LEDGER.json met:

Timestamp
Branch name
Prompt ID en user input
Generated output paths

Context Integration: Prompts verzamelen automatisch:

Current Git branch
Working directory status
Active file information
Project structure details

Deze context wordt meegestuurd naar het language model voor accurate en project-specifieke responses.

Configuratie

De extensie kan worden geconfigureerd via VS Code instellingen of via een vsfiletools.config.json bestand in de root van je project.

Algemene Configuratie

{
  "vsFileTools.excludedDirs": [".git", "node_modules", ".next"],
  "vsFileTools.excludedFiles": [],
  "vsFileTools.excludedExtensions": [".log"],
  "vsFiletools.githubToken": "" // Optional: For Remote SSH scenarios
}

GitHub Authentication (Remote SSH)

Voor Remote SSH scenarios waar gh auth login niet werkt:

Create Personal Access Token:
- Go to: https://github.com/settings/tokens
- Scopes: repo, read:org

Configure in VS Code:

{
  "vsfiletools.githubToken": "ghp_your_token_here"
}

Reload VS Code: Developer: Reload Window

See: GitHub Authentication Troubleshooting Guide voor gedetailleerde setup.

Count Lines per File - Specifieke Configuratie

De Count Lines per File functie heeft specifieke configuratie-opties:

vsFileTools.countLines.includedExtensions

Standaard waarde: Een uitgebreide lijst met veel voorkomende code-extensies zoals .js, .ts, .py, .java, .cpp, .html, .css, .md, etc.

Beschrijving: Alleen bestanden met deze extensies worden meegenomen bij het tellen van regels. Alle andere extensies worden genegeerd.

Voorbeeld configuratie:

{
  "vsFileTools.countLines.includedExtensions": [
    ".js",
    ".ts",
    ".tsx",
    ".jsx",
    ".py",
    ".md"
  ]
}

vsFileTools.countLines.excludedDirs

Standaard waarde: [".git", "node_modules", ".next", "dist", "build", "out", ".vscode", ".idea", "coverage", ".pytest_cache", "__pycache__", "venv", ".env", "target", "bin", "obj"]

Beschrijving: Deze directories worden overgeslagen bij het scannen naar bestanden.

vsFileTools.countLines.showSummary

Standaard waarde: true

Beschrijving: Toont een uitgebreide samenvatting bovenaan het rapport met:

Totaal aantal bestanden
Totaal aantal regels code
Gemiddeld aantal regels per bestand
Gevonden extensies
Uitgesloten directories en extensies
Lijst van geïncludeerde extensies voor de scan

Voorbeeld output met samenvatting:

============================================================
  COUNT LINES PER FILE - SAMENVATTING
============================================================

Totaal aantal bestanden: 42
Totaal aantal regels:    15234
Gemiddeld per bestand:   363

Gevonden extensies: .css, .js, .json, .md, .ts, .tsx

Uitgesloten directories: .git, node_modules, dist, build
Uitgesloten extensies:   .log

Geïncludeerde extensies voor scan:
.js, .ts, .tsx, .jsx, .py, .java, .c, .cpp, .h, .cs, .php, ...

============================================================

  1523 regels : src/extension.ts
   842 regels : src/portCalculator.ts
   ...

Config File Alternative

Je kunt ook een vsfiletools.config.json bestand maken in de root van je project:

{
  "excludedDirs": [".git", "node_modules", ".next", "dist"],
  "excludedFiles": ["temp.txt"],
  "excludedExtensions": [".log", ".tmp"]
}

Prioriteit: VS Code settings hebben voorrang op het config bestand.

Installatie

Via VS Code Marketplace

Beschikbaar via VSCode Marketplace: [https://marketplace.visualstudio.com/items?itemName=BrechtParmentier.vs-file-tools]

Publishing

De extensie gebruikt een geautomatiseerde CI/CD pipeline met Release Please voor versioning en publicatie.

Normale Release Flow:

Merge commits naar main (met Conventional Commits)
Release Please maakt automatisch een Release PR
Merge Release PR → automatische publicatie naar Marketplace

Manual Publishing (voor hotfixes/noodgevallen):

Via GitHub Actions UI:

# Ga naar: Actions → "Manual Publish to Marketplace" → Run workflow

Via lokale CLI:

# Dry run (test zonder publiceren)
pnpm run publish:dry-run

# Publiceren naar Marketplace
export VSCE_PAT="your-token"
pnpm run publish:manual

📖 Volledige documentatie: Zie DEPLOYMENT_GUIDE.md voor details over:

Automated release flow
Manual publishing opties
Emergency hotfix procedures
Version strategy
Troubleshooting

Development Setup

Dit project gebruikt Volta voor Node.js en pnpm versie management.

Automatische Setup (aanbevolen)

./setup-volta.sh

Dit script:

Installeert Volta (indien nog niet geïnstalleerd)
Pinnen Node.js 22.15.0 en pnpm 10.23.0 voor dit project
Biedt optioneel aan om Ubuntu's Node.js te verwijderen

Handmatige Setup

Als je Volta al hebt geïnstalleerd:

# Installeer dependencies
pnpm install

# Compileer de extensie
pnpm run compile

# Start development mode
pnpm run watch

Versies:

Node.js: 22.15.0 (managed by Volta)
pnpm: 10.23.0 (managed by Volta)

Deze versies worden automatisch gebruikt wanneer je in deze projectmap werkt.

Info

Auteur: Brecht Parmentier Repository: [https://github.com/brechtparmentier/vscodeExt_combineFilesToOne.git]

VSFileTools

BrechtParmentier

VSFileTools

Features

📁 File Management Tools

🚀 GitHub Issue/PR/WIP Workflow

📦 Project Makefile Integration

🐛 GitHub Issues Browser

🤖 AI-Powered Git Documentation

🎯 Gebruik

GitHub Workflow (Quick Start)

Makefile Workflow Sidebar Menu

Project Makefile Sidebar Menu

GitHub Issues Browser Sidebar

File Management Tools

AI Prompts via Copilot Chat

AI Prompts via Sidebar

Codex integration

Port Calculator

📚 AI Prompts Reference

Group A: Strategic Analysis & Architecture (@vsfiletools-analysis)

Group B: Daily Workflow Operations (@vsfiletools-daily)

Group C: Export & Packaging (@vsfiletools-export)

Group D: Governance & Meta-Level Tracking (@vsfiletools-governance)

Group E: Complete Workflows (@vsfiletools-workflows)

Group F: Infrastructure & Runtime (@vsfiletools-infrastructure)

Group M: Makefile Tools (@vsfiletools-makefile)

💡 Gebruik Tips

Configuratie

Algemene Configuratie

GitHub Authentication (Remote SSH)

Count Lines per File - Specifieke Configuratie

vsFileTools.countLines.includedExtensions

vsFileTools.countLines.excludedDirs

vsFileTools.countLines.showSummary

Config File Alternative

Installatie

Via VS Code Marketplace

Publishing

Development Setup

Automatische Setup (aanbevolen)

Handmatige Setup

Info