Saltar al contenido principal
Inicio Habilidades Proyectos Blog Recetas Cursos Dev Tools
Base64 Encoders / Decoders URL Encoders / Decoders JWT Encoders / Decoders QR/Barcode Encoders / Decoders JSON ↔ YAML Converters Epoch ↔ Date Converters Hex ↔ RGB Converters JSON Formatters SQL Formatters Google Dorks Generators UUID Generators Password Generators Lorem Ipsum Generators Diff Text Utils Word Counter Text Utils Face Anonymizer AI / ML Token Counter AI / ML
Milanesas de pollo Pan francés (French Toast) Huevos benedictos Marinado de mostaza Japanese Cotton Cheesecake Mermelada de fresa Hotcakes Mezcla de harina para hotcakes Marinado de carne
Aprende SQL Aprende SQL: Consultas básicas con SELECT Aprende SQL: Filtrando datos: WHERE y operadores Aprende SQL: Búsquedas avanzadas: BETWEEN, IN y LIKE Aprende SQL: Ordenando y eliminando duplicados: ORDER BY y DISTINCT Aprende SQL: Fundamentos de SELECT Aprende SQL: Uniendo tablas: Introducción a JOINs Aprende SQL: JOINs externos: LEFT, RIGHT y FULL OUTER JOIN Aprende SQL: Manejo de valores nulos: NULL en SQL Aprende SQL: Uniones y valores nulos Aprende SQL: Expresiones en SQL: Cálculos y manipulaciones Aprende SQL: Agregando datos: COUNT, SUM, AVG, MIN y MAX Aprende SQL: Agrupando datos: GROUP BY y HAVING Aprende SQL: El orden de ejecución en SQL Aprende SQL: Agregación y ejecución Aprende SQL: Añadiendo registros: INSERT INTO Aprende SQL: Modificando datos: UPDATE Aprende SQL: Eliminando registros: DELETE Aprende SQL: Manipulación de datos
Cambiar tema
Alternar paleta Solarized
Cambiar idioma
Volver al blog
· 6 min de lectura

Starship: un prompt minimalista y veloz para cualquier shell

Guía de referencia de Starship: instalación, configuración en TOML, personalización de módulos, presets y buenas prácticas para tener un prompt informativo y rápido en tu terminal.

linux terminal sre

Contenido

Starship es un prompt de línea de comandos minimalista, extremadamente rápido y altamente personalizable. Escrito en Rust, funciona en cualquier shell y sistema operativo, mostrando información contextual relevante como la rama de Git, versión del lenguaje, estado del repositorio y duración de comandos, todo sin sacrificar la velocidad de tu terminal.

Requisitos previos

Antes de instalar Starship, necesitas una Nerd Font instalada y habilitada en tu emulador de terminal. Las Nerd Fonts son fuentes parcheadas que incluyen íconos y glifos adicionales que Starship usa para mostrar símbolos.

Puedes descargar una desde nerdfonts.com. Una opción popular es FiraCode Nerd Font.

Instalación

Script de instalación (Linux/macOS)

curl -sS https://starship.rs/install.sh | sh

Gestores de paquetes

# Homebrew (macOS/Linux)
brew install starship

# Arch Linux
pacman -S starship

# Ubuntu 25.04+
apt install starship

# Cargo (Rust)
cargo install starship --locked

Verifica la instalación:

starship --version

Configuración del shell

Después de instalar Starship, agrega la línea de inicialización al archivo de configuración de tu shell:

Bash

Agrega al final de ~/.bashrc:

eval "$(starship init bash)"

Zsh

Agrega al final de ~/.zshrc:

eval "$(starship init zsh)"

Fish

Agrega al final de ~/.config/fish/config.fish:

starship init fish | source

PowerShell

Agrega al final de tu $PROFILE:

Invoke-Expression (&starship init powershell)

Reinicia tu shell o ejecuta source sobre el archivo de configuración para activar Starship.

Archivo de configuración

Starship se configura mediante un archivo TOML ubicado en ~/.config/starship.toml:

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

Para usar una ubicación diferente, establece la variable de entorno STARSHIP_CONFIG:

export STARSHIP_CONFIG=~/dotfiles/starship.toml

Opciones globales del prompt

Las opciones de nivel superior controlan el comportamiento general del prompt:

# ~/.config/starship.toml

# Agrega una línea en blanco entre prompts
add_newline = true

# Timeout para escaneo de archivos (ms)
scan_timeout = 30

# Timeout para ejecución de comandos (ms)
command_timeout = 500
Opción Por defecto Descripción
format '$all' Define el orden y contenido del prompt
add_newline true Línea en blanco entre prompts
scan_timeout 30 Timeout de escaneo de archivos (ms)
command_timeout 500 Timeout de ejecución de comandos (ms)
palette '' Paleta de colores personalizada a usar

Módulos principales

Starship organiza la información del prompt en módulos. Cada módulo muestra información contextual y solo aparece cuando es relevante.

Carácter

El símbolo que indica si el último comando fue exitoso o no:

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

Directorio

Controla cómo se muestra la ruta del directorio actual:

[directory]
truncation_length = 3
truncate_to_repo = true
style = 'bold cyan'
read_only = '🔒'

Git Branch

Muestra la rama activa del repositorio Git:

[git_branch]
symbol = '🌱 '
truncation_length = 4
truncation_symbol = '…'

Git Status

Muestra indicadores del estado del repositorio (archivos modificados, staged, conflictos, etc.):

[git_status]
conflicted = '⚔️ '
ahead = '⇡${count}'
behind = '⇣${count}'
diverged = '⇕⇡${ahead_count}⇣${behind_count}'
untracked = '?${count}'
stashed = '📦 '
modified = '!${count}'
staged = '+${count}'

Duración del comando

Muestra cuánto tardó en ejecutarse el último comando (solo si supera el umbral):

[cmd_duration]
min_time = 500
format = 'took [$duration](bold yellow)'
show_milliseconds = false

Módulos de lenguaje

Starship detecta automáticamente el contexto del proyecto y muestra la versión del lenguaje o runtime activo. Algunos ejemplos:

[nodejs]
symbol = '⬢ '
format = 'via [$symbol($version )]($style)'

[python]
symbol = '🐍 '
format = 'via [${symbol}${pyenv_prefix}(${version} )(\($virtualenv\) )]($style)'

[rust]
symbol = '🦀 '
format = 'via [$symbol($version )]($style)'
style = 'bold red'

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

Desactivar un módulo

Para ocultar cualquier módulo, usa la opción disabled:

[package]
disabled = true

[docker_context]
disabled = true

Cadenas de estilo

Los estilos en Starship combinan colores y efectos de texto:

# Color de texto y fondo
format = '[on](red bold) [$version](bold green)'

# Colores hexadecimales
style = 'bold fg:#e3e5e5 bg:#bf5700'

Efectos disponibles: bold, italic, underline, dimmed, inverted, blink, strikethrough.

Los colores se especifican como nombres (red, green, blue) o códigos hexadecimales (#ff0000), precedidos opcionalmente por fg: o bg:.

Personalización del formato del prompt

Puedes reorganizar completamente el prompt definiendo la variable format:

format = """
[┌──](bold green) $directory$git_branch$git_status
[└─>](bold green) $character"""

Los grupos condicionales permiten mostrar texto solo cuando una variable tiene valor:

# Muestra "@region" solo si $region no está vacío
format = '(@$region)'

Presets

Starship incluye presets predefinidos que aplican configuraciones completas con un solo comando:

# Ver presets disponibles
starship preset --list

# Aplicar un preset (se escribe en starship.toml)
starship preset catppuccin-powerline -o ~/.config/starship.toml

Presets destacados:

Preset Descripción
nerd-font-symbols Usa símbolos de Nerd Font en cada módulo
no-nerd-font Reemplaza todos los símbolos para no depender de Nerd Fonts
bracketed-segments Envuelve cada módulo en corchetes
plain-text-symbols Usa símbolos de texto plano, sin Unicode
no-runtime-versions Oculta versiones de runtimes (ideal para contenedores)
pastel-powerline Estilo powerline con colores pastel
tokyo-night Inspirado en el tema Tokyo Night
gruvbox-rainbow Inspirado en la paleta Gruvbox
catppuccin-powerline Estilo powerline con la paleta Catppuccin

Logs y depuración

Starship guarda logs de sesión en ~/.cache/starship/. Para cambiar la ubicación:

export STARSHIP_CACHE=~/.starship/cache

Para depurar problemas con el prompt:

# Muestra información de depuración
starship explain

# Imprime los tiempos de cada módulo
starship timings

Buenas prácticas

  • Empieza con un preset — aplica un preset como base y ajusta los módulos según tus necesidades en lugar de configurar todo desde cero.
  • Desactiva módulos innecesarios — cada módulo activo puede agregar latencia al prompt. Desactiva los que no uses con disabled = true.
  • Ajusta los timeouts — si trabajas con repositorios grandes, incrementa command_timeout para evitar que la información de Git se corte.
  • Usa starship timings — identifica qué módulos son los más lentos y optimiza o desactiva los que no justifiquen su costo.
  • Versiona tu configuración — incluye starship.toml en tu repositorio de dotfiles para mantener la misma experiencia en todas tus máquinas.
  • Aprovecha los grupos condicionales — usa la sintaxis (contenido) en los formatos para que elementos opcionales no dejen espacios vacíos cuando no aplican.

Compartir