StickyMD banner
benthebear93 benthebear93

StickyMD

Documentation community

Description

Native sticky notes for GNOME X11, kept behind regular windows and stored as plain Markdown that Codex, Claude, and other coding agents can read.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

StickyMD

**Your LLM said something useful. Again.**

LLMs kept producing answers worth keeping, but saving every result as a Markdown file—and reopening an editor just to write a tiny summary—felt like homework. I wanted a place to skim the output, jot down only the useful bit, and get back to work.

StickyMD is that in-between place: small notes above the wallpaper and below your real windows. Each note autosaves as a plain Markdown file, and one click copies an exact reference you can hand back to any LLM or coding agent later.

LLM output → skim → keep the useful bit → StickyMD → reference it later

![StickyMD note with live headings, bold text, checkboxes, and hover controls](docs/images/stickymd-live-markdown.png)

Features

  • Multiple independently saved notes
  • Live inline styling for # headings, **bold**, and task checkboxes
  • Automatic saving and live reload after external file edits
  • Position and size restoration across logins
  • Move and resize from every edge or corner
  • Login autostart and a small GNOME panel control for creating or stopping notes
  • Recoverable deletion through the system Trash
  • A hover action that copies an exact, agent-neutral note reference

Requirements

StickyMD currently supports **GNOME Shell 42 on X11 only**. It has been tested on Ubuntu 22.04 with Python 3.10 and GTK 3.

Install the runtime packages on Ubuntu:

sudo apt install python3-gi gir1.2-gtk-3.0 libgtk-3-0

Wayland is not supported; StickyMD exits instead of falling back to an ordinary window with different stacking behavior.

Install

From the project directory:

./install.sh
~/.local/bin/stickymd

The installer writes only to the current user's home directory and does not use `sudo`. StickyMD then starts automatically on future logins and is available from the GNOME application menu.

On the first install, GNOME Shell 42 may require a logout and login. On X11 you can instead press `Alt+F2`, enter `r`, and press Enter.

To upd