Burner BURNER v...
Burner CLI Screenshot

Spark ideas. Burn 🔥 when done. It's the home 🏡 for burner projects.

$ dotnet tool install -g Burner-CLI

// WHY BURNER?

"You create a folder called test. Then test2. Then test-new. Then test-final-v2-REAL..."

Sound familiar? Burner gives throwaway code a dedicated home - organized, dated, and ready to burn when you're done.

📝 how and why Burner was created →

// FEATURES

⚡

Quick Scaffolding

Spin up projects instantly using predefined or custom templates. Get coding in seconds.

📁

Organized Storage

All projects live in a unified burner home directory with YYMMDD-NAME format for easy identification.

🔥

Easy Cleanup

Remove projects when done with auto-cleaning of old experiments. Or just burn everything.

📥

Imports

Move or copy existing folders into burner home for unified tracking and management.

🧩

Extensible Templates

Add your own custom templates using PowerShell, Bash, Python, or any executable script.

📊

Statistics

View project statistics with charts showing usage patterns, disk usage, and age distribution.

// COMMANDS

burner new <template> [name]
Create a new project from a template. Name is auto-generated if not provided.
burner list
List all burner projects with age and template info.
burner burn [name] [--days N]
Delete specific project or clean up projects older than N days.
burner open [name]
Open project in editor or file explorer. Interactive if no name provided.
burner import
Import current folder as a burner project (move or copy).
burner config
View and update configuration (home directory, templates, editor, auto-clean).
burner templates
List available templates (built-in and custom).
burner stats
Show project statistics with charts and usage metrics.

// QUICK START

1 Install

Install the CLI tool globally using .NET:

$ dotnet tool install -g Burner-CLI
2 Create

Create a new project with a template:

$ burner new dotnet my-experiment
3 Work

Open and work on your project:

$ burner open my-experiment -c
4 Burn

Clean up when you're done experimenting:

$ burner burn my-experiment
📚 Documentation 💻 Source Code 📦 NuGet Package 🐛 Report Issues