y-cli 0.3.12

Command-line real-time conversation app

y-cli 🚀

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

✨ Features

• 📝 Flexible storage options:
  • Local JSONL files for easy access and sync
  • Cloudflare KV and R2 for cloud storage and backup
• 💬 Interactive chat interface with tool execution visualization
• 🤖 Support for multiple bot configurations (any base_url/api_key/model combination). Supported api format type:
  • OpenAI chat completion streaming format
  • Dify chat-messages streaming format
• 🤔 Support for reasoning model
  • Deepseek-r1 reasoning_content output print
  • OpenAI o3-mini reasoning_effort configuration
• 🔗 MCP (Model Context Protocol) integration:
  • Client support with multiple server configurations (stdio/SSE)
  • Persistent daemon
  • Custom prompt configurations

Demo

Interactive chat

Multiple bot configurations

➜  ~ y-cli bot list
Name         API Key      API Type    Base URL                             Model                                Print Speed    Description    OpenRouter Config    MCP Servers    Reasoning Effort
-----------  -----------  ----------  -----------------------------------  -----------------------------------  -------------  -------------  -------------------  -------------  ------------------
default      sk-or-v1...  N/A         https://gateway.ai.cloudflare.co...  google/gemini-2.0-flash-001          200            N/A            Yes                  No             N/A
claude       sk-or-v1...  N/A         https://gateway.ai.cloudflare.co...  anthropic/claude-3.7-sonnet:beta     60             N/A            Yes                  todo           N/A
o3-mini      sk-or-v1...  N/A         https://gateway.ai.cloudflare.co...  openai/o3-mini                       60             N/A            Yes                  No             low
ds-chat      sk-or-v1...  N/A         https://gateway.ai.cloudflare.co...  deepseek/deepseek-chat               100            N/A            Yes                  No             N/A
ds-r1        sk-or-v1...  N/A         https://gateway.ai.cloudflare.co...  deepseek/deepseek-r1                 100            N/A            Yes                  tavily         N/A
groq-r1-70b  sk-or-v1...  N/A         https://gateway.ai.cloudflare.co...  deepseek/deepseek-r1-distill-lla...  1000           N/A            Yes                  No             N/A
dify-bot     app-2drF...  dify        https://api.dify.ai/v1                                                    60             N/A            No                   No             N/A

Reasoning model & MCP client

asciicast

Multiple MCP servers

➜  ~ y-cli mcp list
Name    Command    Arguments                                Environment
------  ---------  ---------------------------------------  ---------------------------------------
todo    uvx        mcp-todo
tavily  npx        -y tavily-mcp                            TAVILY_API_KEY=tvly-api-key...
pplx    node       /Users/mac/src/researcher-mcp/build/...  PERPLEXITY_API_KEY=pplx-api-key...

⚡ Quick Start

Prerequisites

Required:

1. uv
2. OpenRouter API key

Optional:

1. Cloudflare account (for cloud storage)

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

3. Cloudflare setup (optional)

   • Create a Cloudflare account if you don't have one
   • Set up KV namespace and R2 bucket
   • Check docs/CLOUDFLARE_STORAGE.md for detailed instructions

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
• mcp Manage MCP server configurations:
  • add Add a new MCP server configuration
  • list List all configured MCP servers
  • delete Delete an MCP server configuration
• daemon Manage the MCP daemon:
  • start Start the MCP daemon
  • stop Stop the MCP daemon
  • status Check daemon status
  • log View daemon logs
  • restart Restart the daemon
• prompt Manage prompt configurations:
  • add Add a new prompt configuration
  • list List all configured prompts
  • delete Delete a prompt configuration

Options

• --help Show help message and exit