Configuration

Pour commencer à configurer starship, créez le fichier suivant : ~/.config/starship.toml.

mkdir -p ~/.config && touch ~/.config/starship.toml

Toute la configuration de starship est effectuée dans ce fichier TOML :

# Get editor completions based on the config schema
"$schema" = 'https://starship.rs/config-schema.json'

# Inserts a blank line between shell prompts
add_newline = true

# Replace the '❯' symbol in the prompt with '➜'
[character] # The name of the module we are configuring is 'character'
success_symbol = '[➜](bold green)' # The 'success_symbol' segment is being set to '➜' with the color 'bold green'

# Disable the package module, hiding it from the prompt completely
[package]
disabled = true

Config File Location

Vous pouvez choisir l'emplacement du fichier avec la variable d'environnement STARSHIP_CONFIG:

export STARSHIP_CONFIG=~/example/non/default/path/starship.toml

De manière équivalente, pour Powershell (Windows), ajoutez la ligne suivante à votre $PROFILE:

$ENV:STARSHIP_CONFIG = "$HOME\example\non\default\path\starship.toml"

Ou pour Cmd (Windows) ajouter cette ligne à votre starship.lua:

os.setenv('STARSHIP_CONFIG', 'C:\\Users\\user\\example\\non\\default\\path\\starship.toml')

Journalisation

By default starship logs warnings and errors into a file named ~/.cache/starship/session_${STARSHIP_SESSION_KEY}.log, where the session key is corresponding to an instance of your terminal. Ceci peut cependant être modifié en utilisant la variable d'environnement STARSHIP_CACHE:

export STARSHIP_CACHE=~/.starship/cache

De manière équivalente, pour Powershell (Windows), ajoutez la ligne suivante à votre $PROFILE:

$ENV:STARSHIP_CACHE = "$HOME\AppData\Local\Temp"

Ou pour Cmd (Windows) ajouter cette ligne à votre starship.lua:

os.setenv('STARSHIP_CACHE', 'C:\\Users\\user\\AppData\\Local\\Temp')

Terminologie

Module: Un composant dans l'invite de commande donnant des informations basées sur des données contextuelles de votre OS. Par exemple, le module "nodejs" montre la version de Node.js qui installée sur votre ordinateur, si votre dossier actuel est un projet Node.js.

Variable: Petits sous-composants qui contiennent des informations fournies par le module. Par exemple, la variable "version" dans le module "nodejs" contient la version actuelle de Node.js.

Par convention, la plupart des modules ont un préfixe de la couleur par défaut du terminal (par exemple via dans "nodejs") et un espace vide comme suffixe.

Strings

In TOML syntax, text values are declared with ', ", ''', or """.

The following Starship syntax symbols have special usage in a format string and must be escaped to display as that character: $ [ ] ( ).

Par exemple :

# literal string
format = '☺\☻ '

# regular string
format = "☺\\☻ "

# escaping Starship symbols
format = '\[\$\] '

When using line breaks, multi-line declarations can be used. For example, if you want to print a $ symbol on a new line, the following values for format are equivalent:

# with literal string
format = '''

\$'''

# with multiline basic string
format = """

\\$"""

# with basic string
format = "\n\\$"

In multiline basic strings, newlines can be used for formatting without being present in the value by escaping them.

format = """
line1\
line1\
line1
line2\
line2\
line2
"""

Chaîne de formatage

Les chaînes de formatage sont le format avec lequel un module affiche toutes ses variables. La plupart des modules ont une entrée appelée format qui configure le format d'affichage du module. Vous pouvez utiliser des textes, des variables et des groupes de texte dans une chaîne de format.

Variable

Une variable contient un symbole $ suivi du nom de la variable. Le nom d’une variable peut seulement container des lettres, des nombres et _.

Par exemple :

• '$version' is a format string with a variable named version.
• '$git_branch$git_commit' is a format string with two variables named git_branch and git_commit.
• '$git_branch $git_commit' has the two variables separated with a space.

Groupe de texte

Un groupe de texte se compose de deux parties différentes.

La première partie, qui est entourée dans un [], est une chaîne de formatage. Vous pouvez y ajouter des textes, des variables, ou même des groupes de texte imbriqués.

La deuxième partie, qui est entourée par (), est une chaîne de style. Elle peut être utilisée pour styliser la première partie.

Par exemple :

• '[on](red bold)' will print a string on with bold text colored red.
• '[⌘ $version](bold green)' will print a symbol ⌘ followed by the content of variable version, with bold text colored green.
• '[a [b](red) c](green)' will print a b c with b red, and a and c green.

Chaînes de style

La plupart des modules de Starship vous permettent de configurer leurs styles d'affichage. Cela se fait avec une entrée (généralement appelée style) qui est une chaîne de caractères spécifiant la configuration. Voici quelques exemples de chaînes de style avec ce qu'elles font. For details on the full syntax, consult the advanced config guide.

• 'fg:green bg:blue' sets green text on a blue background
• 'bg:blue fg:bright-green' sets bright green text on a blue background
• 'bold fg:27' sets bold text with ANSI color 27
• 'underline bg:#bf5700' sets underlined text on a burnt orange background
• 'bold italic fg:purple' sets bold italic purple text
• '' explicitly disables all styling

Notez que ce style sera contrôlé par votre émulateur de terminal. Par exemple, certains émulateurs de terminal éclairciront les couleurs au lieu de mettre le texte en gras, et certains thèmes de couleurs utilisent les mêmes valeurs pour les couleurs normales et claires. De plus, pour obtenir du texte italique, votre terminal doit prendre en charge l'italique.

Chaînes de formatage conditionnel

Une chaîne de formatage conditionnel enveloppée dans ( et ) ne sera pas rendue si toutes les variables à l'intérieur sont vides.

Par exemple :

• '(@$region)' will show nothing if the variable region is None or empty string, otherwise @ followed by the value of region.
• '(some text)' will always show nothing since there are no variables wrapped in the braces.
• When $combined is a shortcut for \[$a$b\], '($combined)' will show nothing only if $a and $b are both None. This works the same as '(\[$a$b\] )'.

Negative matching

Many modules have detect_extensions, detect_files, and detect_folders variables. These take lists of strings to match or not match. "Negative" options, those which should not be matched, are indicated with a leading '!' character. The presence of any negative indicator in the directory will result in the module not being matched.

Extensions are matched against both the characters after the last dot in a filename, and the characters after the first dot in a filename. For example, foo.bar.tar.gz will be matched against bar.tar.gz and gz in the detect_extensions variable. Files whose name begins with a dot are not considered to have extensions at all.

To see how this works in practice, you could match TypeScript but not MPEG Transport Stream files thus:

detect_extensions = ['ts', '!video.ts', '!audio.ts']

Invite

Voici la liste des options de configuration globales de l'invite de commandes.

Options

[!TIP] If you have symlinks to networked filesystems, consider setting follow_symlinks to false.

Exemple

# ~/.config/starship.toml

# Use custom format
format = '''
[┌───────────────────>](bold green)
[│](bold green)$directory$rust$package
[└─>](bold green) '''

# Wait 10 milliseconds for starship to check files under the current directory.
scan_timeout = 10

# Disable the blank line at the start of the prompt
add_newline = false

# Set 'foo' as custom color palette
palette = 'foo'

# Define custom colors
[palettes.foo]
# Overwrite existing color
blue = '21'
# Define new color
mustard = '#af8700'

Format par Défaut

Le format par défaut est utilisé pour définir le format de l'invite, si il est vide ou mal formaté. La valeur par défaut est la suivante :

format = '$all'

# Which is equivalent to
format = """
$username\
$hostname\
$localip\
$shlvl\
$singularity\
$kubernetes\
$nats\
$directory\
$vcsh\
$fossil_branch\
$fossil_metrics\
$git_branch\
$git_commit\
$git_state\
$git_metrics\
$git_status\
$hg_branch\
$hg_state\
$pijul_channel\
$docker_context\
$package\
$bun\
$c\
$cmake\
$cobol\
$cpp\
$daml\
$dart\
$deno\
$dotnet\
$elixir\
$elm\
$erlang\
$fennel\
$fortran\
$gleam\
$golang\
$gradle\
$haskell\
$haxe\
$helm\
$java\
$julia\
$kotlin\
$lua\
$maven\
$mojo\
$nim\
$nodejs\
$ocaml\
$odin\
$opa\
$perl\
$php\
$pulumi\
$purescript\
$python\
$quarto\
$raku\
$rlang\
$red\
$ruby\
$rust\
$scala\
$solidity\
$swift\
$terraform\
$typst\
$vlang\
$vagrant\
$xmake\
$zig\
$buf\
$guix_shell\
$nix_shell\
$conda\
$pixi\
$meson\
$spack\
$memory_usage\
$aws\
$gcloud\
$openstack\
$azure\
$direnv\
$env_var\
$mise\
$crystal\
$custom\
$sudo\
$cmd_duration\
$line_break\
$jobs\
$battery\
$time\
$status\
$container\
$netns\
$os\
$shell\
$character"""

Si vous voulez étendre le format par défaut, pour pouvoir utiliser $all ; les modules que vous ajouter explicitement au format ne seront pas dupliqués. Par ex.

# Move the directory to the second line
format = '$all$directory$character'

AWS

The aws module shows the current AWS region and profile and an expiration timer when using temporary credentials. The output of the module uses the AWS_REGION, AWS_DEFAULT_REGION, and AWS_PROFILE env vars and the ~/.aws/config and ~/.aws/credentials files as required.

The module will display a profile only if its credentials are present in ~/.aws/credentials or if a credential_process, sso_start_url, or sso_session are defined in ~/.aws/config. Alternatively, having any of the AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, or AWS_SESSION_TOKEN env vars defined will also suffice. If the option force_display is set to true, all available information will be displayed even if no credentials per the conditions above are detected.

Lorsque vous utilisez aws-vault le profil est lu à partir de la variable d'environnement AWS_VAULT et la date d'expiration des identifiants est lue à partir de la variable d'environnement AWS_SESSION_EXPIRATION.

Lorsque vous utilisez awsu le profil est lu depuis la variable d'environnement AWSU_PROFILE.

Lorsque vous utilisez AWSume le profil est lu à partir de la variable d'environnement AWSUME_PROFILE et la date d'expiration des identifiants est lue à partir de la variable d'environnement AWSUME_EXPIRATION.

When using saml2aws the expiration information obtained from ~/.aws/credentials falls back to the x_security_token_expires key.

When using aws-sso-cli the profile is read from the AWS_SSO_PROFILE env var.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemples

Tout afficher

# ~/.config/starship.toml

[aws]
format = 'on [$symbol($profile )(\($region\) )]($style)'
style = 'bold blue'
symbol = '🅰 '
[aws.region_aliases]
ap-southeast-2 = 'au'
us-east-1 = 'va'
[aws.profile_aliases]
CompanyGroupFrobozzOnCallAccess = 'Frobozz'

Afficher la région

# ~/.config/starship.toml

[aws]
format = 'on [$symbol$region]($style) '
style = 'bold blue'
symbol = '🅰 '
[aws.region_aliases]
ap-southeast-2 = 'au'
us-east-1 = 'va'

Afficher le profil

# ~/.config/starship.toml

[aws]
format = 'on [$symbol$profile]($style) '
style = 'bold blue'
symbol = '🅰 '
[aws.profile_aliases]
Enterprise_Naming_Scheme-voidstars = 'void**'

Azure

Le module azure affiche l'abonnement Azure actuel. This is based on showing the name of the default subscription or the username, as defined in the ~/.azure/azureProfile.json file.

[!TIP] This module is disabled by default. Pour l'activer, configurez disabled sur false dans votre fichier de configuration.

Options

Exemples

Display Subscription Name

# ~/.config/starship.toml

[azure]
disabled = false
format = 'on [$symbol($subscription)]($style) '
symbol = '󰠅 '
style = 'blue bold'

Display Username

# ~/.config/starship.toml

[azure]
disabled = false
format = "on [$symbol($username)]($style) "
symbol = "󰠅 "
style = "blue bold"

Display Subscription Name Alias

# ~/.config/starship.toml

[azure.subscription_aliases]
very-long-subscription-name = 'vlsn'

Battery

Le module battery montre à quel point la batterie de l'appareil est chargée et son état de charge actuel. Ce module n'est visible que lorsque la batterie de l'appareil est inférieure à 10%.

Options

Exemple

# ~/.config/starship.toml

[battery]
full_symbol = '🔋 '
charging_symbol = '⚡️ '
discharging_symbol = '💀 '

Indicateur de batterie

L'option de configuration display est utilisée pour définir quand l'indicateur de batterie doit être affiché (threshold), quel symbole doit être utilisé (symbol) et à quoi il ressemble (style). Si aucun display n'est fourni. La valeur par défaut est la suivante :

[[battery.display]]
threshold = 10
style = 'bold red'

La valeur par défaut pour les options charging_symbol et discharging_symbol est respectivement la valeur des options charging_symbol et discharging_symbol du module battery.

Options

L'option display est un tableau des propriétés suivantes.

Exemple

[[battery.display]] # 'bold red' style and discharging_symbol when capacity is between 0% and 10%
threshold = 10
style = 'bold red'

[[battery.display]] # 'bold yellow' style and 💦 symbol when capacity is between 10% and 30%
threshold = 30
style = 'bold yellow'
discharging_symbol = '💦 '

# when capacity is over 30%, the battery indicator will not be displayed

Buf

Le module buf affiche la version de Buf installée. By default, the module is shown if the current directory contains a buf.yaml, buf.gen.yaml, or buf.work.yaml configuration file.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[buf]
symbol = '🦬 '

Bun

The bun module shows the currently installed version of the bun JavaScript runtime. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier bun.lock
• Le dossier courant contient un fichier bun.lockb
• Le dossier courant contient un fichier bunfig.toml

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

Customize the format

# ~/.config/starship.toml

[bun]
format = 'via [🍔 $version](bold green) '

C

Le module c affiche des informations à propos de votre compilateur C. Par défaut, ce module sera affiché si le dossier courant contient un fichier .c ou .h.

Options

Variables

Commandes

L’option commands accepte une liste de commandes pour déterminer la version du compilateur et son nom.

Each command is represented as a list of the executable name, followed by its arguments, usually something like ['mycc', '--version']. Starship essayera d'exécuter chaque commande jusqu'à obtenir un résultat sur STDOUT.

If a C compiler is not supported by this module, you can request it by raising an issue on GitHub.

Exemple

# ~/.config/starship.toml

[c]
format = 'via [$name $version]($style)'

CPP

The cpp module shows some information about your C++ compiler. By default, the module will be shown if the current directory contains a .cpp, .hpp, or other C++-related files.

[!TIP] This module is disabled by default. Pour l'activer, configurez disabled sur false dans votre fichier de configuration.

Options

Variables

Commandes

L’option commands accepte une liste de commandes pour déterminer la version du compilateur et son nom.

Each command is represented as a list of the executable name, followed by its arguments, usually something like ['mycpp', '--version']. Starship essayera d'exécuter chaque commande jusqu'à obtenir un résultat sur STDOUT.

If a C++ compiler is not supported by this module, you can request it by raising an issue on GitHub.

Exemple

# ~/.config/starship.toml

[cpp]
disabled = false
format = 'via [$name $version]($style)'

Caractère

Le module character affiche un caractère (en général une flèche) à côté de là où vous entrez le texte dans votre terminal.

Le caractère vous dira si la dernière commande a été réussie ou pas. Il peut faire ça de deux façons:

• en changeant de couleur(red/green)
• en changeant de forme (❯/✖)

Par défaut, il ne change que de couleur. Si vous désirez également changer sa forme, jetez un à cet exemple.

[!WARNING] vimcmd_symbol is only supported in cmd, fish and zsh. vimcmd_replace_one_symbol, vimcmd_replace_symbol, and vimcmd_visual_symbol are only supported in fish due to upstream issues with mode detection in zsh.

Options

Variables

Exemples

Avec un caractère d'erreur personnalisé

# ~/.config/starship.toml

[character]
success_symbol = '[➜](bold green) '
error_symbol = '[✗](bold red) '

Sans caractère d'erreur personnalisé

# ~/.config/starship.toml

[character]
success_symbol = '[➜](bold green) '
error_symbol = '[➜](bold red) '

Avec une forme vim personnalisée

# ~/.config/starship.toml

[character]
vimcmd_symbol = '[V](bold green) '

CMake

Le module cmake affiche la version de CMake installée. Par défaut, le module s’activera si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier CMakeLists.txt
• Le dossier courant contient un fichier CMakeCache.txt

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

COBOL / GNUCOBOL

Le module cobol affiche la version de COBOL installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier finissant par .cob ou .COB
• Le dossier courant contiens un fichier finissant par .cbl ou .CBL

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Temps d'exécution

Le module cmd_duration montre le temps qu'a pris la dernière commande pour s'exécuter. Le module ne sera affiché que si la commande a pris plus de deux secondes, ou plus que la valeur min_time, si elle existe.

[!WARNING] Do not hook the DEBUG trap in Bash

If you are running Starship in bash, do not hook the DEBUG trap after running eval $(starship init $0), or this module will break.

Bash users who need preexec-like functionality can use rcaloras's bash_preexec framework. Définissez simplement les tableaux preexec_functions et precmd_functions avant d'exécuter eval $(starship init $0), puis procédez comme d'habitude.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[cmd_duration]
min_time = 500
format = 'underwent [$duration](bold yellow)'

Conda

The conda module shows the current Conda environment, if $CONDA_DEFAULT_ENV is set.

[!TIP] This does not suppress conda's own prompt modifier, you may want to run conda config --set changeps1 False. If you use pixi, you can disable pixi's prompt modifier by running pixi config set shell.change-ps1 false.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[conda]
format = '[$symbol$environment](dimmed green) '

Conteneur

Le module container affiche un symbole et le nom du conteneur, si vous êtes dans un conteneur.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[container]
format = '[$symbol \[$name\]]($style) '

Crystal

The crystal module shows the currently installed version of Crystal. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier shard.yml
• Le dossier courant contient un fichier .cr

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[crystal]
format = 'via [✨ $version](bold blue) '

Daml

The daml module shows the currently used Daml SDK version when you are in the root directory of your Daml project. The sdk-version in the daml.yaml file will be used, unless it's overridden by the DAML_SDK_VERSION environment variable. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier daml.yaml

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[daml]
format = 'via [D $version](bold bright-green) '

Dart

The dart module shows the currently installed version of Dart. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier avec l’extension .dart
• Le dossier courant contient un fichier .dart_tool
• Le dossier courant contient un fichier pubsepc.yaml, pubspec.yml ou pubspec.lock

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[dart]
format = 'via [🔰 $version](bold red) '

Deno

The deno module shows you your currently installed version of Deno. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• The current directory contains a deno.json, deno.jsonc, deno.lock, mod.ts, mod.js, deps.ts or deps.js file

Options

Variables

Exemple

# ~/.config/starship.toml

[deno]
format = 'via [🦕 $version](green bold) '

Dossier

Le module directory affiche le chemin du dossier courant, tronqué à 3 dossiers parents. Votre dossier sera également tronqué à la racine du repo git dans lequel vous vous trouvez actuellement.

When using the fish_style_pwd_dir_length option, instead of hiding the path that is truncated, you will see a shortened name of each directory based on the number you enable for the option.

Par exemple, ~/Dev/Nix/nixpkgs/pkgs où nixpkgs est la racine du repo, et l'option définie à 1. Vous verrez maintenant ~/D/N/nixpkgs/pkgs, alors que vous auriez vu nixpkgs/pkgs avant.

Options

substitutions allows you to define arbitrary replacements for literal strings that occur in the path, for example long network prefixes or development directories of Java. Notez que cela désactivera la PWD de style fish. It takes an array of the following key/value pairs:

By using regex = true, you can use Rust's regular expressions in from. For instance you can replace every slash except the first with the following:

substitutions = [
  { from = "^/", to = "<root>/", regex = true },
  { from = "/", to = " | " },
  { from = "^<root>", to = "/", regex = true },
]

This will replace /var/log to / | var | log.

The old syntax still works, although it doesn't support regular expressions:

[directory.substitutions]
'/Volumes/network/path' = '/net'
'src/com/long/java/path' = 'mypath'

fish_style_pwd_dir_leng interagit avec les options de troncature d'une manière qui peut être surprenante au début : si elle n'est pas nulle, les composantes du chemin qui seraient normalement tronquées sont affichées à la place avec autant de caractères. For example, the path /built/this/city/on/rock/and/roll, which would normally be displayed as rock/and/roll, would be displayed as /b/t/c/o/rock/and/roll with fish_style_pwd_dir_length = 1--the path components that would normally be removed are displayed with a single character. Pour fish_style_pwd_dir_length = 2, ce serait /bu/th/ci/on/rock/and/roll.

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Considérons le chemin /path/to/home/git_repo/src/lib

Exemple

# ~/.config/starship.toml

[directory]
truncation_length = 8
truncation_symbol = '…/'

Direnv

The direnv module shows the status of the current rc file if one is present. The status includes the path to the rc file, whether it is loaded, and whether it has been allowed by direnv.

[!TIP] This module is disabled by default. Pour l'activer, configurez disabled sur false dans votre fichier de configuration.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[direnv]
disabled = false

Contexte Docker

The docker_context module shows the currently active Docker context if it's not set to default or desktop-linux, or if the DOCKER_MACHINE_NAME, DOCKER_HOST or DOCKER_CONTEXT environment variables are set (as they are meant to override the context in use).

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[docker_context]
format = 'via [🐋 $context](blue bold)'

Dotnet

Le module dotnet montre la version pertinente du SDK .NET Core pour le répertoire courant. Si le SDK a été épinglé dans le répertoire courant, la version épinglée est affichée. Sinon, le module affiche la dernière version installée du SDK.

Par défaut, ce module ne sera affiché dans votre invite que lorsqu'un ou plusieurs des fichiers suivants sont présents dans le répertoire courant :

• global.json
• project.json
• Directory.Build.props
• Directory.Build.targets
• Packages.props
• *.csproj
• *.fsproj
• *.xproj

Vous aurez également besoin du SDK .NET Core pour pouvoir l'utiliser correctement.

En interne, ce module utilise son propre mécanisme de détection de version. Généralement, il est deux fois plus rapide que d'exécuter dotnet --version, mais il peut afficher une version incorrecte si votre projet .NET a une arborescence inhabituelle. Si la précision est plus importante que la vitesse, vous pouvez désactiver le mécanisme en définissant heuristic = false dans les options du module.

Le module affichera aussi le Moniker de Framework Cible (https://docs.microsoft.com/en-us/dotnet/standard/frameworks#supported-target-frameworks) quand il y a un fichier .csproj dans le dossier courant.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[dotnet]
symbol = '🥅 '
style = 'green'
heuristic = false

Elixir

Le module elixir affiche la version de Elixir et Erlang/OTP installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier mix.exs.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[elixir]
symbol = '🔮 '

Elm

Le module elm affiche la version de Elm installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier elm.json
• Le dossier courant contient un fichier elm-package.json
• Le dossier courant contient un fichier elm-version
• Le dossier courant contient un dossier elm-stuff
• Le dossier courant contient des fichiers *.elm

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[elm]
format = 'via [ $version](cyan bold) '

Variable d'environnement

Le module env_var affiche la valeur actuelle de la variable d’environnement choisie. Le module sera affiché si l'une de ces conditions est remplie:

• L'option variable correspond à une variable d'environnement existante
• L'option variable n'est pas définie, mais l'option default l'est

[!TIP] The order in which env_var modules are shown can be individually set by including ${env_var.foo} in the top level format (as it includes a dot, you need to use ${...}). By default, the env_var module will simply show all env_var modules in the order they were defined.

[!TIP] Multiple environmental variables can be displayed by using a .. (see example) If the variable configuration option is not set, the module will display value of variable under the name of text after the . character.

Exemple : la configuration suivante va afficher la valeur de la variable d’environnement UTILISATEUR

tomlCopy

# ~/.config/starship.toml

[env_var.USER] default = 'unknown user' ```

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[env_var]
variable = 'SHELL'
default = 'unknown shell'

Afficher plusieurs variables d’environnement:

# ~/.config/starship.toml

[env_var.SHELL]
variable = 'SHELL'
default = 'unknown shell'
[env_var.USER]
default = 'unknown user'

Erlang

Le module erlang affiche la version de Erlang/OTP installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier rebar.config.
• Le dossier courant contient un fichier erlang.mk.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[erlang]
format = 'via [e $version](bold red) '

Fennel

The fennel module shows the currently installed version of Fennel. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• The current directory contains a file with the .fnl extension

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[fennel]
symbol = '⫰ '

Remplissage

Le module fill remplit l’espace restant sur la ligne avec un symbole. Si plusieurs modules fill sont présents sur une ligne, ils divisent de manière égale l’espace entre eux. C’est utile pour aligner d’autres modules.

Options

Exemple

# ~/.config/starship.toml
format = 'AA $fill BB $fill CC'

[fill]
symbol = '-'
style = 'bold green'

Produit une invite qui ressemble à :

AA -------------------------------------------- BB -------------------------------------------- CC

Fortran

The fortran module shows the current compiler version of Fortran.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Commandes

L’option commands accepte une liste de commandes pour déterminer la version du compilateur et son nom.

Each command is represented as a list of the executable name, followed by its arguments, usually something like ['myfortran', '--version']. Starship essayera d'exécuter chaque commande jusqu'à obtenir un résultat sur STDOUT.

If a Fortran compiler is not supported by this module, you can request it by raising an issue on GitHub.

Fossil Branch

The fossil_branch module shows the name of the active branch of the check-out in your current directory.

[!TIP] This module is disabled by default. Pour l'activer, configurez disabled sur false dans votre fichier de configuration.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[fossil_branch]
symbol = '🦎 '
truncation_length = 4
truncation_symbol = ''

Fossil Metrics

The fossil_metrics module will show the number of added and deleted lines in the check-out in your current directory. At least v2.14 (2021-01-20) of Fossil is required.

[!TIP] This module is disabled by default. Pour l'activer, configurez disabled sur false dans votre fichier de configuration.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[fossil_metrics]
added_style = 'bold blue'
format = '[+$added]($added_style)/[-$deleted]($deleted_style) '

Google Cloud (gcloud)

Le module gcloud affiche la version de la commande gcloud installée. Ceci est basé sur les fichiers ~/.config/gcloud/active_config et ~/.config/gcloud/configurations/config_{CONFIG NAME} et la variable d'environnement CLOUDSDK_CONFIG.

When the module is enabled it will always be active, unless detect_env_vars has been set in which case the module will only be active when one of the environment variables has been set.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemples

Afficher le compte et le projet

# ~/.config/starship.toml

[gcloud]
format = 'on [$symbol$account(@$domain)(\($project\))]($style) '

Afficher uniquement le nom de la configuration active

# ~/.config/starship.toml

[gcloud]
format = '[$symbol$active]($style) '
style = 'bold yellow'

Afficher le compte et la région aliasée

# ~/.config/starship.toml

[gcloud]
symbol = '️🇬️ '
[gcloud.region_aliases]
us-central1 = 'uc1'
asia-northeast1 = 'an1'

Afficher le compte et le projet aliasée

# ~/.config/starship.toml

[gcloud]
format = 'on [$symbol$account(@$domain)(\($project\))]($style) '
[gcloud.project_aliases]
very-long-project-name = 'vlpn'

Branche Git

Le module git_branch affiche la branche active du dépôt dans le dossier courant.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[git_branch]
symbol = '🌱 '
truncation_length = 4
truncation_symbol = ''
ignore_branches = ['master', 'main']

Commit Git

Le module git_commit affiche le hash du commit courant et l’étiquette (s’il y en a) du dépôt dans le dossier courant.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[git_commit]
commit_hash_length = 4
tag_symbol = '🔖 '

État Git

Le module git_state s'affichera dans les répertoires qui font partie d'un dépôt git, dans lesquels une opération est en cours, comme : REBASING, BISECTING, etc. S'il y a des informations de progression (par exemple, REBASING 3/10), ces informations seront également affichées.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[git_state]
format = '[\($state( $progress_current of $progress_total)\)]($style) '
cherry_pick = '[🍒 PICKING](bold red)'

Métriques Git

Le module git_metrics affiche le nombre de lignes ajoutées et supprimées dans le dépôt Git courant.

[!TIP] This module is disabled by default. Pour l'activer, configurez disabled sur false dans votre fichier de configuration.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[git_metrics]
added_style = 'bold blue'
format = '[+$added]($added_style)/[-$deleted]($deleted_style) '

Statut Git

Le module git_status affiche des symboles représentant l’état du dépôt dans le dossier courant.

[!TIP] The Git Status module is very slow in Windows directories (for example under /mnt/c/) when in a WSL environment. Vous pouvez désactiver le module ou utiliser l’option windows_starship pour utiliser un exécutable Starship natif pour calculer le git_status pour ces chemins.

Options

Variables

Les variables suivantes peuvent être utilisées pour la valeur de format:

*: Cette variable peut uniquement être utilisée dans une chaine de style

Les variables suivantes peuvent être utilisées pour la valeur de diverged:

The following variables can be used in conflicted, ahead, behind, untracked, stashed, modified, staged, renamed, deleted, typechanged, worktree_added, worktree_deleted, worktree_modified, worktree_typechanged, index_added, index_deleted, index_modified, and index_typechanged:

Exemple

# ~/.config/starship.toml

[git_status]
conflicted = '🏳'
ahead = '🏎💨'
behind = '😰'
diverged = '😵'
up_to_date = '✓'
untracked = '🤷'
stashed = '📦'
modified = '📝'
staged = '[++\($count\)](green)'
renamed = '👅'
deleted = '🗑'

Afficher le nombre de commits en avance/en retard par rapport à la branche suivie

# ~/.config/starship.toml

[git_status]
ahead = '⇡${count}'
diverged = '⇕⇡${ahead_count}⇣${behind_count}'
behind = '⇣${count}'

Utiliser un exécutable Starship Windows pour les chemins Windows dans WSL

# ~/.config/starship.toml

[git_status]
windows_starship = '/mnt/c/Users/username/scoop/apps/starship/current/starship.exe'

Gleam

The gleam module shows the currently installed version of Gleam. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier gleam.toml
• The current directory contains a file with the .gleam extension

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[gleam]
format = 'via [⭐ $version](bold red) '

Go

Le module golang affiche la version de Go installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier go.mod
• Le dossier courant contient un fichier go.sum
• Le dossier courant contient un fichier go.work
• Le dossier courant contient un fichier glide.yaml
• Le dossier courant contient un fichier Gopkg.yml
• Le dossier courant contient un fichier Gopkg.lock
• Le dossier courant contient un fichier .go-version
• Le dossier courant contient un dossier Godeps
• Le dossier courant contient un fichier avec l’extension .go

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[golang]
format = 'via [🏎💨 $version](bold cyan) '

Using mod_version

# ~/.config/starship.toml

[golang]
format = 'via [$symbol($version )($mod_version )]($style)'

Guix-shell

The guix_shell module shows the guix-shell environment. The module will be shown when inside a guix-shell environment.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[guix_shell]
disabled = true
format = 'via [🐂](yellow bold) '

Gradle

The gradle module shows the version of the Gradle Wrapper currently used in the project directory.

Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• The current directory contains a gradle/wrapper/gradle-wrapper.properties directory.
• The current directory contains a file ending with .gradle or .gradle.kts.

The gradle module is only able to read your Gradle Wrapper version from your config file, we don't execute your wrapper, because of the security concerns.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Haskell

Le module haskell affiche la version de GHC et/ou l’instantané Stack sélectionnée.

Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier stack.yaml
• Le dossier courant contient un fichier .hs, .cabal ou .hs-boot

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Haxe

The haxe module shows the currently installed version of Haxe. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• The current directory contains a project.xml, Project.xml, application.xml, haxelib.json, hxformat.json or .haxerc file
• The current directory contains a .haxelib or a haxe_libraries directory
• The current directory contains a file with the .hx or .hxml extension

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[haxe]
format = "via [⌘ $version](bold fg:202) "

Helm

Le module helm affiche la version de Helm installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier helmfile.yaml
• Le dossier courant contient un fichier Chart.yaml

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[helm]
format = 'via [⎈ $version](bold white) '

Nom d'hôte

Le module hostname affiche le nom d’hôte du système system.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemples

Always show the hostname

# ~/.config/starship.toml

[hostname]
ssh_only = false
format = '[$ssh_symbol](bold blue) on [$hostname](bold red) '
trim_at = '.companyname.com'
disabled = false

Hide the hostname in remote tmux sessions

# ~/.config/starship.toml

[hostname]
ssh_only = false
detect_env_vars = ['!TMUX', 'SSH_CONNECTION']
disabled = false

Replace the hostname with a nickname

# ~/.config/starship.toml
[hostname]
aliases = { "Max's MacBook Pro" = "home" }

Java

Le module java affiche la version de Java installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• The current directory contains a pom.xml, build.gradle.kts, build.sbt, .java-version, deps.edn, project.clj, build.boot, or .sdkmanrc file
• Le dossier courant contient un fichier avec l’extension .java, .class, .gradle, .jar, .clj ou .cljc

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[java]
symbol = '🌟 '

Jobs

Le module jobs affiche le nombre de tâches en cours. Le module ne sera affiché que s'il y a des tâches de fond. Le module affichera le nombre de tâches en cours d’exécution s’il y en a au moins 2, ou plus que la valeur threshold, si elle existe. Le monde affichera un symbole s’il y a au moins 1 tâche, ou plus que la valeur de symbol_threshold, si elle existe. Vous pouvez définir les deux valeurs à 0 pour toujours montrer le symbole et le nombre de tâches, même s’il n’y a aucune tâche en cours d’exécution.

Le fonctionnement par défaut est:

• 0 tâche -> Rien n’est affiché.
• 1 tâche -> symbol est affiché.
• 2 taĉhes ou plus -> symbol + number sont affichés.

[!WARNING] This module is not supported on tcsh.

[!WARNING] The threshold option is deprecated, but if you want to use it, the module will show the number of jobs running if there is more than 1 job, or more than the threshold config value, if it exists. If threshold is set to 0, then the module will also show when there are 0 jobs running.

Options

*: Cette option is dépréciée, utilisez les options number_threshold et symbol_threshold à la place.

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemples

# ~/.config/starship.toml

[jobs]
symbol = '+ '
number_threshold = 4
symbol_threshold = 0

Changing process grouping behavior in fish

When using the Fish shell, Starship counts job groups instead of individual process IDs by default. This prevents overcounting when a pipeline has multiple processes but only one suspended group. To revert to the legacy PID-based counting, please add the following to your shell config:

set -g __starship_fish_use_job_groups "false"

Julia

Le module julia affiche la version de Julia installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier Project.toml
• Le dossier courant contient un fichier Manifest.toml
• Le dossier courant contient un fichier .jl

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[julia]
symbol = '∴ '

Kotlin

Le module kotlin affiche la version de Kotlin installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier .kt ou .kts

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[kotlin]
symbol = '🅺 '

# ~/.config/starship.toml

[kotlin]
# Uses the Kotlin Compiler binary to get the installed version
kotlin_binary = 'kotlinc'

Kubernetes

Afficher le nom du contexte Kubernetes courant, et, si défini, l’espace de nom, l’utilisateur, et le cluster depuis le fichier kubeconfig. L'espace de noms doit être défini dans le fichier kubeconfig, ce qui peut être fait via kubectl config set-context starship-cluster --namespace astronaut. Similarly, the user and cluster can be set with kubectl config set-context starship-context --user starship-user and kubectl config set-context starship-context --cluster starship-cluster. Si la variable d'environnement $KUBECONFIG est définie, le module l'utilisera, sinon il utilisera le fichier ~/.kube/config.

[!TIP] This module is disabled by default. Pour l'activer, configurez disabled sur false dans votre fichier de configuration.

When the module is enabled it will always be active, unless any of detect_env_vars, detect_extensions, detect_files or detect_folders have been set in which case the module will only be active in directories that match those conditions or one of the environmental variables has been set.

Options

[!WARNING] The context_aliases and user_aliases options are deprecated. Use contexts and the corresponding context_alias and user_alias options instead.

*: This option is deprecated, please add contexts with the corresponding context_alias and user_alias options instead.

To customize the style of the module for specific environments, use the following configuration as part of the contexts list:

Note that all regular expression are anchored with ^<pattern>$ and so must match the whole string. The *_pattern regular expressions may contain capture groups, which can be referenced in the corresponding alias via $name and $N (see example below and the rust Regex::replace() documentation).

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[kubernetes]
format = 'on [⛵ ($user on )($cluster in )$context \($namespace\)](dimmed green) '
disabled = false
contexts = [
  { context_pattern = "dev.local.cluster.k8s", style = "green", symbol = "💔 " },
]

Only show the module in directories that contain a k8s file.

# ~/.config/starship.toml

[kubernetes]
disabled = false
detect_files = ['k8s']

Kubernetes Context specific config

The contexts configuration option is used to customise what the current Kubernetes context name looks like (style and symbol) if the name matches the defined regular expression.

# ~/.config/starship.toml

[[kubernetes.contexts]]
# "bold red" style + default symbol when Kubernetes current context name equals "production" *and* the current user
# equals "admin_user"
context_pattern = "production"
user_pattern = "admin_user"
style = "bold red"
context_alias = "prod"
user_alias = "admin"

[[kubernetes.contexts]]
# "green" style + a different symbol when Kubernetes current context name contains openshift
context_pattern = ".*openshift.*"
style = "green"
symbol = "💔 "
context_alias = "openshift"

[[kubernetes.contexts]]
# Using capture groups
# Contexts from GKE, AWS and other cloud providers usually carry additional information, like the region/zone.
# The following entry matches on the GKE format (`gke_projectname_zone_cluster-name`)
# and renames every matching kube context into a more readable format (`gke-cluster-name`):
context_pattern = "gke_.*_(?P<cluster>[\\w-]+)"
context_alias = "gke-$cluster"

Saut de ligne

Le module line_break sépare l'invite en deux lignes.

Options

Exemple

# ~/.config/starship.toml

[line_break]
disabled = true

IP locale

Le module localip affiche l’adresse IPv4 de l’interface réseau principale.

[!TIP] This module is disabled by default. Pour l'activer, configurez disabled sur false dans votre fichier de configuration.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[localip]
ssh_only = false
format = '@[$localipv4](bold red) '
disabled = false

Lua

Le module lua affiche la version de Lua installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier .lua-version
• Le dossier courant contient un dossier lua
• Le dossier courant contient un fichier avec l’extension .lua

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[lua]
format = 'via [🌕 $version](bold blue) '

Maven

The maven module indicates the presence of a Maven project in the current directory. If the Maven Wrapper is enabled, the Maven version will be parsed from .mvn/wrapper/maven-wrapper.properties and shown.

Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier pom.xml.
• The current directory contains a .mvn/wrapper/maven-wrapper.properties file.

If you use an alternate POM syntax (for example pom.hocon), add its filename to detect_files.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Utilisation mémoire

Le module memory_usage affiche la mémoire système actuelle et l'utilisation de swap.

Par défaut, l'utilisation du swap est affichée si le swap total du système n'est pas nul.

[!TIP] This module is disabled by default. Pour l'activer, configurez disabled sur false dans votre fichier de configuration.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style **: Les informations sur le fichier SWAP est uniquement affichée si détectée sur le système courant

Exemple

# ~/.config/starship.toml

[memory_usage]
disabled = false
threshold = -1
symbol = ' '
style = 'bold dimmed green'

Meson

The meson module shows the current Meson developer environment status.

By default the Meson project name is displayed, if $MESON_DEVENV is set.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[meson]
disabled = false
truncation_symbol = '--'
symbol = ' '
style = 'bold dimmed green'

Branche Mercurial

The hg_branch module shows the active branch and topic of the repo in your current directory.

[!TIP] This module is disabled by default. Pour l'activer, configurez disabled sur false dans votre fichier de configuration.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[hg_branch]
format = 'on [🌱 $branch](bold purple)'
truncation_length = 4
truncation_symbol = ''

Mercurial State

The hg_state module will show in directories which are part of a mercurial repository, and where there is an operation in progress, such as: REBASING, BISECTING, etc.

[!TIP] This module is disabled by default. Pour l'activer, configurez disabled sur false dans votre fichier de configuration.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Mise

The mise module shows the current mise health as reported by running mise doctor.

[!TIP] This module is disabled by default. Pour l'activer, configurez disabled sur false dans votre fichier de configuration.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[mise]
health = 'ready'

Mojo

The mojo module shows the current version of Mojo programming language installed

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[mojo]
format = 'via [mojo ($version )($hash )]($style)'

NATS

The nats module shows the name of the current NATS context.

Options

Variables

Exemple

[nats]
format = '[$symbol]($style)'
style = 'bold purple'

Network Namespace

The netns module shows the current network namespace. This uses ip netns identify to get the network namespace, so only network namespaces mounted at /var/run/netns will be detected.

Options

Variables

Exemple

# ~/.config/starship.toml

[netns]
style = 'bold yellow'
symbol = '🌐 '

Nim

Le module nim affiche la version de Nim installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier nim.cfg
• Le dossier courant contient un fichier avec l’extension .nim
• Le dossier courant contient un fichier avec l’extension .nims
• Le dossier courant contient un fichier avec l’extension .nimble

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[nim]
style = 'yellow'
symbol = '🎣 '

Nix-shell

Le module nix_shell affiche la version de l’environnement nix-shell. Ce module s’affichera quand vous serez à l’intérieur d’un environnement nix-shell.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[nix_shell]
disabled = true
impure_msg = '[impure shell](bold red)'
pure_msg = '[pure shell](bold green)'
unknown_msg = '[unknown shell](bold yellow)'
format = 'via [☃️ $state( \($name\))](bold blue) '

Node.js

Le module nodejs affiche la version de Node.js installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier package.json
• Le dossier courant contient un fichier .node-version
• Le dossier courant contient un fichier .nvmrc
• Le répertoire courant contient un répertoire node_modules
• Le dossier courant contient un fichier avec l’extension .js, .mjs ou .cjs
• Le dossier courant contient un fichier avec l’extension .ts, .mts ou .cts

Additionally, the module will be hidden by default if the directory contains a bunfig.toml, bun.lock, or bun.lockb file, overriding the above conditions.

Options

Variables

*: Cette variable peut uniquement être utilisée dans une chaine de style

Exemple

# ~/.config/starship.toml

[nodejs]
format = 'via [🤖 $version](bold green) '

OCaml

Le module ocaml affiche la version de OCaml installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie:

• Le dossier courant contient un fichier avec l’extension .opam ou un dossier _opam
• Le répertoire courant contient un répertoire esy.lock
• Le dossier courant contient un fichier dune ou dune-project
• Le dossier courant contient un fichier jbuild ou jbuild-ignore
• Le dossier courant contient un fichier .merlin
• Le dossier courant contient un fichier avec l’extension .ml, .mli, .re ou .rei

Options

Variables