{"id":37087391,"url":"https://github.com/phanorcoll/muxie","last_synced_at":"2026-01-14T10:45:15.772Z","repository":{"id":311995856,"uuid":"1031114185","full_name":"phanorcoll/muxie","owner":"phanorcoll","description":"Muxie is a terminal user interface (TUI) tool for tmux that simplifies session management. Define your entire development environment—sessions, windows, and panes—in a simple YAML file and launch it with a single command. Say goodbye to repetitive manual setup and hello to instant, repeatable workflows.","archived":false,"fork":false,"pushed_at":"2026-01-09T23:30:52.000Z","size":1541,"stargazers_count":85,"open_issues_count":2,"forks_count":4,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-10T21:34:09.833Z","etag":null,"topics":["charm","go","golang","tmux","tui"],"latest_commit_sha":null,"homepage":"","language":"Go","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/phanorcoll.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-03T03:26:21.000Z","updated_at":"2026-01-09T23:30:55.000Z","dependencies_parsed_at":"2025-08-28T07:04:59.603Z","dependency_job_id":"17ad7e88-ad52-410f-bc58-72363c7dd2bd","html_url":"https://github.com/phanorcoll/muxie","commit_stats":null,"previous_names":["phanorcoll/muxie"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/phanorcoll/muxie","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phanorcoll%2Fmuxie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phanorcoll%2Fmuxie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phanorcoll%2Fmuxie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phanorcoll%2Fmuxie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phanorcoll","download_url":"https://codeload.github.com/phanorcoll/muxie/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phanorcoll%2Fmuxie/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28417715,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T10:25:19.714Z","status":"ssl_error","status_checked_at":"2026-01-14T10:22:49.371Z","response_time":107,"last_error":"SSL_read: 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":["charm","go","golang","tmux","tui"],"created_at":"2026-01-14T10:45:15.057Z","updated_at":"2026-01-14T10:45:15.767Z","avatar_url":"https://github.com/phanorcoll.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Muxie\n[[Website]](https://muxie.xyz)\n\n\nhttps://github.com/user-attachments/assets/83fc644d-7797-4439-9c06-d0f019d1115a\n\n\n\nHey there! Welcome to Muxie, your new best friend for managing tmux sessions with ease. Gone are the days of manually setting up your development environment every single time. With Muxie, you can define your sessions, windows, and panes in a simple YAML file and get everything up and running in a flash.\n\n## What's Muxie all about?\n\nMuxie is a terminal user interface (TUI) that allows you to select and start predefined tmux sessions. You can configure your sessions in a `config.yml` file, and Muxie will present them in a list for you to choose from. Select a session, hit enter, and Muxie will take care of the rest.\n\n\n\n## Installation\n\nGetting Muxie up and running is a breeze.\n\n### Using Homebrew\n\nIf you're on macOS or Linux, you can install Muxie using [Homebrew](https://brew.sh/).\n\n```bash\nbrew install phanorcoll/homebrew-muxie/muxie\n```\n\n### Manual Installation\n\n1.  Head over to the [releases page](https://github.com/phanorcoll/muxie/releases).\n2.  Download the appropriate asset for your operating system.\n3.  Unzip the downloaded file.\n4.  Place the `muxie` binary in a directory that's in your system's `PATH`.\n\nAnd that's it! You're ready to start using Muxie.\n\n## How to use it\n\nUsing Muxie is as simple as running a single command:\n\n```bash\nmuxie\n```\n\nThis will launch the Muxie TUI, where you'll see a list of all the sessions you've defined in your configuration file.\n\n### Configuration\n\nMuxie looks for a configuration file at `~/.config/muxie/config.yml`. Here's an example of what that file might look like:\n\n```yaml\nsessions:\n  - name: \"My Awesome Project\"\n    directory: \"~/projects/my-awesome-project\"\n    windows:\n      - name: \"Code\"\n        layout: \"vertical\"\n        #layout: \"horizontal\"\n        panes:\n          - command: \"nvim\"\n          - command: \"git status\"\n      - name: \"Server\"\n        panes:\n          - command: \"npm run dev\"\n  - name: \"Another Project\"\n    directory: \"~/projects/another-project\"\n    windows:\n      - name: \"Editor\"\n        panes:\n          - command: \"vim\"\n```\n\nIn this example, we have two sessions defined: \"My Awesome Project\" and \"Another Project\". Each session has a name, a directory where it should be started, and a list of windows. Each window has a name, a layout, and a list of panes. Each pane has a command that will be executed when it's created.\n\n### Keybindings\n\nMuxie uses a simple set of keybindings to make it easy to navigate the TUI:\n\n*   `↑` / `k`: Move up\n*   `↓` / `j`: Move down\n*   `enter`: Select a session\n*   `q`: Quit\n*   `a`: Add new session\n*   `r`: Rename existing session\n*   `s`: Start a session from config.yaml\n*   `d`: Kill running session\n\n## Tmux Integration\n\nYou can integrate Muxie with your `tmux.conf` to launch it with a key binding. This allows you to quickly bring up the Muxie interface without having to type the command in a shell.\n\nHere's an example of how you can bind the `m` key to launch Muxie in a popup window:\n\n```tmux\nbind-key m display-popup \\\n  -w 100% -h 100% \\\n  -B \\\n  -E \"~/\u003cpath\u003e/muxie\"\n```\n\nWith this configuration, pressing `prefix + m` will open Muxie in a full-screen popup, allowing you to select and start a session. Make sure to replace `~/\u003cpath\u003e/muxie` with the actual path to your Muxie binary if it's different.\n\n## Contributing\n\nWe love contributions! If you have an idea for a new feature or have found a bug, please open an issue on our [GitHub repository](https://github.com/phanorcoll/muxie/issues).\n\n## License\n\nMuxie is open-source software licensed under the [MIT License](https://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphanorcoll%2Fmuxie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphanorcoll%2Fmuxie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphanorcoll%2Fmuxie/lists"}