Terminal Chat App for AI Models with MCP Integration

Overview

A tiny command-line interface chat application that brings AI conversations to your terminal. It supports multiple AI models, flexible storage options, and integrates with the Model Context Protocol (MCP) for enhanced functionality.

Features

• Flexible Storage Options:
• Local JSONL files for easy access and sync
• Cloudflare KV and R2 for cloud storage and backup
• Interactive Chat Interface:
• Tool execution visualization
• Support for multiple bot configurations (any base_url/api_key/model combination)
• Reasoning Model Support:
• Deepseek-r1 reasoning_content output print
• OpenAI o3-mini reasoning_effort configuration
• MCP Integration:
• Client support with multiple server configurations (stdio/SSE)
• Persistent daemon
• Custom prompt configurations
• Deep Research Mode:
• Simple "Deep Research" mode by prompt configuration
• Demo

Demo

asciicast

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

1. uv:
2. Follow the official installation guide
3. uv will automatically manage Python installation
4. OpenRouter API Key:
5. Visit OpenRouter Settings
6. Create a new API key
7. 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
• 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

About

A Tiny Terminal Chat App for AI Models with MCP Client Support

Resources

Readme

License

MIT license

Stars

64 stars

Watchers

2 watching

Forks

3 forks

Report repository

Releases

19 tags

Packages 0

Languages

• Python 97.8%
• JavaScript 2.2%