Skip to content

Repository files navigation

⚡ Terminal Environment Bootstrapper (Windows)

PowerShell Platform License

⚡ From ~5.7s → ~750ms startup
A reproducible, high-performance PowerShell terminal setup for Windows.


🖥️ Preview (Real Output)

Terminal Preview

Real terminal output with async system stats and optimized prompt rendering.


🚀 Performance

Scenario Startup Time
Before optimization ~5700 ms
After optimization ~750 ms

Startup is optimized using lazy loading and background execution.


⚡ Quick Start

git clone https://github.com/Delcado19/terminal-env.git
cd terminal-env
.\install.ps1

✨ Features

  • ⚡ Ultra-fast startup (~750 ms)
  • 🧠 Lazy-loaded architecture (no blocking at startup)
  • 🔄 Async system stats (CPU / RAM / VRAM)
  • 🎨 Oh My Posh prompt configuration
  • 📦 Reproducible environment using a lock file
  • 🔁 Idempotent installer (safe to run multiple times)
  • 🧪 Dry-run mode

📦 Installed Tools

Tool Purpose
git version control
oh-my-posh prompt theming engine
zoxide smarter cd replacement
eza modern ls replacement
bat enhanced cat

Additional installation:

JetBrainsMono Nerd Font


🧠 Architecture

The setup is designed for performance:

  • Prompt loads instantly
  • Heavy tasks run after startup
  • No blocking operations during initialization
Startup → Prompt → Background Tasks

⚙️ Installation

.\install.ps1

Installer workflow:

  1. Detect available package managers
  2. Install CLI tools (winget → scoop → choco fallback, per package)
  3. Install the Nerd Font
  4. Deploy the PowerShell configuration to ~/.powershell
  5. Wire the PowerShell 7 profile to load it

The installer runs as the current user (winget user scope, scoop). Only the rarely-needed choco fallback requires an elevated shell.

Package managers: winget is the standard, scoop the first fallback and choco the last. IDs for each tool are defined per manager in packages.lock.json; the first available manager that succeeds wins.


🧪 Dry Run Mode

.\install.ps1 -DryRun

📁 Repository Structure

terminal-env
│
├ install.ps1
├ packages.lock.json
│
├ powershell
│  ├ profile.ps1
│  └ atomic.omp.json
│
├ docs
│
├ .gitignore
├ .gitattributes
├ .editorconfig
│
└ README.md

📚 Documentation

Detailed technical documentation can be found in:

docs/

🔄 Updating Tools

winget upgrade --all

🛠 Troubleshooting

See:

docs/TROUBLESHOOTING.md

📄 License

MIT License

Copyright (c) 2026 Delcado

About

terminal environment bootstrapper

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages