viby 0.0.7

Viby agent at your terminal

viby

English | 中文 Viby agent at your terminal

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
• MCP (Model Context Protocol) tools integration for extended capabilities

Installation

pip install viby

OR install from source

uv pip install -e .

Usage Examples

Basic Question

yb "Write a quicksort in python"
# -> Sure! Here is a quicksort algorithm implemented in **Python**:

Interactive Chat Mode

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

git diff | yb "Generate a commit message"
# -> Added information to the README

yb "What is this project about?" < README.md
# -> This project is about...

Generate Shell Command

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): 

Automatically Use MCP Tools When Needed

yb "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.yaml. You can set the model, parameters, and MCP options here.

Interactive Configuration

Use the configuration wizard to set up your preferences:

yb --config

This allows you to configure:

• API endpoint and key
• Model
• Temperature and token settings
• MCP tools enablement
• Interface language

MCP Server Configuration

Viby supports Model Context Protocol (MCP) servers for extended capabilities. MCP configurations are stored in ~/.config/viby/mcp_servers.json.