Metadata-Version: 2.4
Name: claudeshift-cli
Version: 0.1.1
Summary: Fast local-first profile switcher, MCP vault, and real-time quota radar for Claude Code, OpenAI Codex CLI, Gemini CLI, and Cursor.
Author: Mohamed Aboelmaged
License: MIT
Project-URL: Homepage, https://github.com/mohamed2003-mgd/claudeshift-cli
Project-URL: Repository, https://github.com/mohamed2003-mgd/claudeshift-cli
Project-URL: Issues, https://github.com/mohamed2003-mgd/claudeshift-cli/issues
Keywords: claude,claude-code,codex,gemini-cli,cursor,mcp,cli,profile-switcher,quota-monitor,ai-tools
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.12.0
Requires-Dist: rich>=13.7.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: ruff>=0.6.0; extra == "dev"
Requires-Dist: build>=1.2.0; extra == "dev"
Requires-Dist: twine>=5.1.0; extra == "dev"
Dynamic: license-file

﻿# claudeshift-cli

Local-first profile switcher, MCP vault, and 5-hour quota radar for AI CLIs.

**[Get claudeshift-cli Pro ($19 One-Time) on Gumroad →](https://mgm15.gumroad.com/l/claudeshift-cli)**

[![PyPI version](https://img.shields.io/pypi/v/claudeshift-cli)](https://pypi.org/project/claudeshift-cli/)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://github.com/mohamed2003-mgd/claudeshift-cli/blob/main/LICENSE)

![claudeshift-cli overview](https://raw.githubusercontent.com/mohamed2003-mgd/claudeshift-cli/main/assets/banner.png)

### Live Demo

![claudeshift-cli live demo](https://raw.githubusercontent.com/mohamed2003-mgd/claudeshift-cli/main/assets/demo.gif)

---

## Why claudeshift-cli?

Switching between work, personal, and client AI accounts usually means manually shuffling config files and breaking MCP setups—or hitting a 5-hour session lockout mid-refactor with zero warning.

**claudeshift-cli** solves both **100% locally** with zero cloud telemetry and zero network proxies.

## Supported Providers

* **Claude Code CLI** (profiles, MCP configs, local JSONL token & 5h quota telemetry)
* **Claude Desktop** (config/MCP switching, including Windows MS Store builds)
* **OpenAI Codex CLI** (profiles & local token/quota telemetry)
* **Gemini CLI** (profile switching)
* **Cursor** (profile switching)

## Installation

```bash
pipx install claudeshift-cli
```

Or via `pip`:

```bash
pip install claudeshift-cli
```

## Quick Start

```bash
# Inspect detected AI CLIs and local health
claudeshift doctor

# Save your current credentials & MCP config as a named profile
claudeshift save work -p claude

# List saved profiles
claudeshift list -p claude

# Switch atomically with automatic safety rollback
claudeshift use personal -p claude

# View local token usage & estimated cost
claudeshift usage

# Sync latest model pricing catalog
claudeshift pricing sync
```

## Free (MIT) vs Pro ($19 One-Time)

| Feature | Free (MIT) | Pro ($19 Lifetime) |
| :--- | :---: | :---: |
| Atomic profile & MCP switching | Up to 2 profiles / provider | **Unlimited profiles** |
| Local usage summaries (`usage`) & `doctor` | Yes | Yes |
| Auto-sync refreshed tokens before switching | Yes | Yes |
| Live 5-hour quota & burn-rate radar (`monitor`) | — | **Yes** |
| Rolling safety backups & restore | — | **Yes** |
| Profile & MCP config diffing | — | **Yes** |
| Billing & usage exports (CSV / JSON) | — | **Yes** |

Already purchased Pro? Activate once (includes 14-day offline grace window):

```bash
claudeshift license activate <YOUR-GUMROAD-KEY>
claudeshift license status
```

## Security & Hardening

* **100% Local-First:** Reads local files only; never sends prompts, tokens, or credentials to third-party servers.
* **Crash-Safe Atomic Swaps:** Stages files on the same filesystem with automatic rollback on Windows file locks.
* **Integrity & Path Guards:** SHA-256 verification, symlink-escape protection, path-traversal guards, CSV formula-injection neutralization, and Windows long-path (`\\?\`) support.
* **Verified:** 70 automated unit and red-team tests passing across Windows, Linux, and macOS.

## License

Core CLI is released under the [MIT License](LICENSE).
