Skip to content

getsavvyinc/savvy-cli

Repository files navigation

Savvy

Savvy is the easiest way to create, share and run workflows from your terminal.

Savvy's CLI generates workflows with AI or from commands you provide.

Install Savvy's CLI

curl -fsSL https://install.getsavvy.so | sh

Generate Workflows using your commands

Use savvy record or savvy record history to create a workflow using commands you provide.

You don't have to change anything about your shell or aliases, savvy auto expands all aliases to make sure your workflow runs reliably on any machine.

Create Workflows from your Shell History

Use savvy record history to go back in time and create a workflows by selecting just the commands you want.

Savvy will never execute any command you select.

savvy record history

Sharing Workflows

Workflows are private by default, but you can share them using a public or unlisted link from Savvy's dashboard.

You can also export workflows to markdown and paste them in your existing docs.

Create Workflows with Savvy Record

savvy record starts a new shell and all commands in this shell are recorded and sent to an LLM to generate a workflow.

Savvy Workflow

Note

Creating a workflow with savvy record requires you to signup for a free account.

Automatically Run Workflows

Use savvy run to search and run workflows right from your terminal.

Savvy automatically fills in the next command to execute. Just press enter to run it.

savvy run

Workflow Placeholders

Parameterizing workflows is very easy with Savvy.

Replace hardcoded values with <parameters> from the dashboard for any step. Savvy takes care of the rest.

savvy run automatically detects any <parameters> and prompts users to fill in the value only once per parameter.

set param dashboard set param runtime

Check our docs for more details on workflow placeholders

Sync Workflows

Use savvy sync to keep a local copy of your workflows. If you're ever offline or in bad network conditions, you can still run your workflows with savvy run --local

Savvy Sync

Generate Workflows with AI

Use savvy ask to generate entire workflows or a single command using natural language.

Just run savvy ask and provide a prompt.

Any one can use it, there's no need to signup for an account or provide a credit card.

Examples

  1. Ask Savvy to create a workflow for publishing a new go module.

Ask Savvy to create a workflow for publishing a new go module.

  1. Ask Savvy to help you with a tricky sequence of shell commands.

Ask Savvy to help you with a tricky shell command

Savvy Explain

Not sure what a particular command or flag does? Don't want to research an opaque error message? then savvy explain is for you.

Savvy explain generates a simple and easy to understand explanation for any command or error message before you can say RTFM!

Examples

  1. Use savvy explain to understand everything that goes into parsing a x509 certificate with openssl

savvy explain openssl

  1. Dive into an error message and learn troubleshooting next steps.

savvy explain errors

FAQ

  1. How do I Install Savvy?
curl -fsSL https://install.getsavvy.so | sh
  1. How do I uninstall Savvy?
rm -rf ~/.savvy
rm -rf ~/.config/savvy
  1. How do I upgrade Savvy?

Run savvy upgrade to get the latest version of the CLI.

  1. How do I login?

Run savvy login to start the login flow.

  1. What shells does Savvy support?

Savvy supports zsh, bash, and fish.

Please create an issue if you'd like us to support your favorite shell.

  1. Does Savvy work on Windows?

Not yet.

  1. I'm stuck. How do I get help?

If you need assistance or have questions: