y-cli 0.3.1

Command-line real-time conversation app

y-cli 🚀

A tiny command-line interface chat application that brings AI conversations to your terminal.

✨ Features

• 💬 Interactive chat interface
• 🤖 Support for multiple bot configurations (any base_url/api_key/model combination compatible with OpenAI chat completion streaming format)
• 📝 All chat data stored in single JSONL files for easy access and sync
• 🔗 MCP (Model Context Protocol) client support
• 🤔 Deepseek-r1 reasoning content support for enhanced AI responses

Demo

MCP client

asciicast

reasoning content

asciicast

⚡ Quick Start

Prerequisites

Required:

1. uv
2. OpenRouter API key

Setup Instructions:

1. uv

   • Follow the official installation guide
   • uv will automatically manage Python installation

2. OpenRouter API key

   • Visit OpenRouter Settings
   • Create a new API key
   • Save it for the initialization step

Run without Installation

uvx y-cli

Install with uv tool

uv tool install y-cli

Initialize

y-cli init

Start Chat

y-cli chat

🛠️ Usage

y-cli [OPTIONS] COMMAND [ARGS]...

Commands

• chat Start a new chat conversation or continue an existing one
• list List chat conversations with optional filtering
• share Share a chat conversation by generating a shareable link
• bot Manage bot configurations:
  • add Add a new bot configuration
  • list List all configured bots
  • delete Delete a bot configuration

Options

• --help Show help message and exit