nostromo
A CLI tool for building and managing complex command aliases and multi-dimensional tools declaratively.
What is nostromo?
Nostromo is a CLI tool that helps developers build and manage powerful aliases and multi-dimensional command tools declaratively. It solves the tedium of manually updating shell profiles by providing a structured way to create hierarchical commands, substitutions, and distributed manifests, turning complex workflows into simple, intuitive commands.
Developers and system administrators who frequently use shell aliases and want to create scalable, organized command-line tools for repetitive tasks or complex workflows.
Nostromo stands out by enabling declarative command trees with scoped substitutions, distributed manifests for team collaboration, and support for multiple execution modes, making it a versatile alternative to manual alias management or simpler alias tools.
Overview
👽 CLI for building powerful aliases and tools
Use Cases
Best For
- Simplifying and organizing complex shell alias collections
- Building custom CLI tools with hierarchical command structures
- Automating multi-step development or deployment workflows
- Sharing and synchronizing command sets across teams via distributed manifests
- Replacing long, repetitive commands with short, memorable aliases
- Adding shell completion and descriptions to custom commands
Not Ideal For
- Users on non-MacOS systems or shells other than bash/zsh, as compatibility is untested and may fail
- Developers who only need a handful of static aliases and prefer the simplicity of directly editing .bashrc or .zshrc files
- Environments with strict security policies that restrict installing or sourcing external CLI tools for shell integration
- Teams requiring real-time, collaborative editing of aliases without a sync step, as Nostromo relies on manual manifest updates or docks
Pros & Cons
Pros
Automatically updates shell profiles without manual edits, as shown in the 'Managing Aliases' section, saving time and reducing errors.
Enables building multi-level, intuitive commands using keypaths, mirroring tools like git or docker for complex workflows.
Provides tab completion for all managed commands with custom descriptions, enhancing usability and discoverability directly in the shell.
Supports docking multiple sources (e.g., Git, S3) for easy command sharing and synchronization across teams or projects.
Cons
Officially only tested on MacOS with bash/zsh, leaving Windows, Linux variants, or shells like fish potentially unsupported or buggy.
Overkill for basic alias needs, requiring learning keypaths, modes, and manifest management compared to straightforward shell alias commands.
Distributed manifests can introduce conflicts or unwanted updates during sync, requiring manual intervention and careful version control.
Frequently Asked Questions
Related Projects
fzf:cherry_blossom: A command-line fuzzy finder
diveA tool for exploring each layer in a docker image
HubA command-line tool that makes git easier to use with GitHub.
lo💥 A Lodash-style Go library based on Go 1.18+ Generics (map, filter, contains, find...)
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.