saarthi-cli 0.1.0

Your AI copilot in the terminal - a LangGraph-powered CLI chatbot with long-term memory

Saarthi CLI

AI copilot for the terminal. Saarthi is a LangGraph-powered CLI chatbot with persistent memory, real-time token streaming, MCP integration, and multi-provider support. It runs entirely inside the terminal with a custom TUI built using prompt-toolkit.

No browser. No Electron. No cloud dashboard.

Current release: 0.1.0

---

Features

• Short-term and long-term memory support
• Local SQLite-backed conversation persistence
• Named chat sessions with resume support
• Real-time token streaming
• Live tool-call visualisation
• MCP (Model Context Protocol) server support
• Interactive terminal UI built with prompt-toolkit
• Multi-provider LLM support
• Local-first architecture
• Built-in developer tools

---

Supported providers

• OpenAI
• Google Gemini
• Mistral AI

More providers and local model support are planned.

---

Built-in tools

Tool	Description
bash	Execute shell commands and Python snippets
calculator	Evaluate mathematical expressions
ddg_tool	DuckDuckGo web search
wiki_tool	Wikipedia lookup
arxiv_tool	arXiv paper search

---

Installation

Install using pip

pip install saarthi-cli

Run:

saarthi

---

Install using uv

uv tool install saarthi-cli

Run:

saarthi

---

Install from source

git clone https://github.com/snehangshu2002/saarthi-cli.git
cd saarthi-cli

uv sync
uv run python main.py

---

Linux/macOS install script

curl -fsSL https://raw.githubusercontent.com/snehangshu2002/saarthi-cli/main/install.sh | bash

---

First-time setup

On first launch, Saarthi will guide you through setup:

1. Choose a username
2. Select an LLM provider
3. Enter your API key

API key input is hidden automatically.

---

Local storage

All configuration and memory are stored locally.

Platform	Storage Path
Windows	%LOCALAPPDATA%\\saarthi\\
Linux / macOS	~/.local/share/saarthi/

This directory contains:

• settings.json
• mcp_config.json
• SQLite memory database

---

Commands

Command	Description
/help	Show available commands
/new	Start a new session
/resume	Resume an older session
/settings	View current configuration
/mcp	Show connected MCP servers
/exit	Quit Saarthi

---

MCP support

Saarthi supports MCP-compatible servers over STDIO transport.

Default MCP configuration:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/dir"
      ],
      "transport": "stdio"
    }
  }
}

You can connect custom MCP servers for:

• Filesystem access
• Browser automation
• Databases
• Coding agents
• External APIs
• Custom tools

---

Memory system

Saarthi currently supports:

• Short-term memory for active conversations
• Long-term memory stored locally in SQLite

Conversation history can also be summarised automatically to reduce context size while preserving important information.

---

Upcoming features

Planned additions include:

• Human-in-the-loop workflows
• Planning mode
• Auto-toggle / autonomous execution mode
• Skill system support
• Export conversations
• More provider integrations
• Local model support
• Plugin-style custom tools
• Better configuration management
• More CLI-agent style workflows

---

Project structure

src/chatbot_cli/
├── app.py
├── chatbot.py
├── ui.py
├── streaming.py
├── tool.py
├── memory.py
├── sessions.py
├── providers.py
├── mcp_client.py
├── settings.py
└── clipboard.py

---

License

MIT