Metadata-Version: 2.4
Name: msapling-cli
Version: 0.1.8
Summary: MSapling CLI - Multi-chat AI development environment in your terminal
Author: MSapling Team
License-Expression: MIT
Project-URL: Homepage, https://msapling.com
Project-URL: Documentation, https://docs.msapling.com
Project-URL: Repository, https://github.com/Kandy00/CLI
Project-URL: Issues, https://github.com/Kandy00/CLI/issues
Keywords: ai,cli,chat,code,llm,multi-model
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Code Generators
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.25.0
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.9.0
Requires-Dist: pydantic>=2.0
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: pyreadline3>=3.4; sys_platform == "win32"
Provides-Extra: keyring
Requires-Dist: keyring>=24.0; extra == "keyring"
Provides-Extra: tui
Requires-Dist: textual>=0.40.0; extra == "tui"
Provides-Extra: pdf
Requires-Dist: pdfplumber>=0.10.0; extra == "pdf"
Provides-Extra: all
Requires-Dist: keyring>=24.0; extra == "all"
Requires-Dist: textual>=0.40.0; extra == "all"
Requires-Dist: pdfplumber>=0.10.0; extra == "all"
Provides-Extra: dev
Requires-Dist: build>=1.2.0; extra == "dev"
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: twine>=5.0.0; extra == "dev"
Dynamic: license-file

# MSapling CLI

Multi-chat AI development environment in your terminal. Chat with 200+ LLM models, run multi-model swarms, edit code with AI-generated diffs, and manage files from one command.

## Install

```bash
pip install msapling-cli
```

From GitHub while developing:

```bash
pip install git+https://github.com/Kandy00/CLI.git
```

## Quick Start

```bash
# 1. Create a free account at https://msapling.com
# 2. Login
msapling login

# 3. Chat with any model
msapling chat "explain async/await in Python"

# 4. Interactive session
msapling chat -i

# 5. Scan your project
msapling scan .
```

## Commands

### Free (no subscription needed)

| Command | What it does |
|---------|-------------|
| `msapling chat "prompt"` | Chat with free models (Gemini Flash, Haiku, Mini, Llama, Mistral) |
| `msapling chat -i` | Interactive chat session |
| `msapling scan .` | Detect project type, language, framework, and file stats |
| `msapling context .` | Build LLM-ready context from any project (local, no server) |
| `msapling git status` | Git with rich formatting |
| `msapling models` | List available models |
| `msapling projects` | List your projects |
| `msapling whoami` | Show account info and credits |
| `msapling diff old.py new.py` | Generate a unified diff between files |

### Pro ($20/mo)

| Command | What it does |
|---------|-------------|
| `msapling chat -m gpt-4o "prompt"` | Chat with any model (GPT-4, Claude, Gemini Pro, and more) |
| `msapling multi "prompt"` | Send to multiple models in parallel and compare side-by-side |
| `msapling swarm "task"` | Run a multi-model swarm with judge synthesis |
| `msapling edit "instruction" file.py` | AI-driven file editing with diff preview |
| `msapling benchmark "prompt"` | Compare response speed, tokens, and cost across models |

### MCP Server (for Claude Code / Cursor)

```bash
msapling mcp-serve
```

Add to Claude Code (`~/.claude/settings.json`):

```json
{
  "mcpServers": {
    "msapling": {
      "command": "msapling",
      "args": ["mcp-serve"],
      "env": { "MSAPLING_TOKEN": "your-token" }
    }
  }
}
```

## Diff Mode

CLI coding responses use diff mode by default. The AI returns unified diffs instead of full files, which keeps token usage down for coding workflows.

## Links

- Website: https://msapling.com
- Pricing: https://msapling.com/pricing
- Docs: https://docs.msapling.com
- Repository: https://github.com/Kandy00/CLI
