Metadata-Version: 2.4
Name: claudforge
Version: 2.0.2
Summary: The high-performance CLI suite for Claude.ai Skills automation.
Project-URL: Homepage, https://claudforge.vercel.app
Project-URL: Repository, https://github.com/VinuBalagopalAP/claudforge
Project-URL: Issues, https://github.com/VinuBalagopalAP/claudforge/issues
Project-URL: Changelog, https://github.com/VinuBalagopalAP/claudforge/blob/main/CHANGELOG.md
Author-email: Vinu Balagopal A P <vinubalagopalap@gmail.com>
License: MIT License
        
        Copyright (c) 2026 Vinu Balagopal A P
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: ai,automation,browser-automation,claude,claude-ai,cli,mcp,playwright,skills
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
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: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Requires-Dist: pandas>=2.0.0
Requires-Dist: playwright>=1.41.0
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: streamlit>=1.30.0
Requires-Dist: typer[all]>=0.9.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Requires-Dist: twine>=5.0.0; extra == 'dev'
Description-Content-Type: text/markdown

ClaudForge

# ClaudForge ⚒️

### The high-performance CLI suite for Claude.ai Skills.
**Package. Validate. Deploy. Any scale. From your terminal.**

[![PyPI version](https://img.shields.io/pypi/v/claudforge)](https://pypi.org/project/claudforge/)
[![Python](https://img.shields.io/pypi/pyversions/claudforge)](https://pypi.org/project/claudforge/)
[![License](https://img.shields.io/pypi/l/claudforge)](LICENSE)
[![GitHub Stars](https://img.shields.io/github/stars/VinuBalagopalAP/claudforge?style=social)](https://github.com/VinuBalagopalAP/claudforge)

[**Quick Start**](#-quick-start) · [**Features**](#-features) · [**CLI Reference**](#-cli-reference) · [**Roadmap**](#-roadmap) · [**Website**](https://claudforge.vercel.app)

---

## The Problem

Every Claude.ai power user knows this pain:
1. Zip the skill folder manually
2. Open browser
3. Navigate to settings -> skills
4. Bypass Cloudflare
5. Upload
6. Repeat for every. single. skill.

**ClaudForge fixes this.** One command. Any scale. Whether you have 10 skills or 100+, it handles the logic, the auth, and the persistence so you don't have to.

---

## ✨ Features

| Feature | What it does |
|---------|-------------|
| 🕵️ **Stealth Automation** | Human-mimicry delays, randomized viewports, and physical click simulation. |
| 🛡️ **Self-Healing** | "Flicker-Proof" logic with auto-retries and smart success polling. |
| 🕒 **Rollback System** | **NEW**: Automatically backup skills on every upload; revert versions with one command. |
| 📦 **Predictive Batching** | `--limit` fulfillment that refills the queue from pending items automatically. |
| 📋 **Cloud Inventory** | Scans your Claude.ai account instantly to prevent redundant uploads. |
| 🛠️ **Auto-Sanitize** | Scans for reserved words (like `anthropic`) and fixes them automatically. |
| 📊 **Progress Dashboard** | `status`, `list`, and `dashboard` commands for real-time visibility. |
| 🖥️ **Live Monitor** | A dedicated Streamlit Web UI to track long-running batches with ETR gauges. |

---

## 🚀 Quick Start

**Requirements:** Python 3.8 - 3.14, Chrome browser

```bash
# 1. Setup
pip install claudforge
playwright install chromium

# 2. Launch the Live Monitor (optional)
claudforge dashboard ./my_skills

# 3. Deploy (Smart detection: folder or batch)
claudforge upload ./my_skills --limit 30 --profile "claude_user"
```

---

## 📖 CLI Reference
 
> [!TIP]
> **View the Interactive Guide**: For a detailed view of all flags and examples, visit the [**Official CLI Reference ↗**](https://claudforge.vercel.app#reference).
 

```
Usage: claudforge [command] [PATH] [options]

Commands:
  upload [PATH]     Deploy a skill or batch (auto-detects mode)
  rollback [PATH]   Revert a skill to a previous version from the archive
  dashboard [PATH]  Launch the real-time web monitor (Streamlit)
  status [PATH]     Fast summary of batch progress (Local History vs Total)
  list [PATH]       List every skill name recorded in the local history
  validate [PATH]   Check SKILL.md structure and reserved word compliance
  init              Scaffold a new Claude skill folder
  doctor            Check environment health (Chrome, Playwright, Python)

Options:
  --limit N           Strictly attempt N brand-new uploads
  --force, -f         Ignore local history; re-verify everything on Cloud
  --profile NAME      Use a persistent Chrome profile (keeps you logged in)
  --headless          Run in headless mode
```

---

## 🎯 Use Cases

**The "Mass Collection" Publisher**
> You have 800+ skills (like the Composio collection). You run `claudforge upload` in chunks of 50. The tool remembers what you've done, handles Cloudflare blocks, and skips duplicates automatically.

**Team Skill Library**
> Your team shares a private `/skills` directory. You add ClaudForge to your CI pipeline and every merged PR auto-deploys the updated skill library.

**Solo Power User**
> You maintain 15 custom skills. Instead of zipping and clicking for 20 minutes, you run `claudforge upload ./my-skills` and it finishes in seconds.

---

## 🏗 Architecture

```
claudforge/
├── uploader/
│   ├── single.py            # Flicker-proof upload logic & success polling
│   └── batch.py             # Predictive queueing & pre-batch sanitization
├── browser/
│   └── launcher.py          # Stealth Chrome launcher & Inventory scraping
├── utils/
│   ├── history.py           # Persistent .claudforge_history management
│   ├── archive.py           # Rollback snapshots & versioning logic
│   ├── yaml_parser.py       # SKILL.md parsing & Auto-Sanitization
│   └── zipper.py            # High-speed skill packaging
└── cli.py                   # Typer CLI (Dashboards & Commands)
```

---

## 🗺 Roadmap

| Status | Feature |
|--------|---------|
| ✅ Done | Single & Batch Smart Upload |
| ✅ Done | Self-Healing (Flicker-Resistance) |
| ✅ Done | Cloud Inventory Scraping |
| ✅ Done | Predictive `--limit` Logic |
| ✅ Done | `claudforge status` & `list` Dashboards |
| ✅ Done | Auto-Sanitization (Anthropic -> Assistant) |
| ✅ Done | Professional PyPI Packaging |
| ✅ Done | Real-time Web Monitor (Streamlit) |
| ✅ Done | `claudforge rollback` System |
| ✅ Done | **v2.0.2**: Industrial-grade CI stability & Python 3.14 support |

---

## ⚠️ Disclaimer

ClaudForge uses browser automation to interact with Claude.ai's UI. This is not an officially supported API. Use at your own discretion.

---

## 📄 License

[MIT](LICENSE) — Copyright (c) 2026 Vinu Balagopal AP

Made with ⚒️ by Vinu Balagopal A P (https://github.com/VinuBalagopalAP) · Website (https://claudforge.vercel.app)

