@quark.clip/quark 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adarsh Agrahari
+
+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.

package/README.md

@@ -0,0 +1,122 @@
+# 🌌 Quark
+
+**The AI-Native, Cross-Platform Clipboard Micro-Daemon.**
+
+© 2026 Adarsh Agrahari. All Rights Reserved.
+
+Quark is a headless, zero-configuration background service that orbits your operating system's clipboard. It silently fixes your copy-paste nightmares, syncs your clipboard across devices seamlessly, and exposes your clipboard directly to local AI models via the Model Context Protocol (MCP).
+
+---
+
+## 🛑 The Problem
+
+The operating system clipboard is fundamentally broken and stuck in the past:
+- **Dumb Text:** You copy text from a PDF, and the line breaks shatter.
+- **Privacy Leaks:** You copy a link, and tracking tags (`?utm_source=...`) follow you.
+- **Lost Formatting:** You copy a table or Markdown, and the formatting vanishes when pasted into an email.
+- **Isolation:** You switch to your laptop, and your clipboard is empty.
+- **Blind AI:** Your local AI agents (Claude, Cursor) have no native access to what you just copied.
+
+## 💡 The Solution
+
+**Enter Quark.** A silent, zero-configuration daemon that lives in your background. It requires no interface. It simply fixes what is broken.
+- **Heals** broken PDF text automatically.
+- **Strips** tracking parameters from URLs.
+- **Transforms** raw Excel data, Markdown, and LaTeX into clean, rich HTML.
+- **Syncs** across your Mac, Windows, and Linux machines instantly via P2P.
+- **Exposes** your clipboard to local AI models via MCP.
+
+---
+
+## 🚀 Quick Start
+
+No `.exe` files. No `.dmg` files. Just pure, cross-platform JavaScript.
+
+```bash
+# Run instantly without installing (Temporary Session)
+npx quark-daemon start
+
+# OR install globally as a background OS service
+npm install -g quark-daemon
+quark install
+```
+
+## 🏗️ Architecture
+
+Quark is built entirely in Node.js to ensure 100% cross-platform compatibility without the need for native C++ compilation.
+
+```mermaid
+graph TD
+    subgraph OS [Operating System]
+        Clip[OS Clipboard]
+    end
+
+    subgraph Quark [Quark Daemon]
+        Poll[Polling Engine]
+        Trans[Smart Transformers]
+        P2P[P2P Mesh Network]
+        API[Local HTTP API]
+    end
+
+    subgraph Network [Local Wi-Fi]
+        mDNS[mDNS Discovery]
+        WS[WebSocket Sync]
+    end
+
+    subgraph AI [AI Agents]
+        MCP[MCP Stdio Server]
+        Claude[Claude Desktop / Cursor]
+    end
+
+    Clip <-->|Read/Write| Poll
+    Poll -->|Raw Text/HTML| Trans
+    Trans -->|Cleaned/Formatted| Poll
+    Poll <-->|Broadcast/Receive| P2P
+    P2P <--> mDNS
+    P2P <--> WS
+    API <--> Clip
+    MCP <-->|HTTP GET/POST| API
+    Claude <-->|Stdio| MCP
+```
+
+### Technical Deep Dive
+- **Clipboard Engine:** Uses native OS commands (`pbcopy`/`pbpaste` for macOS, `xclip` for Linux, `powershell` and `System.Windows.Forms` for Windows) to read and write both `text/plain` and `text/html` streams simultaneously.
+- **Zero-Config Mesh Network:** Uses mDNS (Bonjour/ZeroConf) to broadcast its presence (`quark-clip`). When peers discover each other, they establish direct WebSocket connections. No central server is used.
+- **Transformation Pipeline:** A synchronous/asynchronous pipeline that detects content types (Markdown, LaTeX, URLs, TSV) and applies regex heuristics, `marked` parsing, and smart typographic quoting based on language character frequency.
+
+---
+
+## 🤖 Model Context Protocol (MCP)
+
+Quark acts as a bridge between your OS clipboard and local AI models using the [Model Context Protocol](https://modelcontextprotocol.io/).
+
+When you run `quark mcp`, it starts a standard MCP server over `stdio`. This server communicates with the background Quark daemon via a local HTTP API (port `14314`).
+
+### Exposed Tools
+1. \`get_clipboard\`: Reads the user's current operating system clipboard.
+2. \`set_clipboard\`: Writes text directly to the user's operating system clipboard.
+
+### Claude Desktop Integration
+To give Claude Desktop access to your clipboard, add Quark to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "quark": {
+      "command": "npx",
+      "args": ["quark-daemon", "mcp"]
+    }
+  }
+}
+```
+*Note: Ensure the Quark daemon is running in the background (`quark start` or `quark install`) for the MCP server to function.*
+
+---
+
+## 🤝 Contributing
+
+Please read `CONTRIBUTING.md` for details on our code of conduct, and the process for submitting pull requests to us.
+
+## 📄 License
+
+This project is licensed under the MIT License - see the `LICENSE` file for details.

package/cli/bin/quark.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const { installService, uninstallService } = require('../src/installer');
+
+const command = process.argv[2] || 'help';
+const daemonPath = path.join(__dirname, '../src/daemon.js');
+const mcpPath = path.join(__dirname, '../src/mcp.js');
+const pidFile = path.join(__dirname, '../quark.pid');
+const logFile = path.join(__dirname, '../quark.log');
+
+switch (command) {
+  case 'start':
+    console.log(`
+      o-------o
+      | \\   / |
+      |   o   |
+      | /   \\ |
+      o-------o
+    `);
+    console.log('🚀 Starting Quark Daemon (Temporary Session)...');
+    if (fs.existsSync(pidFile)) {
+      console.log('⚠️ Quark is already running. Run `quark stop` first.');
+      process.exit(1);
+    }
+    const out = fs.openSync(logFile, 'a');
+    const err = fs.openSync(logFile, 'a');
+    const child = spawn('node', [daemonPath], {
+      detached: true,
+      stdio: ['ignore', out, err]
+    });
+    fs.writeFileSync(pidFile, child.pid.toString());
+    child.unref();
+    console.log('✨ Quark is now orbiting your clipboard in the background.');
+    console.log('💡 Tip: Run `quark install` to make it start automatically on boot.');
+    break;
+
+  case 'stop':
+    if (fs.existsSync(pidFile)) {
+      const pid = fs.readFileSync(pidFile, 'utf8');
+      try {
+        process.kill(parseInt(pid, 10));
+        console.log('🛑 Quark Daemon stopped.');
+      } catch (e) {
+        console.log('⚠️ Quark process not found. Cleaning up pid file.');
+      }
+      fs.unlinkSync(pidFile);
+    } else {
+      console.log('Quark is not running via manual start.');
+    }
+    break;
+
+  case 'install':
+    installService();
+    break;
+
+  case 'uninstall':
+    uninstallService();
+    break;
+
+  case 'status':
+    const isRunning = fs.existsSync(pidFile);
+    console.log(`\n🌌 Quark Status`);
+    console.log(`----------------`);
+    console.log(`Manual Session: ${isRunning ? '🟢 Running' : '🔴 Stopped'}`);
+    
+    // Check OS Service Status
+    const os = require('os');
+    const platform = os.platform();
+    let serviceRunning = false;
+    try {
+      if (platform === 'darwin') {
+        const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', 'com.quark.daemon.plist');
+        if (fs.existsSync(plistPath)) {
+          const out = require('child_process').execSync('launchctl list | grep com.quark.daemon', { encoding: 'utf8' });
+          serviceRunning = out.includes('com.quark.daemon');
+        }
+      } else if (platform === 'linux') {
+        const servicePath = path.join(os.homedir(), '.config', 'systemd', 'user', 'quark.service');
+        if (fs.existsSync(servicePath)) {
+          const out = require('child_process').execSync('systemctl --user is-active quark.service', { encoding: 'utf8' });
+          serviceRunning = out.trim() === 'active';
+        }
+      } else if (platform === 'win32') {
+        const vbsPath = path.join(process.env.APPDATA, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup', 'quark.vbs');
+        if (fs.existsSync(vbsPath)) {
+          const out = require('child_process').execSync('wmic process where "CommandLine like \'%daemon.js%\'" get ProcessId', { encoding: 'utf8' });
+          serviceRunning = out.includes('ProcessId') && out.trim().split('\n').length > 1;
+        }
+      }
+    } catch (e) {
+      // Ignore errors from execSync if service is not running
+    }
+    
+    console.log(`OS Service:     ${serviceRunning ? '🟢 Installed & Running' : '🔴 Not Installed / Stopped'}`);
+    console.log(`\nLog file: ${logFile}`);
+    if (!serviceRunning) {
+      console.log(`\n💡 Tip: Run 'quark install' to configure auto-start on boot.`);
+    }
+    break;
+
+  case 'mcp':
+    // Starts the MCP Stdio server (used by LLMs like Claude Desktop)
+    require(mcpPath);
+    break;
+
+  default:
+    console.log(`
+🌌 Quark CLI
+
+Usage:
+  quark start      Start the daemon in the background (current session)
+  quark stop       Stop the manually started daemon
+  quark install    Install Quark as a native OS background service (Auto-start on boot)
+  quark uninstall  Remove the native OS background service
+  quark status     Check daemon status
+  quark mcp        Start the MCP Server (used by LLMs via stdio)
+    `);
+}