GitHub – pizlonator/yosh: Yo shell

Yosh is an LLM-enabled shell. It’s a custom build of GNU Bash 5.2.32 with GNU Readline 8.2.13, featuring built-in integration with Claude for natural language command generation and assistance.

The key feature is the yo command: type yo at the prompt and the shell calls Claude to either generate a shell command or answer a question directly.

• Natural language to shell commands: Type yo list all python files modified today and get an executable command prefilled at your prompt
• Interactive Q&A: Ask questions like yo what does the -exec flag in find do? and get answers inline
• Session memory: The shell remembers your conversation within a session for context-aware assistance
• Terminal awareness: Claude can read your recent terminal output to understand what you’re working on
• Multi-step tasks: Complex tasks can be broken into multiple commands that Claude guides you through sequentially

If you have a pre-built yosh binary:

1. Copy the binary to your path:

   sudo cp yosh /usr/local/bin/
   sudo chmod 755 /usr/local/bin/yosh

2. Add yosh to your available shells:

   echo '/usr/local/bin/yosh' | sudo tee -a /etc/shells

3. Set yosh as your default shell (optional):

   chsh -s /usr/local/bin/yosh

4. Set up your API key:

   echo 'your-anthropic-api-key' > ~/.yoshkey
   chmod 600 ~/.yoshkey

Yosh is built using the Fil-C memory-safe compiler toolchain. You’ll need Fil-C installed at /opt/fil.

git clone git@github.com:pizlonator/yosh.git
cd yosh

Full build (configures and builds readline + bash from scratch):

Incremental build (faster rebuilds when making code changes):

The built binary will be at ./prefix/bin/yosh.

Your Anthropic API key must be stored in ~/.yoshkey with mode 0600:

echo 'your-anthropic-api-key' > ~/.yoshkey
chmod 600 ~/.yoshkey

Once yosh is running, use the yo command:

# Generate a command
yo find all files larger than 100MB

# Ask a question
yo how do I undo the last git commit?

# Context-aware help (Claude can see your terminal)
yo why did that command fail?

When Claude generates a command, it appears prefilled at your prompt. Press Enter to execute it, or edit it first. Press Ctrl-C or enter an empty line to cancel.

Source code is available at:

git@github.com:pizlonator/yosh.git

Yosh is based on GNU Bash and GNU Readline, both of which are licensed under the GNU General Public License version 3 (GPLv3).

This means yosh is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Yosh also includes cJSON for JSON parsing, which is licensed under the MIT License.

See the LICENSE.txt file for the full license text.