y-cli logo

y-cli

by luohy15

y-cli is a command-line interface chat application that brings AI conversations directly to your terminal. It offers flexible storage options and supports multiple bot configurations for interacting with various AI models.

View on GitHub

Last updated: N/A

What is y-cli?

y-cli is a terminal-based chat application that allows users to have AI conversations within their command-line interface. It supports various AI models and provides features such as persistent storage and tool execution visualization.

How to use y-cli?

To use y-cli, first install the necessary dependencies (uv). Then, install y-cli using uv tool install y-cli or run it directly with uvx y-cli. Initialize the application with y-cli init and start a chat session with y-cli chat. You'll also need an OpenRouter API key.

Key features of y-cli

  • Flexible storage options (local JSONL, Cloudflare KV/R2)

  • Interactive chat interface with tool execution visualization

  • Support for multiple bot configurations (OpenAI, Dify, etc.)

  • Support for reasoning models

  • MCP (Model Context Protocol) integration

Use cases of y-cli

  • Have AI-powered conversations in the terminal

  • Quickly access and manage AI interactions

  • Experiment with different AI models and configurations

  • Utilize reasoning models within the cli environment

FAQ from y-cli

How do I install y-cli?

You can install y-cli using the uv tool: uv tool install y-cli. Alternatively run via command uvx y-cli.

What API key do I need?

You will need an OpenRouter API key to use some models. Get one at OpenRouter Settings

How do I start a chat?

After initializing with y-cli init, start a chat session by typing y-cli chat.

How do I add a new bot configuration?

Use the command y-cli bot add to add a new bot configurations.

What are MCP Servers?

MCP Servers are Model Context Protocol servers, used as a client to interact with AI models and services.