Upload 5 files

.gitattributes

@@ -33,3 +33,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+bg.png filter=lfs diff=lfs merge=lfs -text
+scr.png filter=lfs diff=lfs merge=lfs -text

README.md

@@ -1,10 +1,221 @@
+# ☁️ pockit CLI
+
+<p align="center">
+  <img src="scr.png" width="650" alt="pockit CLI Screenshot" />
+</p>
+
+## 🚀 Welcome to pockit
+
+Welcome to **pockit CLI**, a modern command-line tool built specifically for developers who want fast, direct access to their cloud files — without using a website.
+
+While the web platform is available at **[https://pockit-cloud.github.io/home](https://pockit-cloud.github.io/home)**, pockit CLI is designed for users who prefer working entirely in the terminal. It provides the same core file management capabilities in a faster, scriptable, and development-friendly environment.
+
+pockit lets you manage your storage directly from the command line. Upload, download, organize, delete, and synchronize files using simple commands, all inside a clean and interactive CLI experience.
+
+This tool is designed for developers, power users, and anyone who wants efficient cloud access without opening a browser.
+
+---
+
+## 🎯 Purpose of pockit
+
+pockit exists to:
+
+* Provide direct cloud file access from the terminal
+* Offer an alternative to using the web interface
+* Speed up developer workflows
+* Enable automation and scripting
+* Deliver a clean, interactive CLI experience
+* Support real-time folder synchronization
+
+It is built to integrate naturally into development environments, CI workflows, and everyday terminal usage.
+
+---
+
+## ✨ Key Features
+
+pockit combines powerful functionality with a polished interface.
+
+### 🔐 Secure Session Handling
+
+* Interactive login system
+* Local session caching for convenience
+* Automatic reuse of saved sessions
+* Secure storage of credentials
+* Manual logout support
+
+### 📂 Full File Management
+
+* List all files
+* Upload local files
+* Download files interactively
+* Delete files safely with confirmation
+* Change account password
+
+### ✨ Magic Sync Mode
+
+* Continuous two-way synchronization
+* Detects new, modified, and removed files
+* Keeps a local folder and cloud storage identical
+* Runs until manually stopped
+* Cross-platform support
+
+### 🎨 Modern Terminal Experience
+
+* Styled output using Rich
+* Interactive prompts
+* Spinners and progress bars
+* Clean tables and panels
+* Color-coded status messages
+
+---
+
+## 🖥️ Commands
+
+### `pockit login`
+
+Start a secure session.
+
+### `pockit logout`
+
+Clear saved session data.
+
+### `pockit ls`
+
+List all files in your cloud storage.
+
+### `pockit upload`
+
+Upload a local file to the cloud.
+
+* Interactive file selection
+* Optional rename
+* Progress feedback
+
+### `pockit download`
+
+Download a selected cloud file.
+
+* Interactive selection
+* Choose save location
+* Validated before saving
+
+### `pockit delete`
+
+Remove a file from cloud storage.
+
+* Requires confirmation
+* Prevents accidental deletion
+
+### `pockit chpasswd`
+
+Change your account password securely.
+
+### `pockit magicsync`
+
+Enable continuous synchronization between a local folder and your cloud storage.
+
+* Automatic updates both ways
+* Detects changes using file hashing
+* Stop anytime with `Ctrl + C`
+
+---
+
+## 📁 Magic Sync Folder
+
+Magic Sync uses a dedicated folder depending on your operating system:
+
+* **macOS & Windows:** Desktop → `Pockit-magicSync`
+* **Linux:** Uses system desktop directory if available, otherwise creates a folder in your home directory.
+
+This ensures a consistent sync location across platforms.
+
 ---
-title: Cli Docs
-emoji: 📈
-colorFrom: pink
-colorTo: purple
-sdk: static
-pinned: false
+
+## 🔄 How Magic Sync Works
+
+Magic Sync continuously monitors both local and cloud files.
+
+It automatically:
+
+* Detects new files
+* Detects modified files
+* Detects deleted files
+* Applies updates in both directions
+* Keeps environments perfectly aligned
+
+This enables seamless development workflows and instant synchronization.
+
+---
+
+## 🏗️ Design Philosophy
+
+pockit is built with:
+
+* Developer-first thinking
+* Clean command structure
+* Cross-platform compatibility
+* Automation-friendly workflows
+* Interactive usability
+* Lightweight performance
+
+The goal is to make cloud file management fast, intuitive, and terminal-native.
+
+---
+
+## 🚀 Installation
+
+pockit is available on **PyPI** and can be installed directly with:
+
+```bash
+pip install pockit
+```
+
+After installation, run it using:
+
+```bash
+pockit <command>
+```
+
+Example workflow:
+
+```bash
+pockit login
+pockit upload
+pockit ls
+pockit download
+pockit magicsync
+```
+
+---
+
+## 🔒 Security Overview
+
+* Credentials are stored locally with restricted permissions
+* Authentication required for all file operations
+* Deletions require confirmation
+* Downloaded files are validated
+* Session management is user-controlled
+
+---
+
+## 🏁 Stopping Magic Sync
+
+While Magic Sync is running, press:
+
+```
+Ctrl + C
+```
+
+to stop it safely.
+
+---
+
+## ☁️ Conclusion
+
+pockit CLI is a developer-focused cloud storage tool designed to provide fast, direct file access from the terminal — without relying on a website.
+
+It streamlines workflows, supports real-time synchronization, and delivers a modern CLI experience built for productivity.
+
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+**Built for developers. Built for the terminal. ☁️**

index.html

@@ -1,19 +1,195 @@
-<!doctype html>
-<html>
-	<head>
-		<meta charset="utf-8" />
-		<meta name="viewport" content="width=device-width" />
-		<title>My static Space</title>
-		<link rel="stylesheet" href="style.css" />
-	</head>
-	<body>
-		<div class="card">
-			<h1>Welcome to your static Space!</h1>
-			<p>You can modify this app directly by editing <i>index.html</i> in the Files and versions tab.</p>
-			<p>
-				Also don't forget to check the
-				<a href="https://huggingface.co/docs/hub/spaces" target="_blank">Spaces documentation</a>.
-			</p>
-		</div>
-	</body>
-</html>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>Documentation</title>
+
+<link href="https://fonts.googleapis.com/css2?family=Poppins:wght@300;400;500;600&display=swap" rel="stylesheet">
+<script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
+
+<style>
+*{
+  margin:0;
+  padding:0;
+  box-sizing:border-box;
+  font-family:'Poppins',sans-serif;
+}
+
+body{
+  background:#000;
+  overflow:hidden; /* Prevent whole page scrolling */
+}
+
+.background{
+  position:fixed;
+  inset:0;
+  background-image:url('bg.png');
+  background-size:cover;
+  background-position:center;
+  z-index:-1;
+}
+
+section{
+  display:flex;
+  height:100vh;
+  width:100%;
+}
+
+.sidebar{
+  width:280px;
+  backdrop-filter:blur(18px);
+  background:rgba(0,0,0,.45);
+  border-right:1px solid rgba(255,255,255,.2);
+  padding:25px;
+  color:#fff;
+  overflow-y:auto;
+}
+
+.logo{
+  margin-bottom:30px;
+}
+
+.logo img{
+  height:45px;
+}
+
+.toc a{
+  display:block;
+  color:#fff;
+  text-decoration:none;
+  padding:8px 10px;
+  border-radius:8px;
+  margin:5px 0;
+  font-size:.95em;
+  opacity:.75;
+  transition:.2s;
+}
+
+.toc a:hover{
+  background:rgba(255,255,255,.12);
+  opacity:1;
+  transform:translateX(5px);
+}
+
+.toc a.active{
+  background:#fff;
+  color:#000;
+  opacity:1;
+}
+
+.content{
+  flex:1;
+  margin:30px;
+  padding:50px; /* Bigger content */
+  border-radius:20px;
+  backdrop-filter:blur(20px);
+  background:rgba(0,0,0,.4);
+  color:#fff;
+  overflow-y:auto; /* Only content scrolls */
+}
+
+.content h1,
+.content h2,
+.content h3{
+  margin:25px 0 15px;
+}
+
+.content p{
+  line-height:1.8em;
+  margin:12px 0;
+  font-size:1.05em;
+}
+
+.content code{
+  background:rgba(255,255,255,.1);
+  padding:4px 7px;
+  border-radius:6px;
+}
+
+.content pre{
+  background:rgba(255,255,255,.08);
+  padding:18px;
+  border-radius:12px;
+  overflow-x:auto;
+}
+
+/* Emoji-safe font stack */
+.content, .sidebar {
+  font-family:'Poppins','Apple Color Emoji','Segoe UI Emoji','Noto Color Emoji',sans-serif;
+}
+
+@media(max-width:900px){
+  section{flex-direction:column;}
+  .sidebar{width:100%; height:auto;}
+  .content{margin:15px; padding:30px;}
+}
+</style>
+</head>
+<body>
+
+<div class="background"></div>
+
+<section>
+
+  <div class="sidebar">
+    <div class="logo">
+      <img src="logo.png" alt="Logo">
+    </div>
+    <div class="toc" id="toc"></div>
+  </div>
+
+  <div class="content" id="content">Loading documentation...</div>
+
+</section>
+
+<script>
+function buildTOC(){
+  const content=document.getElementById('content');
+  const toc=document.getElementById('toc');
+  const headings=content.querySelectorAll('h1,h2,h3');
+  toc.innerHTML='';
+
+  headings.forEach(h=>{
+    const link=document.createElement('a');
+    link.textContent=h.textContent;
+    link.href='#'+h.id;
+    link.style.marginLeft=(h.tagName==='H2'?12:h.tagName==='H3'?24:0)+'px';
+    toc.appendChild(link);
+  });
+
+  window.addEventListener('scroll',()=>{
+    let fromTop=content.scrollTop+100;
+    headings.forEach(h=>{
+      const link=toc.querySelector(`a[href="#${h.id}"]`);
+      if(h.offsetTop<=fromTop && h.offsetTop+h.offsetHeight>fromTop){
+        link?.classList.add('active');
+      }else{
+        link?.classList.remove('active');
+      }
+    });
+  });
+}
+
+async function loadREADME(){
+  try{
+    const res=await fetch('README.md');
+    const text=await res.text();
+    const html=marked.parse(text);
+    document.getElementById('content').innerHTML=html;
+
+    document.querySelectorAll('.content h1, .content h2, .content h3').forEach(h=>{
+      h.id=h.textContent.replace(/\s+/g,'-').toLowerCase();
+    });
+
+    buildTOC();
+  }catch(e){
+    document.getElementById('content').innerHTML='Failed to load README.md';
+  }
+}
+
+loadREADME();
+</script>
+
+</body>
+</html>