DEV Community

Cover image for 6 steps to pimp my terminal
Piotr Stapp
Piotr Stapp

Posted on • Updated on • Originally published at stapp.space

6 steps to pimp my terminal

Tools

My current setup is mixed of tools from following list:

  • oh-my-posh + powerlevel10k_rainbow (with mods) theme + custom font
  • posh-git
  • Set-PSReadlineKeyHandler for "bash style" search + autocomplete
  • PSKubectlCompletion with PSKubeContext for kubernetes
  • Register-ArgumentCompleter for dotnet
  • MagicTooltips which is responsible for displaying tooltips for kubectl and az

If you just want to copy-paste, scroll down to the end and copy what you need from my $PROFILE file πŸ˜…

Step 1 - standard + small hacks

The posh-git and oh-my-posh modules are quite popular, but will intruce them shortly:

  • posh-git displays info about git status
  • oh-my-posh allows to displays a lot of segments (like: time, battery, last exit code, kubernetes, aws, az, ....)

There are numerous themes for oh-my-posh. I'm using powerlevel10k rainbow, but there are missing icons even on the oh-my-posh website. You'll need a unique typeface to get this appearance. Oh-my-posh recommends Meslo LGM NF, but I went with Delugia Nerd Font Complete. Is is a Cascadia Code "Extended", which includes Nerd Fonts and powerline glyphs.

You must "force it" in Windows Terminal JSON after installation (to access settings, press CTRL+, then the gear icon on the left):

 "profiles": 
    {
        "defaults": 
        {
            "fontFace": "Delugia Nerd Font Complete"
        },
Enter fullscreen mode Exit fullscreen mode

The final outcome is awesome:

terminal

Finally, remember to include your $PROFILE file (the best approach is to modify it using code $PROFILE if you have VS Code installed):

# posh git
Import-Module-With-Measure posh-git

# oh-my-posh
Import-Module-With-Measure oh-my-posh
Set-PoshPrompt -Theme powerlevel10k_rainbow
Enter fullscreen mode Exit fullscreen mode

Step 2: bash style history search and autocomplete

Do you get tired of typing CTRL+R to look up commands in the history? Is it easier to just use arrows to find the last invocation of kubectl get, for example? I was one of them. Simply add the following to your profile:

# up&down arrow for history search
Set-PSReadLineKeyHandler -Key UpArrow -Function HistorySearchBackward
Set-PSReadLineKeyHandler -Key DownArrow -Function HistorySearchForward
Enter fullscreen mode Exit fullscreen mode

Add one more if you'd like to view all autocomplete options after pressing TAB:

# menu complete using TAB instead of CTRL+SPACE
Set-PSReadlineKeyHandler -Chord Tab -Function MenuComplete
Enter fullscreen mode Exit fullscreen mode

Still not convinced? It's time for a little demonstration:

Yummy πŸ˜‹

Step 3: Autocomplete

Today I'm only using dotnet and kubernetes autocomplete. I hope that soon I could use also az.
Kubernetes config I described in my last post,

Anyway, the dotnet command is easy:

#dotnet completion
Register-ArgumentCompleter -Native -CommandName dotnet -ScriptBlock {
    param($commandName, $wordToComplete, $cursorPosition)
    dotnet complete --position $cursorPosition "$wordToComplete" | ForEach-Object {
        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
    }
}
Enter fullscreen mode Exit fullscreen mode

What about Az CLI? The proof of concept is easy, but it isn't a top priority for Azure team πŸ˜₯, just check GitHub.
The gist is the only thing I've found, but I'm not using it.

If you need more stuff for autocomplete, just search, implement or rewrite bash to PowerShell. No shorthands, sorry πŸ˜₯

Step 4: Magic tooltips

That's great for displaying dynamic segments. What does this imply? When I type kubectl<SPACE>, for example, I want to see information about Kubernetes context, but I don't need it most of the time. The same goes for azΒ and aws.
The oh-my-posh author guides me to a MagicTooltips module. I'll probably have to submit a PR there to include namespace as well.
Anyway, I choose to set it up as follows:

$global:MagicTooltipsSettings = @{
    VerticalOffset = 0
    HorizontalOffset = 4
    HorizontalAlignment = "Right"
    Providers= @{
        Kubernetes = @{
            Commands = "kubectl,helm,kubens,kubectx,k9s,k"
        }
    }
}
Import-Module MagicTooltips
Enter fullscreen mode Exit fullscreen mode

However, to make your theme seem good, you'll probably need to set HorizontalOffset and VerticalOffset.

My powerlevel 10k setup looks like this (the cluster name is under the clock):
MagicTooltips demo

Step 5: find slow modules/segments

I noticed performance issues after installing various extensions. To repair it, I chose to do the following:

  • remove unused segments in powerlevel theme
  • measure Import-Module

Step 6: having "sudo" mode

Isn't it awesome to use sudo in a terminal?
I used two functions to implement it:

function fcuk {
    $cmd = (Get-History ((Get-History).Count))[0].CommandLine
    Write-Host "Running $cmd in $PWD"
    start-process pwsh -verb runas -WorkingDirectory $PWD -ArgumentList "-NoExit -Command pushd $PWD; Write-host 'cmd to run: $cmd'; $cmd"
}

function sudo {
    if ($first -eq '!!') {
        fcuk;
    }
    else {
        $file=$args[0];
        [string]$arguments = "";
        if ($args.Count -gt 1) {
            $c = $args.Count - 1;
            [string]$arguments = $args[1..$c]
        }
        Write-Host "file = $file args = $arguments";
        start-process $file -verb runas -WorkingDirectory $PWD -ArgumentList $arguments;
    }
}
Enter fullscreen mode Exit fullscreen mode

My $PROFILE file

Finally, here's what my $PROFILE file looks like:

# helper
function Import-Module-With-Measure {
    param ($ModuleName)
    $import = Measure-Command {
        Import-Module $ModuleName
    }
    Write-Host "$ModuleName import $($import.TotalMilliseconds) ms"
}

# posh git
Import-Module-With-Measure posh-git

# oh-my-posh
Import-Module-With-Measure oh-my-posh
Set-PoshPrompt -Theme powerlevel10k_rainbow

# menu complete using TAB instead of CTRL+SPACE
Set-PSReadlineKeyHandler -Chord Tab -Function MenuComplete
# up&down arrow for history search
Set-PSReadLineKeyHandler -Key UpArrow -Function HistorySearchBackward
Set-PSReadLineKeyHandler -Key DownArrow -Function HistorySearchForward

# kubectl + stuff 
Import-Module-With-Measure PSKubectlCompletion
Set-Alias k -Value kubectl
Register-KubectlCompletion

Import-Module-With-Measure PSKubeContext
Set-Alias kubens -Value Select-KubeNamespace
Set-Alias kubectx -Value Select-KubeContext
Register-PSKubeContextComplete


# magic tooltip config
$global:MagicTooltipsSettings = @{
    VerticalOffset = 0
    HorizontalOffset = 4
    HorizontalAlignment = "Right"
    Providers= @{
        Kubernetes = @{
            Commands = "kubectl,helm,kubens,kubectx,k9s,k"
        }
    }
}
Import-Module MagicTooltips


#dotnet completion
Register-ArgumentCompleter -Native -CommandName dotnet -ScriptBlock {
    param($commandName, $wordToComplete, $cursorPosition)
    dotnet complete --position $cursorPosition "$wordToComplete" | ForEach-Object {
        [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
    }
}

# SUDO functions
function fcuk {
    $cmd = (Get-History ((Get-History).Count))[0].CommandLine
    Write-Host "Running $cmd in $PWD"
    start-process pwsh -verb runas -WorkingDirectory $PWD -ArgumentList "-NoExit -Command pushd $PWD; Write-host 'cmd to run: $cmd'; $cmd"
}

function sudo {
    if ($first -eq '!!') {
        fcuk;
    }
    else {
        $file=$args[0];
        [string]$arguments = "";
        if ($args.Count -gt 1) {
            $c = $args.Count - 1;
            [string]$arguments = $args[1..$c]
        }
        Write-Host "file = $file args = $arguments";
        start-process $file -verb runas -WorkingDirectory $PWD -ArgumentList $arguments;
    }
}
Enter fullscreen mode Exit fullscreen mode

What comes next?

You can also find some interesting configurations at:

Maybe you have something useful in your setup? If yes please share!

Top comments (5)

Collapse
 
ddaranowski profile image
Damian Daranowski

Hi, I followed the instructions but on WT I have icons but in VS I don't have :/
Something missing?

FYI. Delugia Nerd Font Complete font name after instalation -> "fontFace": "Delugia Nerd Font" and typo "Is is"

Collapse
 
ddaranowski profile image
Damian Daranowski

I found solution :) I need change terminal font family in VSCode settings also

Collapse
 
ptrstpp950 profile image
Piotr Stapp

That's funny about font name :) I have both when I check it :)

Collapse
 
mkunikow profile image
Michal Kunikowski

I am using starship.rs/ . Works also on PowerShell ...

Collapse
 
ptrstpp950 profile image
Piotr Stapp

Nice one