{"id":16752938,"url":"https://github.com/amtoine/nu-git-manager","last_synced_at":"2025-03-17T02:31:08.297Z","repository":{"id":158723445,"uuid":"631583270","full_name":"amtoine/nu-git-manager","owner":"amtoine","description":"A collection of Nushell tools to manage Git repositories.","archived":false,"fork":false,"pushed_at":"2025-02-18T18:56:48.000Z","size":426,"stargazers_count":29,"open_issues_count":16,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-27T16:40:52.208Z","etag":null,"topics":["git","library","nushell","repository-management","vcs"],"latest_commit_sha":null,"homepage":"","language":"Nushell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amtoine.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2023-04-23T13:37:47.000Z","updated_at":"2024-12-13T21:15:28.000Z","dependencies_parsed_at":"2023-07-05T03:02:20.469Z","dependency_job_id":"3cb8516a-5d94-4cfa-ab84-133852bc1b52","html_url":"https://github.com/amtoine/nu-git-manager","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amtoine%2Fnu-git-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amtoine%2Fnu-git-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amtoine%2Fnu-git-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amtoine%2Fnu-git-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amtoine","download_url":"https://codeload.github.com/amtoine/nu-git-manager/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243837004,"owners_count":20355812,"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":["git","library","nushell","repository-management","vcs"],"created_at":"2024-10-13T02:48:41.590Z","updated_at":"2025-03-17T02:31:07.856Z","avatar_url":"https://github.com/amtoine.png","language":"Nushell","readme":"# nu-git-manager\nA collection of Nushell tools to manage `git` repositories.\n\n# Table of content\n- [:bulb: what is `nu-git-manager`](#bulb-what-is-nu-git-manager-toc)\n- [:link: requirements](#link-requirements-toc)\n- [:recycle: installation](#recycle-installation-toc)\n- [:gear: usage](#gear-usage-toc)\n- [:pray: getting help](#pray-getting-help-toc)\n- [:exclamation: some ideas of advanced (?) usage](#exclamation-some-ideas-of-advanced--usage-toc)\n\n## :bulb: what is `nu-git-manager` [[toc](#table-of-content)]\nlike [`ghq`](https://github.com/x-motemen/ghq), `nu-git-manager` aims at being a fully-featured\nrepository manager, purely written in Nushell.\n\nit provides two main modules:\n- `nu-git-manager` itself which ships the main `gm` command\n- `nu-git-manager sugar` which exports a bunch of Git-related tools, e.g. to help use the `gh` command or augment the capabilities of `git`\n\n## :link: requirements [[toc](#table-of-content)]\n- [Nushell] 0.89.0\n    - with Cargo and `cargo install nu`\n- `git` 2.34.1\n    - with Pacman and `pacman -S extra/git`\n    - with Nix and `nix run nixpkgs#git`\n- `gh` (optional) 2.29.0 (used by `sugar gh`)\n    - with Pacman and `pacman -S community/github-cli`\n    - with Nix and `nix run nixpkgs#gh`\n\n## :recycle: installation [[toc](#table-of-content)]\n- install [Nupm] (**recommended**) by following the [Nupm instructions]\n- download the `nu-git-manager` repository\n```shell\ngit clone https://github.com/amtoine/nu-git-manager\n```\n- activate the `toolkit` module with `use toolkit.nu`\n- install the `nu-git-manager` and `nu-git-manager-sugar` packages\n```nushell\ntoolkit install\n```\n- verify the installation after restarting Nushell\n```nushell\ngm version\n```\n\n\u003e **Note**\n\u003e if you are using the latest stable release of Nushell, then you should install `nu-git-manager`\n\u003e from the `main` branch, i.e. by default.\n\u003e\n\u003e if you want to use the latest and hotest builds of Nushell, either by building from source yourself\n\u003e or using the [nightly builds](https://github.com/nushell/nightly), you might want to _checkout_\n\u003e the [`nightly`](https://github.com/amtoine/nu-git-manager/tree/nightly) branch and install from\n\u003e there.\n\u003e this alternative branch should contain all fixes and newest features from the latest versions of\n\u003e Nushell :fire:\n\n## :gear: usage [[toc](#table-of-content)]\nin your `config.nu` you can add the following to load `nu-git-manager` modules:\n```nushell\n# load the main `gm` command\nuse nu-git-manager *\n\n# the following are non-essential modules\nuse nu-git-manager-sugar extra *              # augment `gm` with additional commands\n```\n\n\u003e **Note**  \n\u003e please have a look at the [documentation of NGM](./docs/index.md) for more modules and commands\n\nthen you have access to the whole `nu-git-manager` suite :partying_face:\n\n### :pray: getting help [[toc](#table-of-content)]\nplease have a look at the [documentation of NGM](./docs/index.md)\n\n## :exclamation: some ideas of advanced (?) usage [[toc](#table-of-content)]\neverytime i open a terminal, i use [Tmux] to manage sessions, switch between them, detach and reattach, quite a ***BLAZZINGLY FAST*** workflow for my taste :smirk:\n\nto achieve this, i use the [`tmux-sessionizer.nu` script][`tmux-sessionizer.nu`], again installed with [Nupm] :ok_hand:\n\nthen, in my Tmux config, i have a binding to\n1. list all my Git repositories\n2. fuzzy-pick one of them with the [`main` command of `tmux-sessionizer.nu`][`tmux-sessionizer.nu`]\n3. create or reattach to the session associated with the repository\n```bash\n# ~/.config/tmux/tmux.conf\n\nNUPM_HOME=\"~/.local/share/nupm\"\nTMUX_SESSIONIZER=\"$NUPM_HOME/scripts/tmux-sessionizer.nu\"\n\nbind-key -r t display-popup -E \"nu --commands '\n    use $NUPM_HOME/modules/nu-git-manager *;\\\n    $TMUX_SESSIONIZER (gm list --full-path) --short\\\n'\"\n```\n\n[Nushell]: https://github.com/nushell/nushell\n\n[Nupm]: https://github.com/nushell/nupm\n[Nupm instructions]: https://github.com/nushell/nupm#-installation\n\n[Tmux]: https://github.com/tmux/tmux\n[`tmux-sessionizer.nu`]: https://github.com/amtoine/tmux-sessionizer\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famtoine%2Fnu-git-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famtoine%2Fnu-git-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famtoine%2Fnu-git-manager/lists"}