Path Panda shows status bar indicators based on the active editor file path.
- Install Path Panda from the VS Code Marketplace.
- Open the config file to customize patterns:
- Run the command "Path Panda: Open Config" from the Command Palette (
Ctrl+Shift+P/Cmd+Shift+P). - Or click any Path Panda status bar indicator (if present) at the bottom left.
- Run the command "Path Panda: Open Config" from the Command Palette (
- Edit patterns to match file paths and see the indicators update instantly.
For detailed configuration options, see docs/CONFIG.md.
- Status bar indicators based on the active editor file path.
- Multiple indicators when multiple patterns match.
- Pattern matching with
match_case,match_whole_word, anduse_regexoptions. - Customize foreground and background colors via hex values or VS Code theme tokens.
The config file is stored in the extension global storage folder and is created automatically the first time the extension runs. Open it by clicking a Path Panda indicator or by running the command "Path Panda: Open Config" from the Command Palette.
Example configuration:
{
// You can remove this example pattern and add your own.
"patterns": [
{
"name": "Path Panda",
"pattern": "*",
"match_case": false,
"match_whole_word": true,
"use_regex": false,
"emoji": "🐼",
"color": "statusBar.foreground",
"background_color": "statusBarItem.prominentBackground"
}
]
}
For all fields, allowed foreground tokens, and background tokens, see docs/CONFIG.md. When the config file is open, VS Code provides validation and completions from the built-in schema.
- Path Panda: Open Config
See docs/DEVELOPMENT.md for setup and development workflow instructions.
See docs/ARCHITECTURE.md for a short overview of how the extension works.
- Fork the repository.
- Create a feature branch.
- Run
npm installand verify withnpm run lintandnpm test. - Open a pull request describing the changes.
