{"id":49077469,"url":"https://github.com/teegre/mux","last_synced_at":"2026-04-20T10:34:29.861Z","repository":{"id":253570190,"uuid":"843803346","full_name":"teegre/mux","owner":"teegre","description":"Basic tmux session manager.","archived":false,"fork":false,"pushed_at":"2025-10-16T07:50:00.000Z","size":17,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-17T10:06:12.896Z","etag":null,"topics":["bash","cli","linux","session-management","tmux"],"latest_commit_sha":null,"homepage":"","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/teegre.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,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-08-17T13:20:34.000Z","updated_at":"2025-10-16T07:50:04.000Z","dependencies_parsed_at":"2024-08-26T09:30:50.468Z","dependency_job_id":"f719f9df-994f-49e5-b290-07f96762bf80","html_url":"https://github.com/teegre/mux","commit_stats":null,"previous_names":["teegre/mux"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/teegre/mux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fmux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fmux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fmux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fmux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/teegre","download_url":"https://codeload.github.com/teegre/mux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teegre%2Fmux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32043170,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T10:33:29.490Z","status":"ssl_error","status_checked_at":"2026-04-20T10:32:30.107Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["bash","cli","linux","session-management","tmux"],"created_at":"2026-04-20T10:34:28.459Z","updated_at":"2026-04-20T10:34:29.837Z","avatar_url":"https://github.com/teegre.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MUX\n\nA basic session manager for tmux.\n\n## Dependencies\n\nLatest versions of **bash**, **coreutils** and **tmux**.\n\n## Install\n\nClone this repository:\n`$ git clone github.com/teegre/mux`\n\nThen:\n`$ cd mux`\n\nFinally:\n`# make install`\n\n## Uninstall\n\n`# make uninstall`\n\n## Usage\n\n`mux`\nShow list of existing sessions and exit.\n\n`mux \u003csession\u003e`\nRun the given tmux session.\n\n`mux new \u003csession\u003e`\nCreate a new session.\n\n`mux edit \u003csession\u003e`\nEdit an existing session.\n\n`mux rm \u003csession\u003e`\nRemove a session.\n\n`mux mv \u003csession\u003e \u003cnew_session\u003e`\nRename a session.\n\n`mux version`\nShow version and exit.\n\n`mux help`\nShow help and exit.\n\n## Configuration\n\nAdd the following lines to the `.tmux.conf` file:\n\n```\nset -g base-index 1\nsetw -g pane-base-index 1\nset -g renumber-windows on\n```\n\nAlso, make sure `$EDITOR` environment variable is set properly.\n\n## Session files\n\n### General Structure\n\nA session file is a plain text file that defines the configuration of a `tmux` session.\n\n### session-name and session-root\n\n- **`session-name: \u003cname\u003e`**\n  \n  - Defines the name of the `tmux` session.\n  - Example: `session-name: dev`\n\n- **`session-root: \u003cpath\u003e`**\n  \n  - Sets the root directory for the session.\n  - Example: `session-root: ~/projects/myapp`\n\n### Window and Pane Definitions\n\nEach window and pane is defined by a line with the following format:\n\n- **`\u003cwindow_name\u003e \u003cpane_number\u003e \u003ccommand\u003e`**\n  - **`\u003cwindow_name\u003e`**: The name of the window.\n  - **`\u003cpane_number\u003e`**: The number of the pane within the window.\n  - **`\u003ccommand\u003e`**: The command to run in the specified pane.\n  - Example: `mywindow 1 vim .`\n\n### Special Pane Modifiers\n\n- **Splitting Panes**:\n  \n  - **`v`**: Indicates a vertical split.\n  - **`h`**: Indicates a horizontal split.\n  - Example: `mywindow 2v npm start` (Creates a vertical split for pane `2` in window `mywindow`.)\n\n- **Active Pane**:\n  \n  - **`*`**: Indicates that the pane should be active after the session starts.\n  - Example: `mywindow 2* git status` (Makes pane `2` in window `mywindow` the active pane.)\n\n- **Setting Layout**:\n  \n  - **`layout`**: Applies a specific layout to the window.\n  - Example: `mywindow layout main-horizontal` (Sets the layout of window `1` to `main-horizontal`.)\n  \n  - For more complex layout, it is possible to paste the output of `tmux` **list-windows** command.\n  - Example:\n    \n    ```\n    # Output of 'tmux list-windows -t test-session'\n    #\n    # 1: my-window* (3 panes) [239x57] [layout 8bbe,239x57,0,0{88x57,0,0,24,150x57,89,0[150x28,89,0,25,150x28,89,29,26]}] @15 (active)\n    \n    # file: test.mux\n    \n    session-name: test-session\n    session-root: ~\n    \n    my-window 1* clear; neofetch\n    my-window 2 clear; neofetch\n    my-window 3 clear; neofetch\n    my-window layout 8bbe,239x57,0,0{88x57,0,0,24,150x57,89,0[150x28,89,0,25,150x28,89,29,26]}\n    ```\n\n### Comments\n\n- Lines starting with `#` are comments and are ignored by **mux**.\n  - Example: `# This is a comment`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteegre%2Fmux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteegre%2Fmux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteegre%2Fmux/lists"}