A Visual Studio Code extension that displays the current token usage across your entire PICO-8 project directory. Ideal for keeping track of the 8192 token limit in multi-file .p8 projects.
Allows combining multiple .p8 source files down into a single combined cartridge for an easier development workflow.
Features
✅ Live token counting across all .p8 files in the workspace
✅ Accurate parsing using rules aligned with PICO-8 tokenization
✅ Displays token count in the status bar
✅ Hovering the status bar shows a detailed breakdown by file
✅ Automatically updates when files are changed, opened, or saved
✅ Interactive file selector to include/exclude files from token totals
✅ Compile selected .p8 files into a single output file
✅ Toolbar button to auto-generate a combined file with -- 8> tabs per section
✅ Optional quick compile command with preconfigured output path
Status bar display:
Tooltip display:
Dialogue display:
Combine files tooltip:
Usage
To select files for inclusion in token tracking and compilation:
Click the status bar token count or run PICO-8: Select Files from the Command Palette.
Use the checkboxes to toggle files.
Use the toolbar icon to combine selected files into one .p8.
To enable quick compilation:
Set a value for pico8Directory.outputPath in your VS Code settings.
Run PICO-8: Auto Compile (optionally bind a key for fast use).
Requirements
VS Code 1.77+
Your .p8 source files should be in the same directory or a subdirectory of the workspace root
