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.

As of 2026-08-08. See the latest version.

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

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

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

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

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

You will need to install a user script manager extension to install this script.

(I already have a user script manager, let me install it!)

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.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

(I already have a user style manager, let me install it!)

May akda
quantavil
Mga Rating
0 0 0
Bersyon
1.3.0
Nilikha
2026-06-27
Na update
2026-08-08
Laki
76.6 KB
Lisensya
MIT
Nalalapat sa

⚡ 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