y-cli 🚀

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

Check out y-gui for a web-based version of y-cli.

✨ Features

📝 Flexible storage options:
- Local JSONL files for easy access and sync
- Cloudflare D1 for cloud storage
💬 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
🧐 Simple "Deep Research" mode by prompt configuration
- Demo

Demo

demo

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          None            N/A            Yes                  No             N/A
claude       sk-or-v1...  N/A         https://gateway.ai.cloudflare.co...  anthropic/claude-3.7-sonnet:beta     None             N/A            Yes                  todo           N/A
o3-mini      sk-or-v1...  N/A         https://gateway.ai.cloudflare.co...  openai/o3-mini                       None             N/A            Yes                  No             low
ds-chat        sk-or-v1...  N/A         https://gateway.ai.cloudflare.co...  deepseek/deepseek-chat-v3-0324:free                 None            N/A            Yes                  tavily         N/A
dify-bot     app-2drF...  dify        https://api.dify.ai/v1                                                    None             N/A            No                   No             N/A

Multiple MCP servers

➜  ~ y-cli mcp list
Name            Type    Command/URL          Arguments/Token    Environment     Auto-Confirm
--------------  ------  -------------------  -----------------  --------------  --------------
brave-search    sse     https://router.m...                                     brave_web_s...
todo            stdio   uvx                  mcp-todo
exa-mcp-server  stdio   npx                  exa-mcp-server     EXA_API_KEY...

⚡ Quick Start

Prerequisites

Required:

uv
OpenRouter API key

Setup Instructions:

uv
- Follow the official installation guide
- uv will automatically manage Python installation
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
import Import chats from an external file (useful for storage migration)
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

📚 Documentation

Visit the deepwiki page for comprehensive project documentation and guides.

y-cli