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

� Intelligent Prompt Navigator

Smart, context-aware recommendations for your next AI prompt - The Navigator analyzes your repository state, execution history, and workflow patterns to suggest the most relevant prompts at the right time.

Key Features

📊 Context-Aware Recommendations - Analyzes git state, file structure, and GitHub activity
🔄 History-Based Learning - Learns from past prompt executions to improve suggestions
⚡ Real-Time Updates - Automatically refreshes when repository state changes
🎯 Workflow Pattern Detection - Identifies common sequences (e.g., A1→A2→M1)
📈 Confidence Scoring - 5-factor algorithm: context (40%), recency (20%), workflow (20%), urgency (10%), impact (10%)
🎨 Visual Status Indicators - ✅ (executed), ⚠️ (partial), ❌ (failed), ▶️ (recommended), ⚪ (not executed)
⚙️ Fully Configurable - Customize weights, thresholds, and display preferences

How It Works

The Navigator uses a 5-factor scoring algorithm to rank prompts:

Context Match (40%): How well the prompt fits your current repo state
Recency (20%): Recent executions are deprioritized to avoid repetition
Workflow Patterns (20%): Common prompt sequences from execution history
Urgency (10%): Repo state signals (uncommitted changes, open issues)
Impact (10%): Potential value based on project phase

Quick Start

Enable Navigator (enabled by default)
Open Sidebar: View "Prompt Navigator" in Activity Bar
See Recommendations: Top suggestions appear under "Next Recommended"
Execute Prompts: Click to run with full Git context
Track History: Monitor execution results and patterns

📍 Next Recommended - Top 3 prompts for your current context
📚 All Prompts - Complete catalog organized by category
📊 Execution Stats - Track success rates and patterns

Configuration

Fine-tune Navigator behavior in VS Code Settings:

{
  "vsFileTools.navigator.enabled": true,
  "vsFileTools.navigator.recommendations.maxCount": 3,
  "vsFileTools.navigator.recommendations.minConfidence": 0.5,
  "vsFileTools.navigator.recommendations.scoring.contextMatch": 0.4,
  "vsFileTools.navigator.recommendations.scoring.recency": 0.2,
  "vsFileTools.navigator.ui.showStatusIcons": true
}

D5 Navigator Prompt

Use the D5 Navigator prompt for interactive, AI-powered recommendations:

Analyzes: Git state, file structure, GitHub activity, execution history
Provides: Top 3 recommendations with detailed reasoning
Interactive: Asks follow-up questions to refine suggestions
Explains: Why each prompt is recommended based on 5 factors

@vsfiletools-governance D5

👉 Full Navigator Guide | Architecture & APIs

🤖 AI-Powered Git Documentation

30 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/Taskfile 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 30 gespecialiseerde AI prompts verdeeld over 7 groepen (A, B, C, D, E, F, M). Alle prompts zijn ontworpen om comprehensive Git-based documentatie te genereren voor je project.

Prompt Groepen

Group A: (7 prompts) Analysis & Architecture - Project mapping, refactoring, quality analysis
Group B: (9 prompts) Daily Workflow - Task management, documentation sync, feature finalization
Group C: (1 prompt) Export & Bundles - Feature export and bundling
Group D: (6 prompts) Governance & Meta - Guidelines, orchestration, execution tracking
Group E: (3 prompts) Complete Workflows - End-to-end flows (issue→PR, port management, profiles)
Group F: (1 prompt) Infrastructure - Runtime discovery and environment setup
Group M: (3 prompts) Makefile/Taskfile Tools - Makefile/Taskfile optimization and generation

💡 Gebruik Tips

Via Chat:

@vsfiletools-analysis A1      # Project Mapping (Quick)
@vsfiletools-daily B4         # Session Sync
@vsfiletools-workflows E1     # Issue to PR Flow
@vsfiletools-makefile M1      # Optimize Makefile

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, prompt ID en generated outputs.

Context Integration: Prompts verzamelen automatisch Git branch, working directory status, active file info en project structure voor accurate responses.

📖 Volledige Prompt Documentatie

Voor gedetailleerde beschrijvingen van alle 30 prompts, zie:

COPILOT_INTEGRATION.md - Complete prompt catalog met gebruik voorbeelden
PROMPT_WORKFLOW_GUIDE.md - Workflow patterns en best practices
prompts/ - Individuele prompt bestanden

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:

Werk op feature/* of fix/* branch
PR: feature/fix -> dev_main
PR: dev_main -> main met expliciete release-intentie in de titel (repo is squash-only):
- release gewenst: feat: / fix: / perf: / refactor: / revert:
- geen release gewenst: voeg [no-release] toe
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
# Let op: run op branch `main` (verplicht)

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

Git Repository Setup

Voor nieuwe projecten kun je de repository automatisch configureren met onze best practices:

./gitRepoSetup.sh --help               # Show all options
./gitRepoSetup.sh --new                # Create new GitHub repo
./gitRepoSetup.sh --fix-only           # Fix existing repo
./gitRepoSetup.sh --dry-run            # Test without executing

Features:

✅ dev_main as default branch - Enforces branching strategy
✅ Branch protection - Automatically configures protection rules
✅ Squash merge only - Enforces linear history
✅ Delete branch on merge - Automatic cleanup
✅ Idempotent - Safe to re-run

Example workflows:

# New project
cd my-new-project
git init
../vscodeExt_combineFilesToOne/gitRepoSetup.sh --new --repo my-new-project

# Fix existing repo
cd existing-project  
../vscodeExt_combineFilesToOne/gitRepoSetup.sh --fix-only

# Test configuration (no changes)
./gitRepoSetup.sh --dry-run --new --repo test-project

Prerequisites: git, gh CLI

📖 Integration: Works seamlessly with Makefile Workflow (see MAKEFILE_WORKFLOW.md)

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

� Intelligent Prompt Navigator

Key Features

How It Works

Quick Start

Sidebar Sections

Configuration

D5 Navigator Prompt

🤖 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

Prompt Groepen

💡 Gebruik Tips

📖 Volledige Prompt Documentatie

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

Git Repository Setup

Development Setup

Automatische Setup (aanbevolen)

Handmatige Setup

Info