Skip to content

natanmedeiros/dynamic-alias

Repository files navigation

Dynamic Alias

Dynamic Alias (dya)

A declarative CLI builder that transforms complex command-line workflows into simple, memorable aliases with smart autocompletion.

Why Dynamic Alias?

Modern infrastructure professionals juggle dozens of CLI tools daily—AWS, GCP, Azure, Kubernetes, databases, and more. Each tool has its own syntax, flags, and resource identifiers. Dynamic Alias lets you define once, use everywhere:

# Instead of remembering:
aws ssm start-session --target i-0abc123def456 --region us-east-1

# Just type:
dya ssm prod-web-server

Quick Start

# Install
pip install dynamic-alias

# Create ~/.dya.yaml
echo "
config:
  history-size: 100

---
type: command
name: Hello World
alias: hello
command: echo 'Hello from Dynamic Alias!'
" > ~/.dya.yaml

# Run
dya hello

Documentation

Topic Description
Getting Started Installation, first config, running
Configuration YAML structure, config block, styles
Static Dicts Defining static data sources
Dynamic Dicts Fetching data from external commands, caching, TTL
Commands Aliases, subcommands, arguments
Helper System Auto/custom helper types, array aliases
Features Strict mode, timeout, history
Interactive Mode Shell, autocomplete, history navigation

Examples

Real-world configurations for cloud providers:

Example Description
AWS SSO login, SSM sessions, RDS PostgreSQL, ElastiCache
GCP gcloud auth, Compute SSH, Cloud SQL, Memorystore
Azure az login, VM SSH, PostgreSQL, Redis Cache
OCI oci session, Compute SSH, Autonomous DB, Redis
Custom CLI Building your own branded CLI

Use Cases

Infrastructure Professionals

DBAs, SREs, DBREs, and DevOps engineers who work with multiple tools and dozens of resources daily. Stop memorizing instance IDs—let Dynamic Alias remember them for you.

Companies Building Internal CLIs

Create a declarative, customizable CLI for your organization. Define your company's resources in YAML and distribute a branded tool to your teams.

Roadmap

Recently Added

  • Cache Encryption - Automatic encryption using machine identifier (Windows GUID, Linux/macOS machine-id)

Upcoming

  • OS Package Publishing - Debian (.deb), RPM, Windows installer
  • Homebrew Publication - macOS/Linux via Homebrew

License

MIT License - See LICENSE for details.

About

A declarative CLI builder that transforms complex command-line workflows into simple, memorable aliases with smart autocompletion.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Contributors

Languages