Codebase Uploader

An elegant, zero-dependency userscript that packages directories and codebases for AI chats. Features smart markdown chunking, customizable ignore patterns, binary file uploads, and a premium Liquid Glass interface.

Stan na 08-08-2026. Zobacz najnowsza wersja.

Aby zainstalować ten skrypt, wymagana jest instalacje jednego z następujących rozszerzeń: Tampermonkey, Greasemonkey lub Violentmonkey.

You will need to install an extension such as Tampermonkey or Violentmonkey to install this script.

Aby zainstalować ten skrypt, wymagana jest instalacje jednego z następujących rozszerzeń: Tampermonkey, Violentmonkey.

Aby zainstalować ten skrypt, wymagana będzie instalacja rozszerzenia Tampermonkey lub Userscripts.

You will need to install an extension such as Tampermonkey to install this script.

Aby zainstalować ten skrypt, musisz zainstalować rozszerzenie menedżera skryptów użytkownika.

(Mam już menedżera skryptów użytkownika, pozwól mi to zainstalować!)

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

Będziesz musiał zainstalować rozszerzenie menedżera stylów użytkownika, aby zainstalować ten styl.

Będziesz musiał zainstalować rozszerzenie menedżera stylów użytkownika, aby zainstalować ten styl.

Musisz zainstalować rozszerzenie menedżera stylów użytkownika, aby zainstalować ten styl.

(Mam już menedżera stylów użytkownika, pozwól mi to zainstalować!)

⚡ Codebase Uploader

Version License Tests

Zero-dependency Tampermonkey userscript that packages directories and codebases into structured markdown chunks and raw binary attachments for AI chats. Designed with an Apple WWDC25 Ethereal Glass interface, double-bezel squircle container architecture, dynamic memory-safe file filtering, and full WCAG AA accessibility.


⚡ Supported Platforms

Optimized and tested for major AI web interfaces:

  • ChatGPT (chatgpt.com)
  • Claude (claude.ai)
  • Gemini & Google AI Studio (gemini.google.com, aistudio.google.com)
  • DeepSeek (deepseek.com)
  • Perplexity (perplexity.ai)
  • Meta AI (meta.ai)
  • Chatbot Arena (arena.lmsys.org, arena.ai)
  • Grok (grok.com)
  • Mistral Chat (chat.mistral.ai)
  • Microsoft Copilot (copilot.microsoft.com)
  • Hugging Chat (huggingface.co/chat)
  • Qwen (qwen.ai)
  • Kimi (kimi.com)
  • Z.ai (z.ai)
  • OpenRouter (openrouter.ai)
  • Groq (groq.com)
  • Xiaomi MiMo AI Studio (aistudio.xiaomimimo.com)
  • MiniMax Agent (agent.minimax.io)

✨ Features

  • Apple Ethereal Glass UI: Translucent OLED dark surfaces (border-radius: 24px outer panel, 16px inner core), specular highlight borders, tactile spring micro-interactions (cubic-bezier(0.32, 0.72, 0, 1)), and button-in-button trailing icon indicators.
  • Trusted Types & Zero Runtime Dependencies: Pure imperative DOM construction (createElementNS and native helpers) with zero innerHTML usage to run safely under Google Trusted Types policies (gemini.google.com, aistudio.google.com).
  • Dynamic Filtering & Ingestion: Retains all ingested files in memory while dynamically applying ignore lists, hidden file rules, and binary settings during render/upload. Changing settings instantly updates the file tree without re-dropping folders.
  • Unicode-Safe Markdown Chunking: Auto-splits large codebases into structured markdown chunks (codebase_part_N.md), prepends a master codebase_manifest.md with custom prompt instructions, and prevents UTF-16 surrogate pair splitting on multibyte/emoji codebases.
  • Copy Parts Side Panel: Interactive slide-in panel displaying individual copy buttons per chunk for quick sequential pasting when direct file injection is blocked.
  • Accessible & Focus Trapped: Full WCAG AA color contrast (> 7:1 ratio), :focus-visible ring indicators on all interactive elements, and a Shadow DOM keyboard focus trap with focus restoration.
  • Tag Chip Editors: Interactive tag-based managers for ignored folders and file extensions.
  • O(N) Search & Local Checkbox Walking: Fast O(N) search query pre-computation and DOM-walking checkbox state updates without full tree teardowns.

🚀 Installation

  1. Install a userscript manager such as Tampermonkey or Violentmonkey.
  2. Install or update the compiled userscript from dist/codebase-uploader.user.js.

⌨️ Shortcuts & Usage

  • Toggle Panel: Alt+Shift+U (or ⌥⇧U on macOS). Hotkey letter can be customized in Settings.
  • User Script Menu: Trigger via Tampermonkey extension menu (📂 Toggle Codebase Uploader).

🛠️ Development

Requires Node.js v22+.

npm install     # Install dependencies
npm run test    # Run Vitest unit tests (19 tests)
npm run tsc     # Typecheck codebase
npm run build   # Build distribution bundle (dist/codebase-uploader.user.js)

📄 License

MIT License