{"id":13740440,"url":"https://github.com/b0o/tmux-autoreload","last_synced_at":"2025-08-10T06:12:14.392Z","repository":{"id":88329464,"uuid":"401229499","full_name":"b0o/tmux-autoreload","owner":"b0o","description":"🧐 Automatically reload your tmux config file on change","archived":false,"fork":false,"pushed_at":"2024-02-16T12:08:46.000Z","size":24,"stargazers_count":98,"open_issues_count":2,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-11T09:49:20.905Z","etag":null,"topics":["tmux","tmux-autoreload","tmux-plugin","tmux-plugins"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/b0o.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-08-30T05:44:03.000Z","updated_at":"2025-06-29T17:27:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"cdaa3919-f4c4-4de4-8e8d-a047c07841de","html_url":"https://github.com/b0o/tmux-autoreload","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/b0o/tmux-autoreload","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0o%2Ftmux-autoreload","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0o%2Ftmux-autoreload/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0o%2Ftmux-autoreload/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0o%2Ftmux-autoreload/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/b0o","download_url":"https://codeload.github.com/b0o/tmux-autoreload/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/b0o%2Ftmux-autoreload/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269683356,"owners_count":24458665,"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","status":"online","status_checked_at":"2025-08-10T02:00:08.965Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["tmux","tmux-autoreload","tmux-plugin","tmux-plugins"],"created_at":"2024-08-03T04:00:47.880Z","updated_at":"2025-08-10T06:12:14.364Z","avatar_url":"https://github.com/b0o.png","language":"Shell","funding_links":[],"categories":["Plugins"],"sub_categories":[],"readme":"# tmux-autoreload [![version](https://img.shields.io/github/v/tag/b0o/tmux-autoreload?style=flat\u0026color=yellow\u0026label=version\u0026sort=semver)](https://github.com/b0o/tmux-autoreload/releases) [![license: MIT](https://img.shields.io/github/license/b0o/tmux-autoreload?style=flat\u0026color=green)](https://mit-license.org)\n\ntmux-autoreload watches your tmux configuration file and automatically reloads\nit on change.\n\n## Install\n\n#### Dependencies\n\n- [entr](https://github.com/eradman/entr)\n\n## Installation\n\nTo install tmux-autoreload with TPM (https://github.com/tmux-plugins/tpm), add the\nfollowing line to the end of your tmux configuration file:\n\n```sh\nset-option -g @plugin 'b0o/tmux-autoreload'\n```\n\nThen, inside tmux, press `prefix + I` to fetch the plugin.\n\nIf you don't use a plugin manager, git clone tmux-autoreload to the location of your\nchoice and run it directly:\n\n```sh\nrun-shell \"/path/to/tmux-autoreload/tmux-autoreload.tmux\"\n```\n\n## Setup\n\nOnce installed, you should be good to go unless you use non-standard\nconfiguration file paths or want to customize how tmux-autoreload behaves.\n\n### Configuration file paths\n\nIf your tmux config file is at a non-standard location or if you have multiple,\nspecify them in `@tmux-autoreload-configs`, separated by commas:\n\n```sh\nset-option -g @tmux-autoreload-configs '/path/to/configs/a.conf,/path/to/configs/b.conf'\n```\n\n### Entrypoints\n\nNormally, tmux-autoreload will source whichever file changed. If you wish to\nsource a specific set of files when any configuration file changes, use\n`@tmux-autoreload-entrypoints`:\n\n```sh\nset-option -g @tmux-autoreload-entrypoints '/path/to/entrypoint.conf'\n```\n\nYou can specify multiple entrypoints separated by commas. All entrypoints\nwill be sourced when any watched file changes.\n\nSet `@tmux-autoreload-entrypoints` to 1 to use the standard tmux configuration\nfiles as entrypoints, usually `/etc/tmux.conf` and `~/.tmux.conf.` You can see\nthese files with:\n\n```sh\ntmux display-message -p \"#{config_files}\"\n```\n\n#### Entrypoint Notes\n\n- If entrypoints are configured, a changed file itself will not necessarily\n  be reloaded unless it's an entrypoint or is sourced by an entrypoint.\n\n- Entrypoints will not be watched unless they're a standard tmux\n  configuration file like `~/.tmux.conf` or are included in `@tmux-autoreload-configs.`\n\n### All Options\n\n```\n@tmux-autoreload-configs (Default: unset)\n  A comma-delimited list of paths to configuration files which should be\n  watched in addition to the base tmux configuration files.\n\n@tmux-autoreload-entrypoints (Default: unset)\n  A comma-delimited list of paths to configuration files which should be\n  reloaded when any watched configuration file changes. If unset, the changed\n  file itself will be reloaded.\n\n  If set, only the entrypoints will be reloaded, not necessarily the changed\n  file.\n\n  If set to 1, the base tmux configuration files are used as the entrypoints\n  (you can see the base configuration files with the command tmux\n  display-message -p \"#{config_files}\").\n\n@tmux-autoreload-quiet 0|1 (Default: 0)\n  If set to 1, tmux-autoreload will not display status messages.\n```\n\n## Advanced Usage\n\n\u003c!-- USAGE --\u003e\n\n```\n\nUsage: tmux-autoreload.tmux [-f] [OPT...]\n  Automatically reloads your tmux configuration files on change.\n\nOptions\n  -h      Display usage information.\n  -v      Display tmux-autoreload version and copyright information.\n  -f      Run in foreground (do not fork).\n  -k      Kill the running tmux-autoreload instance.\n  -s      Show tmux-autoreload status\n\nInstallation\n  To install tmux-autoreload with TPM (https://github.com/tmux-plugins/tpm), add the\n  following line to the end of your tmux configuration file:\n      set-option -g @plugin 'b0o/tmux-autoreload'\n\n  If you don't use a plugin manager, git clone tmux-autoreload to the location of your\n  choice and run it directly:\n      run-shell \"/path/to/tmux-autoreload/tmux-autoreload.tmux\"\n\n  Once installed, you should be good to go unless you use non-standard\n  configuration file paths or want to customize how tmux-autoreload behaves.\n\nConfiguration file paths\n  If your config file is at a non-standard location or if you have multiple,\n  specify them in @tmux-autoreload-configs, separated by commas:\n    set-option -g @tmux-autoreload-configs '/path/to/configs/a.conf,/path/to/configs/b.conf'\n\nEntrypoints\n  Normally, tmux-autoreload will source whichever file changed. If you wish to\n  source a specific set of files when any configuration file changes, use\n  @tmux-autoreload-entrypoints:\n    set-option -g @tmux-autoreload-entrypoints '/path/to/entrypoint.conf'\n\n  You can specify multiple entrypoints separated by commas. All entrypoints\n  will be sourced when any watched file changes.\n\n  Set @tmux-autoreload-entrypoints to 1 to use the standard tmux configuration\n  files as entrypoints, usually /etc/tmux.conf and ~/.tmux.conf. You can see\n  these files with:\n    tmux display-message -p \"#{config_files}\".\n\n  Entrypoint Notes:\n  - If entrypoints are configured, a changed file itself will not necessarily\n    be reloaded unless it's an entrypoint or is sourced by an entrypoint.\n\n  - Entrypoints will not be watched unless they're a standard tmux\n    configuration file like ~/.tmux.conf or are included in @tmux-autoreload-configs.\n\nOther Options\n  @tmux-autoreload-quiet 0|1 (Default: 0)\n    If set to 1, tmux-autoreload will not display messages\n\n```\n\n\u003c!-- /USAGE --\u003e\n\n## License\n\n\u003c!-- LICENSE --\u003e\n\n\u0026copy; 2021 Maddison Hellstrom\n\nReleased under the MIT License.\n\n\u003c!-- /LICENSE --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fb0o%2Ftmux-autoreload","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fb0o%2Ftmux-autoreload","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fb0o%2Ftmux-autoreload/lists"}