starship-config

Configure, customize, and manage Starship prompts with preset application, module tuning, and environment-aware context.

193|16|Updated Mar 10, 2023

Search Tags:#performance #config #shell #module #prompt #preset #starship

Ready to run

npx skills add https://github.com/wcygan/dotfiles --skill starship-config

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: starship-config
Source: https://github.com/wcygan/dotfiles/tree/main/.claude/skills/starship-config
Command: npx skills add https://github.com/wcygan/dotfiles --skill starship-config

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill manages the Starship cross-shell prompt lifecycle, enabling presets, module customization, and performance tuning to simplify shell configuration and improve prompt clarity.

Core Features & Use Cases

Preset management: Apply and preview starter configurations.
Module configuration: Customize common modules like golang, nodejs, git, and directory.
Performance tuning: Adjust timings and loading behavior to optimize prompt rendering.
Context-aware variables: Show context (kubectl, aws, docker) when available.

Quick Start

Apply a preset: starship preset <preset-name> -o ~/.config/starship.toml
Edit modules in config/starship/starship.toml
Test in isolation: export STARSHIP_CONFIG=./config/starship/starship.toml; exec fish -l

Frequently Asked Questions about starship-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I configure Starship prompt presets for my shell?▼

Starship presets are starter configurations you apply using `starship preset <preset-name> -o ~/.config/starship.toml`. This command downloads a preconfigured prompt setup and writes it to your Starship config file, letting you customize modules like git, nodejs, and directory display without building from scratch.

What modules can I customize in Starship and how do I tune them?▼

Starship supports common modules including golang, nodejs, git, and directory. Edit `~/.config/starship.toml` to customize each module's behavior, format, and display conditions. You can also adjust timings and loading behavior to optimize how quickly your prompt renders.

How do I improve shell prompt performance in Starship?▼

Performance tuning in Starship involves adjusting module timings and loading behavior in your config file to reduce prompt rendering latency. Disable expensive modules, set timeouts, or use context-aware variables to show information only when relevant, speeding up shell startup.

Can I test Starship configurations before applying them system-wide?▼

Yes. Set `export STARSHIP_CONFIG=./config/starship/starship.toml` and run `exec fish -l` (or your shell) to test a config file in isolation. This lets you preview module changes and performance tuning without affecting your active prompt.

Does Starship support context-aware variables like kubectl and AWS?▼

Starship includes context-aware modules that display kubectl, AWS, and Docker information when available in your environment. Configure these modules in your preset or custom config to show deployment context only when relevant to your current shell session.

What shells and environments does Starship prompt configuration work with?▼

Starship is a cross-shell prompt that works across different shells and environments. Presets and module configurations apply consistently, and you can test setup across shells by setting the config path and executing your shell of choice.