{"id":28075251,"url":"https://github.com/kumneger0/cheztui","last_synced_at":"2025-05-13T00:55:40.940Z","repository":{"id":292901523,"uuid":"981460450","full_name":"Kumneger0/cheztui","owner":"Kumneger0","description":"A tiny chezmoi wrapper that makes super easy to manage your dotfiles","archived":false,"fork":false,"pushed_at":"2025-05-12T17:49:46.000Z","size":4407,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-13T00:55:37.081Z","etag":null,"topics":["bubbletea","charm","chezmoi","golang","lipgloss"],"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/Kumneger0.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}},"created_at":"2025-05-11T06:43:23.000Z","updated_at":"2025-05-12T17:49:46.000Z","dependencies_parsed_at":"2025-05-12T18:47:29.185Z","dependency_job_id":"c9897b3b-d322-4e24-b24a-9334650ef9e1","html_url":"https://github.com/Kumneger0/cheztui","commit_stats":null,"previous_names":["kumneger0/cheztui"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kumneger0%2Fcheztui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kumneger0%2Fcheztui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kumneger0%2Fcheztui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kumneger0%2Fcheztui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kumneger0","download_url":"https://codeload.github.com/Kumneger0/cheztui/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253850890,"owners_count":21973672,"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":["bubbletea","charm","chezmoi","golang","lipgloss"],"created_at":"2025-05-13T00:55:40.173Z","updated_at":"2025-05-13T00:55:40.925Z","avatar_url":"https://github.com/Kumneger0.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chez-TUI\n\nChez-TUI is a tiny [chezmoi](https://www.chezmoi.io/) wrapper that makes it super easy to manage your dotfiles. So you don't have to remember a bunch of chezmoi commands.\n\n## Why Chez-TUI ?\ni use chezmoi to manage my dotfiles and im so lazy to type out the commands all the time, so i made this little tool to make my life easier.\n\n## What It Can Do\n\n- **Manage Files**: Quickly view, add, edit, or remove files managed by chezmoi.\n- **File Picker**: Browse your file system and pick files right from the terminal.\n- **Shortcut Commands**: Do common tasks like `apply`, `diff`, and `edit` with just a key press.\n- **Notifications**: Get instant feedback on what’s happening with toast messages.\n- **Switch Views**: Easily toggle between different screens for specific tasks(eg editing a file).\n\n## What You’ll Need\n\n- [chezmoi](https://www.chezmoi.io/): Make sure it’s installed and set up.\n\n## How to Use It\n\n1. Clone the repo:\n   ```bash\n   git clone https://github.com/kumneger0/cheztui.git\n   cd cheztui\n   ```\n\n2. Install dependencies:\n   ```bash\n   go mod tidy\n   ```\n\n3. Build the app:\n   ```bash\n   go build -o cheztui main.go\n   ```\n\n4. Run it:\n   ```bash\n   ./cheztui\n   ```\n\n\n ## Note\ncheztui is just a wrapper around [chezmoi](https://www.chezmoi.io/). to see more about what each command does, make sure to check out the [chezmoi documentation](https://www.chezmoi.io/).\n\n## Key Shortcuts with Equivalent chezmoi Commands\n\n- `a`: Add a file to chezmoi. Equivalent to:\n  ```bash\n  chezmoi add \u003cfile\u003e\n  ```\n- `r`: Remove a file from chezmoi. Equivalent to:\n  ```bash\n  chezmoi forget \u003cfile\u003e\n  ```\n- `e`: Edit a file. Equivalent to:\n  ```bash\n  chezmoi edit \u003cfile\u003e\n  ```\n- `d`: Show the diff of the current file. Equivalent to:\n  ```bash\n  chezmoi diff \u003cfile\u003e\n  ```\n- `D`: Show diffs for all files. Equivalent to:\n  ```bash\n  chezmoi diff\n  ```\n- `enter`: Navigate to a directory (no direct chezmoi equivalent; used for navigation in the TUI).\n- `A`: Apply changes. Equivalent to:\n  ```bash\n  chezmoi apply\n  ```\n- `L`: Show both managed and unmanaged files. Equivalent to:\n  ```bash\n  chezmoi managed \u0026\u0026 chezmoi unmanaged\n  ```\n- `m`: Show only managed files. Equivalent to:\n  ```bash\n  chezmoi managed\n  ```\n- `u`: Show unmanaged files. Equivalent to:\n  ```\n  chezmoi unmanaged\n  ```\n- `esc`: Close the file picker or go back (no direct chezmoi equivalent; used for navigation in the TUI).\n- `ctrl+c` or `q`: Quit the app (no direct chezmoi equivalent; used to exit the TUI).\n\n## Major Dependencies\n\n- [chezmoi](https://www.chezmoi.io/): The core tool for managing dotfiles.\n- [Bubble Tea](https://github.com/charmbracelet/bubbletea): A powerful, fun, and flexible Go framework for building terminal applications.\n- [Bubbles](https://github.com/charmbracelet/bubbles): Components for Bubble Tea, like lists, file pickers.\n- [Lip Gloss](https://github.com/charmbracelet/lipgloss): A Go library for styling terminal applications.\n\n- [Huh](https://github.com/charmbracelet/huh): A Go library for creating interactive terminal forms.\n\n\n\n## Want to Help?\n\nContributions are welcome! Feel free to open an issue or send a pull request to make Chez TUI even better.\n\n## License\n\nThis project is under the MIT License. Check out the `LICENSE` file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkumneger0%2Fcheztui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkumneger0%2Fcheztui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkumneger0%2Fcheztui/lists"}