tmux: source an optional machine-local config

Open Beginner friendly
#64 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
88/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
shell
Domain
tooling

Research direction

Edit universal/tmux/home/.tmux.conf, placing the optional source-file -q line just before TPM initialization. Check that the local config can set plugin options before plugins read them, and that machines without ~/.tmux.local.conf see no change. The issue says the work laptop already has the intended line in its working tree, so compare against that version if available.

Written by the indexing model from the issue text.

Description

Machines sometimes need tmux settings that don't belong in the shared config. For example, the work laptop shows Claude Code session state in the status bar. Today the only way is to edit universal/tmux/home/.tmux.conf, which leaves uncommitted changes in the repo.

Wanted: .tmux.conf sources ~/.tmux.local.conf when it exists (source-file -q), and machines without the file see no difference. Place the line just before TPM is initialized, so the local file can still set theme and plugin options, such as @catppuccin_window_text, before the plugins read them. The work laptop already has this line in its working tree, so the upstream change should match it.

Dominant language
Lua
Stars
10
Forks
2
Avg merge
4h 53m
Merged PRs (30d)
30

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from Gelio/dotfiles

All issues in Gelio/dotfiles

Similar issues

More Lua issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.