Skip to content

v1.0.0 - Initial Stable Release

Choose a tag to compare

View all tags
@fathriAbanoub fathriAbanoub released this 01 Jul 23:06
v1.0.0
9f1a10e

✨ Features

  • GTK4 GUI with theme support (auto/light/dark/roselle) and persistent settings
  • CLI with advanced filtering, tree output, stats, and token estimation
  • Native right-click integration for Nautilus (GNOME) and Nemo (Cinnamon)
  • Smart filtering with .gitignore and .codegluerignore support
  • Binary file detection to skip non-text files
  • Markdown mode with syntax highlighting and auto-generated TOC
  • Plain text mode with clear BEGIN/END FILE markers
  • Priority patterns to control file ordering
  • AI prompt support (inline or from file)
  • Pipe to stdout (-o -) for LLM workflows
  • Auto-timestamping to prevent accidental overwrites
  • Desktop notifications on GUI completion

🖼️ See it in action

Smart GUI adapts to your selection:

When selecting files (directory-only options hidden):

GUI for files

When selecting a directory (Tree, TOC, .gitignore appear):

GUI for directory

Clean, pasteable output:

Shows stats, tree, TOC, and syntax-highlighted code:
Markdown output

📦 Installation

git clone https://github.com/fathriAbanoub/codegluer.git
cd codegluer
./install.sh

Note: Ensure ~/.local/bin is in your PATH.

🐧 Requirements

  • Python 3.8+
  • GTK4 bindings: sudo apt install python3-gi gir1.2-gtk-4.0
  • Optional: pip install tiktoken (accurate token estimation)

💻 Quick Start

# Glue files
codegluer file1.py file2.js -o output.md

# Recursive directory
codegluer src/ -r --format markdown

# Via GUI
codegluer-gui file1.py file2.js

🧪 Testing

pip install pytest
pytest

Ready to glue some code? 🚀

Assets 2
Loading