{"id":13579481,"url":"https://github.com/hozza/tmux-hints","last_synced_at":"2025-04-05T20:34:20.468Z","repository":{"id":170384001,"uuid":"197234009","full_name":"hozza/tmux-hints","owner":"hozza","description":"☕️ Automatically show a cheat sheet or notes for any command focused in tmux. e.i. Show vim, zsh, tmux notes/key-combos in a pane automatically while you're using them.","archived":false,"fork":false,"pushed_at":"2019-11-15T14:10:58.000Z","size":229,"stargazers_count":63,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-11-05T17:49:50.706Z","etag":null,"topics":["cheatsheet","tmux","vim"],"latest_commit_sha":null,"homepage":"https://benhoskins.dev/tmux-hints-sh-auto-cheatsheet-for-vim-zsh-tmux/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hozza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2019-07-16T16:57:26.000Z","updated_at":"2024-10-27T08:26:02.000Z","dependencies_parsed_at":"2024-01-16T21:01:31.386Z","dependency_job_id":"dc7c2b92-04e1-4412-822e-f9e35ec45c52","html_url":"https://github.com/hozza/tmux-hints","commit_stats":null,"previous_names":["hozza/tmux-hints"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hozza%2Ftmux-hints","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hozza%2Ftmux-hints/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hozza%2Ftmux-hints/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hozza%2Ftmux-hints/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hozza","download_url":"https://codeload.github.com/hozza/tmux-hints/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247399889,"owners_count":20932876,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cheatsheet","tmux","vim"],"created_at":"2024-08-01T15:01:39.816Z","updated_at":"2025-04-05T20:34:18.144Z","avatar_url":"https://github.com/hozza.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# tmux-hints\nAutomatically show a cheat sheet or notes for any command focused in tmux. e.i. Show vim, zsh, tmux notes/key-combos in a pane when using them.\n\nMore info the blog post: https://benhoskins.dev/tmux-hints-sh-auto-cheatsheet-for-vim-zsh-tmux/\n\n![tmux-hint.sh Screenshot](https://raw.githubusercontent.com/hozza/tmux-hints/master/tmux-hints-sh.png)\n\n## Install\n\nThis is a bash script, you only need bash as a dependency _(which you probably already have)_ and whatever programme you'd like to show the hint file with, default is `cat`.\n\n```bash\n$ git clone https://github.com/hozza/tmux-hints.git\n$ cd tmux-hints/\n$ chmod +x ./tmux-hints.sh\n$ ./tmux-hints.sh\n```\n## Usage\n\n1. Make some 'hint files' - notes, cheat-sheets or memos for to show when using various commands and save them in `~/hints/`.\n\n2. Run `./tmux-hints.sh` in a tmux pane of your choice.\n\n3. Profit.\n\nWhen you focus on another pane, running for example, `vim` .. The pane running `tmux-hints.sh` will automatically load your 'hint file' within 1 second, when you focus on something else, such as, `zsh` it'll show your zsh hint file without you having todo anything or pull-up a different notes file.\n\n**What's a hint file?** I hear you ask, it's a text file of notes you've written and saved in `~/hints/`.\n\ne.g. You could include key-combo/shortcut/custom-key-mappings of your new VIM/TMUX config, maybe also notes to remind you about some aspects of it's usage.\n\n**Markdown?** If you have some sort of markdown viewer installed, and have md files as your hints. You can use the following:\n\n`./tmux-hints.sh -o markdown -x md`\n\n`-o markdown` specifies the `markdown` viewer/**o**pener you have installed (it uses `cat` by default).\n\n`-x md` specify the hint file extension.\n\nTaken some other path? If you have your notes/hints stored somewhere else you can specify a path with:\n\n`./tmux-hints.sh -p ~/.dotfiles/hints/`\n\ne.g. you have your hint files stored like so `~/.dotfiles/hints/vim.txt` \n\n## Not working?\n\nBe gentle, this is my first attempt at bash scripting. \n\nUse the `-v` option to show what it's doing and hopefully where it's going wrong.\n\nIt uses tmux's built in hooks, specifically `pane-focus-in` and the tmux format expansion `#{pane_current_command}`. If you're running a bash script, tmux only returns 'bash' as the command not the script name. So you can't have hint files for specific scripts unfortunately _(just put script specific hints in your `~/hints/bash.txt` hint file and see them all at once)_\n\nThis does not come with the 'hint files' - as they are notes personal to you and your setup, and so you'll need to write some! e.g. If you have new vim plugins with custom maps that you can't quite remember just yet.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhozza%2Ftmux-hints","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhozza%2Ftmux-hints","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhozza%2Ftmux-hints/lists"}