From 204aeda00c86ba7d3e975aa53ce1f1f14e4b17a4 Mon Sep 17 00:00:00 2001
From: Grzegorz Kucmierz <gkucmierz@gmail.com>
Date: Fri, 27 Feb 2026 06:14:43 +0000
Subject: [PATCH] feat: implement url cleaner tool, local storage persistence
 and extension integration

---
 .gitignore                                    |   2 +
 src/components/Sidebar.vue                    |   1 +
 src/components/tools/ClipboardSniffer.vue     | 377 +++-------------
 src/components/tools/UrlCleaner.vue           | 425 ++++++++++++++++++
 .../tools/common/ExtensionStatus.vue          | 190 ++++++++
 src/composables/useExtension.js               |  79 ++++
 src/composables/useLocalStorage.js            |  18 +
 src/router/index.js                           |   6 +
 8 files changed, 772 insertions(+), 326 deletions(-)
 create mode 100644 src/components/tools/UrlCleaner.vue
 create mode 100644 src/components/tools/common/ExtensionStatus.vue
 create mode 100644 src/composables/useExtension.js
 create mode 100644 src/composables/useLocalStorage.js

diff --git a/.gitignore b/.gitignore
index 96c79c5..d9daf14 100644
--- a/.gitignore
+++ b/.gitignore
@@ -24,3 +24,5 @@ dist-ssr
 *.sw?
 dev-dist
 extension-release.zip
+*.zip
+tools-app-extension-*.zip
diff --git a/src/components/Sidebar.vue b/src/components/Sidebar.vue
index 657079e..f61ef26 100644
--- a/src/components/Sidebar.vue
+++ b/src/components/Sidebar.vue
@@ -12,6 +12,7 @@ defineProps({
     <nav class="sidebar-nav">
       <router-link to="/passwords" class="nav-item" v-ripple>Passwords</router-link>
       <router-link to="/clipboard-sniffer" class="nav-item" v-ripple>Clipboard Sniffer</router-link>
+      <router-link to="/url-cleaner" class="nav-item" v-ripple>URL Cleaner</router-link>
     </nav>
   </aside>
 </template>
diff --git a/src/components/tools/ClipboardSniffer.vue b/src/components/tools/ClipboardSniffer.vue
index 932e2ac..3872041 100644
--- a/src/components/tools/ClipboardSniffer.vue
+++ b/src/components/tools/ClipboardSniffer.vue
@@ -1,91 +1,29 @@
 <script setup>
-import { ref, onUnmounted, nextTick, onMounted } from 'vue'
+import { ref, watch, nextTick } from 'vue'
 import { useFillHeight } from '../../composables/useFillHeight'
-import { Plug, Info, X } from 'lucide-vue-next'
+import { useExtension } from '../../composables/useExtension'
+import { useLocalStorage } from '../../composables/useLocalStorage'
+import ExtensionStatus from './common/ExtensionStatus.vue'
 
-const clipboardContent = ref('')
-const isListening = ref(false)
-const lastClipboardText = ref('')
+const clipboardContent = useLocalStorage('clipboard-sniffer-content', '')
 const textareaRef = ref(null)
-const isExtensionReady = ref(false)
-const showExtensionModal = ref(false)
-let intervalId = null
-let extensionCheckInterval = null
 
-const { height: textareaHeight } = useFillHeight(textareaRef, 40) // 40px margin bottom
+const {
+  isExtensionReady,
+  isListening,
+  lastClipboardText,
+  startListening,
+  stopListening
+} = useExtension()
 
-// Listen for extension messages
-const handleExtensionMessage = (event) => {
-  if (event.source !== window) return
+const { height: textareaHeight } = useFillHeight(textareaRef, 40)
 
-  if (event.data.type === 'TOOLS_APP_EXTENSION_READY' || event.data.type === 'TOOLS_APP_PONG') {
-    isExtensionReady.value = true
-    lastPongTime = Date.now()
-    // console.log('Extension is ready')
+// Watch for clipboard updates from extension
+watch(lastClipboardText, (newText) => {
+  if (newText) {
+    clipboardContent.value += (clipboardContent.value ? '\n' : '') + newText
+    scrollToBottom()
   }
-
-  if (event.data.type === 'TOOLS_APP_CLIPBOARD_UPDATE' && isListening.value) {
-    const text = event.data.content
-    if (text && text !== lastClipboardText.value) {
-      lastClipboardText.value = text
-      clipboardContent.value += (clipboardContent.value ? '\n' : '') + text
-      scrollToBottom()
-    }
-  }
-}
-
-const closeModalOnEsc = (e) => {
-  if (e.key === 'Escape' && showExtensionModal.value) {
-    showExtensionModal.value = false
-  }
-}
-
-// Watchdog for extension
-let lastPongTime = Date.now()
-const PING_INTERVAL = 200
-const TIMEOUT_THRESHOLD = 500
-
-const startExtensionWatchdog = () => {
-  extensionCheckInterval = setInterval(() => {
-    // 1. Send Ping
-    window.postMessage({ type: 'TOOLS_APP_PING' }, '*')
-
-    // 2. Check timeout
-    // If current time - lastPongTime > threshold, then disconnected
-    if (Date.now() - lastPongTime > TIMEOUT_THRESHOLD) {
-       isExtensionReady.value = false
-    }
-  }, PING_INTERVAL)
-}
-
-// Wrapper to intercept PONG and update heartbeat
-const messageListener = (event) => {
-  if (event.source !== window) return
-
-  if (event.data.type === 'TOOLS_APP_PONG' || event.data.type === 'TOOLS_APP_EXTENSION_READY') {
-    lastPongTime = Date.now()
-    isExtensionReady.value = true
-  }
-
-  handleExtensionMessage(event)
-}
-
-onMounted(() => {
-  window.addEventListener('message', messageListener)
-  window.addEventListener('keydown', closeModalOnEsc)
-
-  // Initial check
-  window.postMessage({ type: 'TOOLS_APP_INIT' }, '*')
-
-  // Start heartbeat
-  startExtensionWatchdog()
-})
-
-onUnmounted(() => {
-  stopListening()
-  if (extensionCheckInterval) clearInterval(extensionCheckInterval)
-  window.removeEventListener('message', messageListener)
-  window.removeEventListener('keydown', closeModalOnEsc)
 })
 
 const scrollToBottom = () => {
@@ -97,98 +35,23 @@ const scrollToBottom = () => {
   })
 }
 
-const startListening = async () => {
-  try {
-    isListening.value = true
-
-    // Try native API first (for web app usage without extension)
-    // Initial read
-    try {
-      const text = await navigator.clipboard.readText()
-      if (text) {
-          lastClipboardText.value = text
-          clipboardContent.value += (clipboardContent.value ? '\n' : '') + text
-          scrollToBottom()
-      }
-    } catch (e) {
-      console.log('Native clipboard read failed (expected if not focused), relying on extension if available')
-    }
-
-    // If extension is ready, ask it to start sniffing
-    if (isExtensionReady.value) {
-      window.postMessage({ type: 'TOOLS_APP_START_SNIFFING' }, '*')
-    }
-
-    // Fallback polling for web app (only works when focused usually)
-    intervalId = setInterval(async () => {
-      try {
-        const currentText = await navigator.clipboard.readText()
-        if (currentText && currentText !== lastClipboardText.value) {
-          lastClipboardText.value = currentText
-          clipboardContent.value += (clipboardContent.value ? '\n' : '') + currentText
-          scrollToBottom()
-        }
-      } catch (err) {
-        // Ignore errors in polling (e.g. lost focus)
-      }
-    }, 1000)
-  } catch (err) {
-    console.error('Permission denied or clipboard error:', err)
-    alert('Clipboard access denied. Please allow clipboard access to use this tool.')
-  }
-}
-
-const stopListening = () => {
-  isListening.value = false
-  if (intervalId) {
-    clearInterval(intervalId)
-    intervalId = null
-  }
-
-  if (isExtensionReady.value) {
-    window.postMessage({ type: 'TOOLS_APP_STOP_SNIFFING' }, '*')
+const copyToClipboard = () => {
+  if (clipboardContent.value) {
+    navigator.clipboard.writeText(clipboardContent.value)
   }
 }
 
 const clearText = () => {
   clipboardContent.value = ''
-  // Don't reset lastClipboardText so if they copy the same thing again it's detected?
-  // No, if they clear, they might want to see it again if they copy it again.
-  // But usually "change" means diff from clipboard.
-  // If I clear text, but clipboard still has "A", and I copy "A" again (refresh clipboard), readText still returns "A".
-  // So it won't be detected as a change.
-  // If user wants to capture "A" again, they need to copy something else then "A".
-  // That's standard behavior for "sniffer" (detect changes).
 }
-
-const copyToClipboard = async () => {
-  if (!clipboardContent.value) return
-  try {
-    await navigator.clipboard.writeText(clipboardContent.value)
-  } catch (err) {
-    console.error('Failed to copy to clipboard:', err)
-  }
-}
-
-onUnmounted(() => {
-  stopListening()
-})
 </script>
 
 <template>
-  <div class="tool-container" style="max-width: 100%;">
+  <div class="tool-container full-width">
     <div class="tool-panel">
       <div class="tool-header">
         <h2 class="tool-title">Clipboard Sniffer</h2>
-        <div
-          class="extension-status"
-          :class="{ 'connected': isExtensionReady }"
-          @click="showExtensionModal = true"
-          :title="isExtensionReady ? 'Extension connected' : 'Extension not detected - Click for info'"
-        >
-          <Plug v-if="isExtensionReady" size="20" />
-          <Info v-else size="20" />
-        </div>
+        <ExtensionStatus :isReady="isExtensionReady" />
       </div>
 
       <div class="controls">
@@ -196,6 +59,8 @@ onUnmounted(() => {
           v-if="!isListening"
           class="btn-neon"
           @click="startListening"
+          :disabled="!isExtensionReady"
+          :title="!isExtensionReady ? 'Extension required' : 'Start capturing clipboard'"
           v-ripple
         >
           Start Sniffing
@@ -228,44 +93,6 @@ onUnmounted(() => {
         </div>
       </div>
     </div>
-
-    <!-- Extension Info Modal -->
-    <div v-if="showExtensionModal" class="modal-overlay" @click.self="showExtensionModal = false">
-      <div class="modal-content glass-panel">
-        <button class="close-btn" @click="showExtensionModal = false">
-          <X size="24" />
-        </button>
-
-        <div v-if="!isExtensionReady">
-          <h3>Enhance Your Experience</h3>
-          <p>
-            Install our browser extension to enable <strong>background clipboard sniffing</strong>!
-          </p>
-          <p class="description">
-            Without the extension, this tool can only capture clipboard content when the tab is active.
-            With the extension, you can capture content even when you're working in other apps.
-          </p>
-          <div class="modal-actions">
-            <a href="#" class="btn-neon" @click.prevent>Extension Coming Soon</a>
-          </div>
-        </div>
-
-        <div v-else>
-          <h3>Extension Connected!</h3>
-          <p>
-            You have successfully enabled <strong>background clipboard sniffing</strong>.
-          </p>
-          <p class="description">
-            The extension is active and monitoring your clipboard in the background.
-            You can now switch to other apps and copy text - it will appear here automatically.
-          </p>
-          <div class="modal-actions">
-            <button class="btn-neon" @click="showExtensionModal = false">Got it!</button>
-          </div>
-        </div>
-
-      </div>
-    </div>
   </div>
 </template>
 
@@ -278,145 +105,43 @@ onUnmounted(() => {
   width: 100%;
 }
 
-.extension-status {
-  position: absolute;
-  right: 0;
-  top: 50%;
-  transform: translateY(-50%);
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  width: 32px;
-  height: 32px;
-  border-radius: 50%;
-  background: rgba(255, 255, 255, 0.1);
-  color: var(--text-secondary);
-  cursor: pointer;
-  transition: all 0.3s ease;
-}
-
-:global(:root[data-theme="light"]) .extension-status {
-  background: rgba(0, 0, 0, 0.05);
-  color: #666;
-}
-
-.extension-status:hover {
-  background: rgba(255, 255, 255, 0.2);
-  color: var(--text-color);
-}
-
-:global(:root[data-theme="light"]) .extension-status:hover {
-  background: rgba(0, 0, 0, 0.1);
-  color: #000;
-}
-
-.extension-status.connected {
-  color: #4ade80; /* Green for connected */
-  cursor: pointer; /* Allow clicking to see status */
-}
-
-/* :global(:root[data-theme="light"]) .extension-status.connected {
-  color: #16a34a;
-} */
-
-.extension-status.connected:hover {
-  background: rgba(74, 222, 128, 0.1);
-}
-
-/* :global(:root[data-theme="light"]) .extension-status.connected:hover {
-  background: rgba(22, 163, 74, 0.1);
-} */
-
-.modal-overlay {
-  position: fixed;
-  top: 0;
-  left: 0;
-  width: 100%;
-  height: 100%;
-  background: rgba(0, 0, 0, 0.7);
-  backdrop-filter: blur(4px);
-  display: flex;
-  justify-content: center;
-  align-items: center;
-  z-index: 1000;
-}
-
-.modal-content {
-  position: relative;
-  width: 90%;
-  max-width: 500px;
-  padding: 2rem;
-  border-radius: 16px;
-  background: var(--glass-bg);
-  border: 1px solid var(--glass-border);
-  box-shadow: 0 10px 40px rgba(0, 0, 0, 0.5);
-  text-align: center;
-}
-
-.close-btn {
-  position: absolute;
-  top: 1rem;
-  right: 1rem;
-  background: none;
-  border: none;
-  color: var(--text-secondary);
-  cursor: pointer;
-  padding: 0.5rem;
-  border-radius: 50%;
-  transition: all 0.2s;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-}
-
-.close-btn:hover {
-  background: rgba(255, 255, 255, 0.1);
-  color: var(--text-color);
-}
-
-.modal-content h3 {
-  margin-top: 0;
-  margin-bottom: 1rem;
-  font-size: 1.5rem;
-  color: var(--text-color);
-}
-
-.modal-content p {
-  margin-bottom: 1rem;
-  line-height: 1.6;
-  color: var(--text-color);
-}
-
-.description {
-  color: var(--text-secondary) !important;
-  font-size: 0.9rem;
-  margin-bottom: 2rem !important;
-}
-
-.modal-actions {
-  display: flex;
-  justify-content: center;
-}
-
 .controls {
   display: flex;
-  gap: 1rem;
   justify-content: center;
+  gap: 1rem;
   flex-wrap: wrap;
 }
 
-.btn-neon {
-  padding: 0.75rem 1.5rem;
-  min-width: 120px;
+.tool-container.full-width {
+  max-width: 100%;
+  height: 100%;
+  display: flex;
+  flex-direction: column;
 }
 
-.btn-neon.active {
-  background: rgba(255, 0, 0, 0.2);
-  border-color: rgba(255, 0, 0, 0.5);
-  box-shadow: 0 0 15px rgba(255, 0, 0, 0.3);
+.tool-panel {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  gap: 1.5rem;
 }
 
 .tool-textarea {
+  width: 100%;
   height: 100%;
+  padding: 1rem;
+  background-color: var(--toggle-bg);
+  border: 1px solid var(--toggle-border);
+  border-radius: 8px;
+  color: var(--text-color);
+  font-family: monospace;
+  resize: none;
+  font-size: 0.9rem;
+  line-height: 1.5;
+}
+
+.tool-textarea:focus {
+  outline: none;
+  border-color: var(--primary-accent);
 }
 </style>
diff --git a/src/components/tools/UrlCleaner.vue b/src/components/tools/UrlCleaner.vue
new file mode 100644
index 0000000..a8246b9
--- /dev/null
+++ b/src/components/tools/UrlCleaner.vue
@@ -0,0 +1,425 @@
+<script setup>
+import { ref, watch, onUnmounted } from 'vue'
+import { Copy, Trash2, ExternalLink, Power, Zap, X } from 'lucide-vue-next'
+import { useExtension } from '../../composables/useExtension'
+import { useLocalStorage } from '../../composables/useLocalStorage'
+import ExtensionStatus from './common/ExtensionStatus.vue'
+
+// Extension integration
+const { isExtensionReady, isListening, lastClipboardText, startListening, stopListening, writeClipboard } = useExtension()
+
+const inputUrl = ref('')
+// Use local storage for history persistence
+const cleanedHistory = useLocalStorage('url-cleaner-history', [])
+const isWatchEnabled = useLocalStorage('url-cleaner-watch-enabled', false)
+
+// Watch for clipboard changes from extension
+watch(lastClipboardText, (newText) => {
+  if (isWatchEnabled.value && newText) {
+    processUrl(newText, true)
+  }
+})
+
+// Sync watch state with extension listener
+watch(isWatchEnabled, (enabled) => {
+  if (enabled) {
+    startListening()
+  } else {
+    stopListening()
+  }
+}, { immediate: true })
+
+// Re-enable listening when extension becomes ready
+watch(isExtensionReady, (ready) => {
+  if (ready && isWatchEnabled.value) {
+    startListening()
+  }
+})
+
+// Toggle watch mode
+const toggleWatch = () => {
+  isWatchEnabled.value = !isWatchEnabled.value
+}
+
+// Manual clean
+const handleClean = () => {
+  if (inputUrl.value) {
+    processUrl(inputUrl.value, false)
+    inputUrl.value = ''
+  }
+}
+
+const processUrl = (text, autoClipboard = false) => {
+  try {
+    // Basic URL validation
+    if (!text.match(/^https?:\/\//i)) {
+      // Not a URL, ignore in watch mode
+      if (autoClipboard) return
+    }
+
+    const originalLength = text.length
+    let cleanedUrl = text
+
+    try {
+      const urlObj = new URL(text)
+      // Remove query params and hash
+      if (urlObj.search || urlObj.hash) {
+        urlObj.search = ''
+        urlObj.hash = ''
+        cleanedUrl = urlObj.toString()
+        // Remove trailing slash if it wasn't there before? usually keep it standard
+      }
+    } catch (e) {
+      // Invalid URL format
+      if (!autoClipboard) {
+        // Show error or just return original
+      }
+      return
+    }
+
+    // If no change, ignore in watch mode to avoid loops
+    if (cleanedUrl === text && autoClipboard) {
+      return
+    }
+
+    const newLength = cleanedUrl.length
+    const savedChars = originalLength - newLength
+    const savedPercent = originalLength > 0 ? Math.round((savedChars / originalLength) * 100) : 0
+
+    // Add to history
+    const entry = {
+      id: Date.now(),
+      original: text,
+      cleaned: cleanedUrl,
+      savedPercent,
+      timestamp: new Date().toLocaleTimeString()
+    }
+
+    cleanedHistory.value.unshift(entry)
+
+    // Limit history
+    if (cleanedHistory.value.length > 50) {
+      cleanedHistory.value.pop()
+    }
+
+    // Auto-copy back to clipboard if in watch mode
+    if (autoClipboard && savedChars > 0) {
+      writeClipboard(cleanedUrl)
+    }
+  } catch (e) {
+    console.error('Error processing URL:', e)
+  }
+}
+
+const copyToClipboard = (text) => {
+  navigator.clipboard.writeText(text)
+}
+
+const removeEntry = (id) => {
+  cleanedHistory.value = cleanedHistory.value.filter(item => item.id !== id)
+}
+
+const clearHistory = () => {
+  cleanedHistory.value = []
+}
+
+onUnmounted(() => {
+  if (isListening.value) {
+    stopListening()
+  }
+})
+</script>
+
+<template>
+  <div class="tool-container full-width">
+    <div class="tool-panel">
+      <div class="panel-header">
+        <h2 class="tool-title">URL Cleaner</h2>
+        <ExtensionStatus :isReady="isExtensionReady" />
+      </div>
+
+      <div class="input-section">
+        <div class="input-wrapper">
+          <input
+            v-model="inputUrl"
+            type="text"
+            placeholder="Paste URL here to clean..."
+            class="url-input"
+            @keyup.enter="handleClean"
+          >
+          <button class="btn-neon" @click="handleClean">
+            Clean
+          </button>
+        </div>
+
+        <div class="watch-toggle">
+          <button
+            class="btn-neon toggle-btn"
+            :class="{ 'active': isWatchEnabled && isExtensionReady }"
+            @click="toggleWatch"
+            :disabled="!isExtensionReady"
+            :title="!isExtensionReady ? 'Extension required for auto-watch' : 'Automatically clean URLs from clipboard'"
+          >
+            <Power size="18" />
+            <span>Watch Clipboard</span>
+            <span v-if="isWatchEnabled && isExtensionReady" class="status-dot"></span>
+          </button>
+        </div>
+      </div>
+
+      <div class="history-section" v-if="cleanedHistory.length > 0">
+        <div class="history-header">
+          <h3>Cleaned URLs</h3>
+          <button class="icon-btn" @click="clearHistory" title="Clear History">
+            <Trash2 size="18" />
+          </button>
+        </div>
+
+        <div class="history-list">
+          <div v-for="item in cleanedHistory" :key="item.id" class="history-item">
+            <div class="item-info">
+              <div class="cleaned-url">{{ item.cleaned }}</div>
+              <div class="meta-info">
+                <span class="timestamp">{{ item.timestamp }}</span>
+                <span class="savings" v-if="item.savedPercent > 0">
+                  <Zap size="12" /> -{{ item.savedPercent }}% junk removed
+                </span>
+                <span class="no-change" v-else>No junk found</span>
+              </div>
+            </div>
+            <div class="item-actions">
+              <button class="icon-btn" @click="copyToClipboard(item.cleaned)" title="Copy">
+                <Copy size="18" />
+              </button>
+              <a :href="item.cleaned" target="_blank" class="icon-btn" title="Open">
+                <ExternalLink size="18" />
+              </a>
+              <button class="icon-btn delete-btn" @click="removeEntry(item.id)" title="Remove">
+                <X size="18" />
+              </button>
+            </div>
+          </div>
+        </div>
+      </div>
+
+      <div class="empty-state" v-else>
+        <p>Paste a URL above or enable "Watch Clipboard" to automatically clean links.</p>
+      </div>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.tool-container.full-width {
+  max-width: 100%;
+  height: 100%;
+  display: flex;
+  flex-direction: column;
+}
+
+.tool-panel {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  gap: 1.5rem;
+  position: relative;
+}
+
+.panel-header {
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  position: relative;
+  width: 100%;
+}
+
+.input-section {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+  padding: 1.5rem;
+  background: var(--glass-bg);
+  border: 1px solid var(--glass-border);
+  border-radius: 12px;
+}
+
+.input-wrapper {
+  display: flex;
+  gap: 1rem;
+}
+
+.url-input {
+  flex: 1;
+  padding: 0.8rem 1rem;
+  border-radius: 8px;
+  border: 1px solid var(--toggle-border);
+  background: var(--toggle-bg);
+  color: var(--text-color);
+  font-size: 1rem;
+  outline: none;
+  transition: all 0.2s;
+}
+
+.url-input:focus {
+  border-color: var(--primary-accent);
+  box-shadow: 0 0 0 2px rgba(var(--primary-accent-rgb), 0.2);
+}
+
+.watch-toggle {
+  display: flex;
+  justify-content: flex-end;
+}
+
+.toggle-btn {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  position: relative;
+}
+
+.toggle-btn.active {
+  background: rgba(var(--primary-accent-rgb), 0.2);
+  border-color: var(--primary-accent);
+  color: var(--primary-accent);
+}
+
+.status-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background-color: #4ade80; /* Green */
+  box-shadow: 0 0 8px #4ade80;
+  margin-left: 0.2rem;
+  animation: pulse 2s infinite;
+}
+
+@keyframes pulse {
+  0% { opacity: 1; }
+  50% { opacity: 0.5; }
+  100% { opacity: 1; }
+}
+
+.history-section {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  background: var(--glass-bg);
+  border: 1px solid var(--glass-border);
+  border-radius: 12px;
+}
+
+.history-header {
+  padding: 1rem;
+  border-bottom: 1px solid var(--glass-border);
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+
+.history-header h3 {
+  margin: 0;
+  font-size: 1.1rem;
+  color: var(--text-strong);
+}
+
+.history-list {
+  flex: 1;
+  overflow-y: auto;
+  padding: 0.5rem;
+}
+
+.history-item {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 0.8rem;
+  border-bottom: 1px solid var(--glass-border);
+  transition: background 0.2s;
+}
+
+.history-item:last-child {
+  border-bottom: none;
+}
+
+.history-item:hover {
+  background: rgba(255, 255, 255, 0.05);
+}
+
+.item-info {
+  flex: 1;
+  overflow: hidden;
+  padding-right: 1rem;
+}
+
+.cleaned-url {
+  color: var(--primary-accent);
+  font-family: monospace;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  margin-bottom: 0.4rem;
+}
+
+.meta-info {
+  display: flex;
+  gap: 1rem;
+  font-size: 0.85rem;
+  color: var(--text-secondary);
+}
+
+.savings {
+  color: #4ade80;
+  display: flex;
+  align-items: center;
+  gap: 0.2rem;
+}
+
+:global(:root[data-theme="light"]) .savings {
+  color: #16a34a;
+  font-weight: 500;
+}
+
+.item-actions {
+  display: flex;
+  gap: 0.5rem;
+}
+
+.icon-btn {
+  background: none;
+  border: none;
+  color: var(--text-secondary);
+  cursor: pointer;
+  padding: 0.4rem;
+  border-radius: 4px;
+  transition: all 0.2s;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.icon-btn:hover {
+  color: var(--text-color);
+  background: rgba(255, 255, 255, 0.1);
+}
+
+.delete-btn:hover {
+  background: none;
+  color: #ef4444;
+}
+
+:global(:root[data-theme="light"]) .delete-btn:hover {
+  background: none;
+  color: #dc2626;
+}
+
+.empty-state {
+  flex: 1;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  color: var(--text-secondary);
+  text-align: center;
+  padding: 2rem;
+}
+</style>
diff --git a/src/components/tools/common/ExtensionStatus.vue b/src/components/tools/common/ExtensionStatus.vue
new file mode 100644
index 0000000..3a5e3ac
--- /dev/null
+++ b/src/components/tools/common/ExtensionStatus.vue
@@ -0,0 +1,190 @@
+<script setup>
+import { ref } from 'vue'
+import { Plug, Plus, X } from 'lucide-vue-next'
+
+const props = defineProps({
+  isReady: Boolean
+})
+
+const showModal = ref(false)
+</script>
+
+<template>
+  <div class="extension-status" :class="{ 'is-ready': isReady }" @click="showModal = true" :title="isReady ? 'Extension Connected' : 'Extension Not Connected'">
+    <Plug v-if="isReady" size="18" />
+    <Plus v-else size="18" />
+  </div>
+
+  <Teleport to="body">
+    <div v-if="showModal" class="modal-overlay" @click.self="showModal = false">
+      <div class="modal-content glass-panel">
+        <button class="close-btn" @click="showModal = false">
+          <X size="24" />
+        </button>
+
+        <div v-if="!isReady">
+          <h3>Enhance Your Experience</h3>
+          <p>
+            Install our browser extension to enable <strong>background clipboard features</strong>!
+          </p>
+          <p class="description">
+            Without the extension, this tool can only access clipboard when the tab is active.
+            With the extension, you can capture and process content even when you're working in other apps.
+          </p>
+          <div class="modal-actions">
+            <a href="#" class="btn-neon" @click.prevent>Extension Coming Soon</a>
+          </div>
+        </div>
+
+        <div v-else>
+          <h3>Extension Connected!</h3>
+          <p>
+            You have successfully enabled <strong>background clipboard integration</strong>.
+          </p>
+          <p class="description">
+            The extension is active and ready to process your clipboard in the background.
+          </p>
+          <div class="modal-actions">
+            <button class="btn-neon" @click="showModal = false">Got it!</button>
+          </div>
+        </div>
+      </div>
+    </div>
+  </Teleport>
+</template>
+
+<style scoped>
+.extension-status {
+  position: absolute;
+  right: 0;
+  top: 50%;
+  transform: translateY(-50%);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
+  border-radius: 50%;
+  background: rgba(255, 255, 255, 0.1);
+  color: var(--text-secondary);
+  cursor: pointer;
+  transition: all 0.3s ease;
+}
+
+:global(:root[data-theme="light"]) .extension-status {
+  background: rgba(0, 0, 0, 0.05);
+  color: var(--text-secondary);
+}
+
+.extension-status:hover {
+  background: rgba(255, 255, 255, 0.2);
+  color: var(--primary-accent);
+}
+
+:global(:root[data-theme="light"]) .extension-status:hover {
+  background: rgba(0, 0, 0, 0.1);
+}
+
+.modal-overlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0, 0, 0, 0.7);
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  z-index: 1000;
+  backdrop-filter: blur(5px);
+  padding: 1rem;
+}
+
+.modal-content {
+  background: var(--glass-bg);
+  backdrop-filter: blur(16px);
+  -webkit-backdrop-filter: blur(16px);
+  border: 1px solid var(--glass-border);
+  border-radius: 16px;
+  padding: 2.5rem; /* Większy padding */
+  max-width: 500px;
+  width: 90%;
+  position: relative;
+  box-shadow: var(--glass-shadow);
+  text-align: center;
+  color: var(--text-color); /* Wymuś kolor tekstu */
+}
+
+.close-btn {
+  position: absolute;
+  top: 1rem;
+  right: 1rem;
+  background: none;
+  border: none;
+  color: var(--text-secondary);
+  cursor: pointer;
+  padding: 0.5rem;
+  transition: color 0.2s;
+}
+
+.close-btn:hover {
+  color: var(--text-color);
+}
+
+h3 {
+  margin-top: 0;
+  margin-bottom: 1.5rem;
+  font-size: 1.8rem; /* Większy nagłówek */
+  background: var(--title-gradient);
+  -webkit-background-clip: text;
+  background-clip: text;
+  color: transparent;
+  font-weight: 700;
+}
+
+p {
+  font-size: 1.1rem;
+  line-height: 1.6;
+  margin-bottom: 1rem;
+  color: var(--text-color); /* Wymuś kolor */
+}
+
+.description {
+  color: var(--text-secondary);
+  margin-bottom: 2rem;
+  font-size: 1rem;
+}
+
+.modal-actions {
+  display: flex;
+  justify-content: center;
+  gap: 1rem;
+  margin-top: 2rem;
+}
+
+.modal-actions .btn-neon {
+  font-size: 1.1rem;
+  padding: 0.8rem 2.5rem;
+  min-width: 140px;
+}
+
+strong {
+  color: var(--primary-accent);
+  font-weight: 600;
+}
+
+.extension-status.is-ready {
+  color: #4ade80;
+  background: rgba(74, 222, 128, 0.1);
+}
+
+.extension-status.is-ready:hover {
+  background: rgba(74, 222, 128, 0.2);
+  color: #4ade80;
+}
+
+:global(:root[data-theme="light"]) .extension-status.is-ready {
+  background: rgba(74, 222, 128, 0.15);
+  color: #16a34a; /* Darker green for light mode */
+}
+</style>
diff --git a/src/composables/useExtension.js b/src/composables/useExtension.js
new file mode 100644
index 0000000..37dcd2a
--- /dev/null
+++ b/src/composables/useExtension.js
@@ -0,0 +1,79 @@
+import { ref, onMounted, onUnmounted } from 'vue'
+
+export function useExtension() {
+  const isExtensionReady = ref(false)
+  const isListening = ref(false)
+  const lastClipboardText = ref('')
+  let extensionCheckInterval = null
+  let lastPongTime = Date.now()
+
+  const PING_INTERVAL = 200
+  const TIMEOUT_THRESHOLD = 1000
+
+  const handleMessage = (event) => {
+    if (event.source !== window) return
+
+    if (event.data.type === 'TOOLS_APP_EXTENSION_READY' || event.data.type === 'TOOLS_APP_PONG') {
+      isExtensionReady.value = true
+      lastPongTime = Date.now()
+    }
+
+    if (event.data.type === 'TOOLS_APP_CLIPBOARD_UPDATE') {
+      const text = event.data.content
+      // Only update if listening
+      if (isListening.value && text) {
+        lastClipboardText.value = text
+      }
+    }
+  }
+
+  const startWatchdog = () => {
+    extensionCheckInterval = setInterval(() => {
+      window.postMessage({ type: 'TOOLS_APP_PING' }, '*')
+      if (Date.now() - lastPongTime > TIMEOUT_THRESHOLD) {
+         isExtensionReady.value = false
+      }
+    }, PING_INTERVAL)
+  }
+
+  const startListening = () => {
+    window.postMessage({ type: 'TOOLS_APP_START_SNIFFING' }, '*')
+    isListening.value = true
+  }
+
+  const stopListening = () => {
+    window.postMessage({ type: 'TOOLS_APP_STOP_SNIFFING' }, '*')
+    isListening.value = false
+  }
+
+  const writeClipboard = (text) => {
+    // Send to extension (background -> offscreen -> clipboard)
+    window.postMessage({ type: 'TOOLS_APP_CLIPBOARD_WRITE', content: text }, '*')
+    // Update local state to avoid echo loop if we are listening
+    lastClipboardText.value = text
+  }
+
+  onMounted(() => {
+    window.addEventListener('message', handleMessage)
+    // Initial check
+    window.postMessage({ type: 'TOOLS_APP_INIT' }, '*')
+    startWatchdog()
+  })
+
+  onUnmounted(() => {
+    if (isListening.value) {
+      stopListening()
+    }
+    if (extensionCheckInterval) clearInterval(extensionCheckInterval)
+    window.removeEventListener('message', handleMessage)
+  })
+
+  return {
+    isExtensionReady,
+    isListening,
+    lastClipboardText,
+    startListening,
+    stopListening,
+    writeClipboard
+  }
+}
diff --git a/src/composables/useLocalStorage.js b/src/composables/useLocalStorage.js
new file mode 100644
index 0000000..2e448a1
--- /dev/null
+++ b/src/composables/useLocalStorage.js
@@ -0,0 +1,18 @@
+import { ref, watch } from 'vue'
+
+export function useLocalStorage(key, defaultValue) {
+  // Initialize state from local storage or default value
+  const storedValue = localStorage.getItem(key)
+  const data = ref(storedValue ? JSON.parse(storedValue) : defaultValue)
+
+  // Watch for changes and update local storage
+  watch(data, (newValue) => {
+    if (newValue === null || newValue === undefined) {
+      localStorage.removeItem(key)
+    } else {
+      localStorage.setItem(key, JSON.stringify(newValue))
+    }
+  }, { deep: true })
+
+  return data
+}
diff --git a/src/router/index.js b/src/router/index.js
index fbbeeec..1d6383f 100644
--- a/src/router/index.js
+++ b/src/router/index.js
@@ -2,6 +2,7 @@ import { createRouter, createWebHistory } from 'vue-router'
 import Main from '../components/Main.vue'
 import Passwords from '../components/tools/Passwords.vue'
 import ClipboardSniffer from '../components/tools/ClipboardSniffer.vue'
+import UrlCleaner from '../components/tools/UrlCleaner.vue'
 import PrivacyPolicy from '../views/PrivacyPolicy.vue'
 
 const routes = [
@@ -20,6 +21,11 @@ const routes = [
     name: 'ClipboardSniffer',
     component: ClipboardSniffer
   },
+  {
+    path: '/url-cleaner',
+    name: 'UrlCleaner',
+    component: UrlCleaner
+  },
   {
     path: '/extension-privacy-policy',
     name: 'PrivacyPolicy',