rcl

Save commands. Run them later.

I got tired of scrolling through shell history trying to find that one deploy command I ran two weeks ago. And aliases are fine, but I never remember what I named them.

So I built this. It's like npm run but for... everything else.

Install

npm install -g rcl-cli

How it works

# First time setup
rcl init

# Save a command you'll want to run again
rcl save deploy "git push origin {{branch}} && ssh prod 'cd /app && git pull'"

# Later, run it
rcl run deploy --branch main

# Forgot what it does?
rcl explain deploy

That's pretty much it.

Commands

rcl init — Sets things up. Run this once.

rcl save <name> "<command>" — Save a command. Use {{param}} for stuff you want to fill in later.

rcl list — See what you've saved.

rcl find <keyword> — Search your commands.

rcl run <name> --param value — Run a saved command with your values filled in.

rcl explain <name> — Show the full command and what params it needs.

A few things worth knowing

• Commands live in ~/.rcl/commands.json
• If a command has rm, delete, or --force in it, you'll need to add --confirm to run it
• That's a feature, not a bug

Why not just use aliases?

You could! But I always forget:

1. What I named them
2. What arguments they take
3. Where I defined them

This fixes all three.

License

MIT — do whatever you want with it.

GitHub