Trail Marker

A VS Code extension that tracks your navigation history, creating a visual trail of your file exploration journey. Never lose track of where you've been!

Features

• 🗺️ Visual Trail: See a chronological list of files and locations you've visited
• 🎯 Quick Navigation: Jump back to any previous location with a single click
• 👁️ Toggle Tracking: Enable/disable trail tracking as needed
• 🧹 Clean Interface: Remove individual items or clear the entire trail
• 📍 Manual Bookmarks: Add current location to trail manually
• 🔍 Preview Text: See a snippet of code at each location for context

Installation

From VS Code Marketplace (Recommended)

1. Open VS Code
2. Go to Extensions view (Ctrl+Shift+X or Cmd+Shift+X)
3. Search for "Trail Marker"
4. Click Install

Manual Installation (.vsix file)

1. Download the latest .vsix file from Releases
2. Open VS Code
3. Go to Extensions view (Ctrl+Shift+X or Cmd+Shift+X)
4. Click the "..." menu in the Extensions view
5. Select "Install from VSIX..."
6. Choose the downloaded .vsix file

From Source

git clone https://github.com/yourusername/trailMarker.git
cd trailMarker
npm install
npm run compile
code --install-extension trail-marker-1.0.0.vsix

Usage

Opening the Trail

• Command Palette: Ctrl+Shift+P → "Trail Marker: Show Trail"
• View Menu: View → Trail Marker
• Sidebar: Look for "Trail Marker" in the Search view

Trail Controls

• ➕ Add Current Location: Manually bookmark your current position
• 👁️ Toggle Tracking: Enable/disable automatic trail tracking
• 🗑️ Clear Trail: Remove all items from the trail
• ▶️ Go to Location: Navigate to a specific trail item
• ❌ Remove Item: Remove a specific item from the trail

Automatic Tracking

The extension automatically tracks your navigation when:

• You open files (Ctrl+P file picker)
• You go to definition (F12)
• You find references (Shift+F12)
• You use "Go to Symbol" (Ctrl+Shift+O)
• You navigate with breadcrumbs
• You switch between editors

Configuration

Currently, Trail Marker works out of the box with sensible defaults. Future versions will include configuration options for:

• Maximum trail length
• File type filters
• Custom activation events
• Trail persistence across sessions

Commands

Requirements

• VS Code 1.74.0 or higher

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Release Notes

1.0.0

• Initial release
• Visual trail tracking
• Manual bookmarking
• Quick navigation
• Trail management controls

Support

• 🐛 Bug Reports: GitHub Issues
• 💡 Feature Requests: GitHub Discussions
• 📧 Email: your-email@example.com

Acknowledgments

• Built with VS Code Extension API
• Icons from VS Code's built-in icon set
• Inspired by the need for better navigation tracking in large codebases