Skip to content

xhjkl/please

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

97 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ™πŸ™πŸ™

A command-line tool that lets you interact with your terminal in natural language. All inference stays local.

The name is chosen so that the invocation reads like a natural-language phrase.

please-screencast.mp4

Installation

First, install the tool itself. You can get it from Homebrew:

$ brew install xhjkl/made/please

Or with the installer script:

# either the above, or this:
$ curl -fsSL xhjkl.xyz/please | sh

Then, download the weights just once:

$ please load

And, optionally, verify them:

$ sha256sum ~/.please/weights/gpt-oss-20b-mxfp4.gguf
be37a636aca0fc1aae0d32325f82f6b4d21495f06823b5fbc1898ae0303e9935

Usage

$ git diff --cached | please summarize to a concise commit message
$ please take the creds from Justfile and make a fuzzer one-off script > fuzz.ts
$ please format all the git-staged files
$ please tar the current folder but without git-ignored files
$ please resolve all the merge conflicts in the current folder
$ please fix all clippy diagnostics

Bridging

You can run please in a different environment, such as a remote shell or a container, while keeping inference and weights on your machine. This avoids copying weights around and lets you keep using your local compute power. For a remote machine, set up SSH socket forwarding as described in BRIDGING.md; for a Docker container, mount the host socket into the container as described in DOCKER.md.

About

A polite LLM for CLI πŸ™

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages