stellar — A CLI tool to find and switch starship themes…

Pitch

Description

Comments

About this project

Stellar simplifies the process of finding and applying starship themes. Easily switch between different configurations, explore community themes, and streamline your workflow. With a user-friendly interface and quick installation, enhancing your terminal experience has never been easier.

Stellar CLI: A Command-Line Interface (CLI) Tool for Starship Theme Management

Stellar is an innovative command-line tool designed to simplify the process of managing and switching between Starship prompt configurations. With its intuitive interface, users can effortlessly apply, preview, and manage community-driven themes to personalize their command-line environment.

Key Features

Easy Theme Switching: Quickly switch between different Starship themes without requiring manual configuration. Just type stellar apply <author>/<theme> to set your new theme.
Community Hub: Discover and explore a variety of themes available at the Stellar Hub, making it easy to find the perfect look for your terminal.
Version Control: Maintain multiple versions of themes with commands to apply specific versions, check for updates, or roll back changes.
Automatic Backups: Stellar ensures your existing configuration is backed up automatically, allowing users to revert at any time without the risk of losing previous settings.
Flexible Configurations: Customize themes locally by editing downloaded configurations or creating new themes that suit personal needs. Themes can be stored in ~/.config/stellar/<username>/<theme>/ and easily switched between.

Basic Usage Examples

# Apply a new theme
stellar apply a3chron/ctp-blue

# Preview a theme before applying
stellar preview a3chron/ctp-red

# List cached themes
stellar list

# Remove a specific version of a theme
stellar remove a3chron/ctp-green@1.0

Publishing and Contributing

Users can contribute by uploading their own Starship themes to the Stellar Hub. This fosters a community-driven ecosystem where contributors can share their configurations and improvements.

The CLI also supports conventional commits for pull requests, ensuring a clean and organized contribution process.

Troubleshooting

Stellar provides clear error messages and useful information when connectivity issues occur or when there are problems with theme availability. Users are encouraged to refer to troubleshooting guidelines for resolving common issues.

Future Development

Ongoing enhancements are planned, including support for light/dark themes, better theme management commands, and automated theme publishing capabilities.

For detailed information and updates, refer to the Stellar GitHub repository.