CR: tmux-quantum Open-Source Refinement

Change Summary

Field Value

CR ID

CR-2026-04-05-tmux-quantum-oss-refinement

Date

2026-04-05

Priority

P1 - High

Type

Bug Fix / Open-Source Preparation

Status

Complete

Requestor

Evan Rosado

Implementor

Evan Rosado

Risk Level

Low (additive changes, no destructive modifications)

Systems Affected

~/.config/tmux (tmux-quantum)

Predecessor

CR-2026-04-03-tmux-quantum-creation

Related CR

CR-2026-04-03-tmux-config-evolution

Objective

Fix a Wayland clipboard bug preventing gopass show -c from working inside tmux, and prepare the repository for open-source release by adding missing standard files and extracting personal paths.

Background

After one day of production use (including a reboot), tmux-quantum was stable with one critical issue: gopass show -c reported "No clipboard available" inside tmux while working correctly in bare Kitty terminal. Investigation confirmed the root cause was missing environment variables in tmux’s update-environment directive.

Simultaneously, the repository lacked standard open-source files (LICENSE, CONTRIBUTING) and contained hardcoded personal paths that would confuse external users.

Files Modified

File Change

lib/core.conf

Added XDG_RUNTIME_DIR + DBUS_SESSION_BUS_ADDRESS to update-environment

lib/clipboard.conf

Added comment documenting Wayland environment dependency

lib/sessions.conf

Removed 6 personal path bindings, replaced with comment

docs/quickstart.adoc

Fixed F12→F10, binding count, install path

README.adoc

Updated install, added session templates + local overrides sections

.gitignore

Added .claude/settings.local.json

Files Created

File Purpose

LICENSE

MIT license (standard open-source requirement)

CONTRIBUTING.adoc

Contributor guidelines

local.conf.example

Template for personal path bindings

local.conf

Personal overrides (gitignored)

Changelog

Date Author Change

2026-04-05

Evan Rosado

Initial CR — clipboard bug fix + open-source preparation (10 files touched)