File Header for AI

📘 Roadmap · 📝 Release Notes

Lightweight, zero-config file headers for AI chats and humans.
A VS Code extension by Apathetic Tools.

Adds a single-line file-header comment containing the relative filepath and an optional role label at the top of your files.
Perfect for developers who often paste files into chat — whether to AI assistants or other humans.

Features

• 🧭 Inserts relative filepath + filename as a comment at the top of the file.
• 💬 Supports per-language comment styles (//, #, <!-- -->, etc.).
• 🧩 Optional role hints via glob patterns in settings.
• 🏷️ Optional language format modifier (e.g. (TypeScript React)).
• ⚙️ Works with user, .code-workspace, .vscode, and .file-header settings.
• ⚡ Minimal, fast, and MIT-licensed.

Example

// src/components/Button.tsx (TypeScript React)

Installation

Once published, install from the Visual Studio Marketplace Or, for local builds:

pnpm vsce package
code --install-extension vscode-file-header-0.0.1.vsix

Configuration

Zero-configuration by default — sensible, non-destructive behavior out of the box. Configure only if you want to modify defaults or extend functionality.

Settings can be added in .vscode/settings.json, .code-workspace, or a local .fileheader.json config:

Roadmap

Version 1.0 will be feature complete for everyday and AI-chat use.
Future updates may expand configurability.
See Roadmap.md for details.

Contributing

See CONTRIBUTING.md for setup and development instructions.

License

MIT © 2025 Apathetic Tools

✨ ChatGPT was used to help draft language, formatting, and code — plus we just love em dashes.