Content
# viby
[](https://github.com/JohanLi233/viby)
[](https://www.python.org/downloads/release/python-3100/)
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://github.com/astral-sh/uv)
[](https://github.com/estitesc/mission-control-link)
English | [中文](https://github.com/JohanLi233/viby/blob/main/README.zh-CN.md)
A multifunctional command-line tool for interacting with large language models.
## Features
- Ask questions and get AI-generated answers
- Interactive chat mode for multi-turn conversations
- Generate shell commands and explanations
- Process piped input (e.g., content from `git diff`)
- Support for OpenAI-compatible API interfaces
## Installation
```sh
pip install viby
```
### OR install from source
```sh
uv pip install -e .
```
## Usage Examples
### Basic Question
```sh
yb "Write a quicksort in python"
# -> Sure! Here is a quicksort algorithm implemented in **Python**:
```
### Interactive Chat Mode
```sh
yb -c
|> Tell me about quantum computing
# -> [AI responds about quantum computing]
|> What are the practical applications?
# -> [AI responds with follow-up information]
```
### Process Piped Content
```sh
git diff | yb "Generate a commit message"
# -> Added information to the README
```
```sh
yb "What is this project about?" < README.md
# -> This project is about...
```
### Generate Shell Command
```sh
yb -s "How many lines of python code did I write?"
# -> find . -type f -name "*.py" | xargs wc -l
# -> [r]run, [e]edit, [y]copy, [c]chat, [q]quit (default: run):
```
### Use MCP Tools
```sh
yb -t "What time is it now?"
# -> [AI uses time tool to get current time]
# -> "datetime": "2025-05-03T00:49:57+08:00"
```
## Configuration
Viby reads configuration from `~/.config/viby/config.json`. You can set the model and parameters here.
### MCP Server Configuration
Viby supports Model Context Protocol (MCP) servers for extended capabilities. MCP configurations are stored in `~/.config/viby/mcp_servers.json`.