MCPcopy Index your code
hub / github.com/Guitaricet/howto

github.com/Guitaricet/howto @v2.0.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.0.2 ↗ · + Follow
26 symbols 63 edges 8 files 2 documented · 8%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Howto

Howto is a GPT-3/Codex-powered shell tool that allows you to talk with your shell in natural language.

Howto demo

Forgot how to create a conda environment?

% howto create conda env
conda create -n <env_name> python=3.6

Forgot how to add a new env to Jupyter?

% howto add kernel to jupyter
python -m ipykernel install --user --name=

Want to download the biggest Rick Astley's hit?

% howto download youtube video for never give you up
youtube-dl -f 18 https://www.youtube.com/watch?v=dQw4w9WgXcQ

Howto can also suggest how to be a nicer person

 % howto be a nicer person
alias please='sudo'

It works by sending requests to OpenAI API. Lookup Environment Variables section on how to set up the API key.

Installation

Two-liner

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Guitaricet/howto/main/scripts/get_latest.sh)"
sudo mv howto /usr/local/bin/  # howto.exe on windows

When first calling howto it will ask you to set up the API key. Get your OpenAI API key here.

Download the binary from Github

OS Architecture Link
Linux x86_64 howto-linux-x86_64
MacOS x86_64 (Intel) howto-darwin-x86_64
MacOS arm64 (M1) howto-darwin-arm64
Windows x86_64 howto-windows-x86_64

Full list of architectures can be found on the release page.

Then untar it and add it to your PATH. For example:

tar -xvf howto-v2.0.1-darwin-amd64.tar.gz
mv howto /usr/local/bin/

moving the binary to /usr/local/bin can require sudo rights

Build from source

If you have Go installed, you can build the binary from source.

go build

Then move the binary to your path, e.g., mv howto /usr/local/bin/

Disclaimer

Howto suggestions are generated by an AI model and are not guaranteed to be safe to execute or to be executable at all. Please use common sense when using the suggested commands.

Core symbols most depended-on inside this repo

AskQuestion
called by 6
pkg/utils.go
GetConfigPath
called by 4
pkg/utils.go
GetStatePath
called by 4
pkg/state.go
GetConfig
called by 3
pkg/utils.go
GetHowtoDir
called by 2
pkg/utils.go
PrintConfig
called by 2
pkg/utils.go
Save
called by 2
pkg/state.go
isValidResponse
called by 1
pkg/utils.go

Shape

Function 19
Struct 6
Method 1

Languages

Go100%

Modules by API surface

pkg/utils.go10 symbols
pkg/state.go5 symbols
pkg/openai.go5 symbols
pkg/setup.go2 symbols
pkg/secret.go2 symbols
pkg/generate.go1 symbols
main.go1 symbols

For agents

$ claude mcp add howto \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page