{"id":32544422,"url":"https://github.com/cdzombak/newt","last_synced_at":"2026-07-06T08:31:13.814Z","repository":{"id":321090930,"uuid":"1084445441","full_name":"cdzombak/newt","owner":"cdzombak","description":"Git worktree manager","archived":false,"fork":false,"pushed_at":"2025-10-27T19:11:05.000Z","size":710,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-29T08:31:13.075Z","etag":null,"topics":["git","worktrees"],"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/cdzombak.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-10-27T17:31:16.000Z","updated_at":"2026-06-13T19:47:57.000Z","dependencies_parsed_at":"2025-10-27T19:26:54.096Z","dependency_job_id":null,"html_url":"https://github.com/cdzombak/newt","commit_stats":null,"previous_names":["cdzombak/newt"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/cdzombak/newt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Fnewt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Fnewt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Fnewt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Fnewt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cdzombak","download_url":"https://codeload.github.com/cdzombak/newt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdzombak%2Fnewt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35184015,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-06T02:00:07.184Z","response_time":106,"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":["git","worktrees"],"created_at":"2025-10-28T17:59:18.143Z","updated_at":"2026-07-06T08:31:13.809Z","avatar_url":"https://github.com/cdzombak.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"![newt logo](newt.png)\n\n# newt\n\nManage Git worktrees with ease. `newt` is a simple wrapper around Git worktrees that automatically organizes them in a `.newt/` directory, provides merge status tracking, and handles deletion.\n\n## Usage\n\n```text\nnewt [-b] \u003cbranch\u003e\nnewt -d \u003cworktree\u003e\nnewt -l\n```\n\n### Options\n\n- `\u003cbranch\u003e`: Create a worktree for the specified branch in `.newt/\u003cbranch\u003e`. Slashes in branch names are converted to hyphens in the directory name.\n- `-b`: Create a new branch and worktree together.\n- `-d \u003cworktree\u003e`: Delete the specified worktree and its branch. Asks for confirmation if the branch has not been merged.\n- `-l`: List all worktrees with their merge status (merged/unmerged relative to the default branch).\n- `-h`, `--help`: Print help and exit.\n- `-v`, `--version`: Print version and exit.\n\n### Examples\n\nCreate a worktree for an existing branch:\n\n```shell\nnewt feature/new-api\n# Creates .newt/feature-new-api/ and opens a shell there\n```\n\nCreate a new branch and worktree:\n\n```shell\nnewt -b bugfix/issue-123\n# Creates new branch and .newt/bugfix-issue-123/ worktree\n```\n\nList all worktrees with merge status:\n\n```shell\nnewt -l\n# Shows worktrees with their branches and merge status\n```\n\nDelete a worktree and its branch:\n\n```shell\nnewt -d feature-new-api\n# Removes the worktree and deletes the branch\n# Asks for confirmation if the branch hasn't been merged\n```\n\n## Installation\n\n### macOS via Homebrew\n\n```shell\nbrew install cdzombak/oss/newt\n```\n\nShell completions for bash and zsh are installed automatically to:\n- Bash: `$(brew --prefix)/etc/bash_completion.d/newt`\n- Zsh: `$(brew --prefix)/share/zsh/site-functions/_newt`\n\n**Note:** After installation, start a new shell session for completions to take effect. If completions still don't work:\n\n```shell\n# For bash, ensure bash-completion is installed and sourced\nbrew install bash-completion@2\n\n# For zsh, rebuild completion cache\nrm -f ~/.zcompdump \u0026\u0026 compinit\n\n# Verify the completion files exist\nls -la $(brew --prefix)/etc/bash_completion.d/newt\nls -la $(brew --prefix)/share/zsh/site-functions/_newt\n```\n\n### Debian via apt repository\n\nInstall my Debian repository if you haven't already:\n\n```shell\nsudo apt-get install ca-certificates curl gnupg\nsudo install -m 0755 -d /etc/apt/keyrings\ncurl -fsSL https://dist.cdzombak.net/deb.key | sudo gpg --dearmor -o /etc/apt/keyrings/dist-cdzombak-net.gpg\nsudo chmod 0644 /etc/apt/keyrings/dist-cdzombak-net.gpg\necho -e \"deb [signed-by=/etc/apt/keyrings/dist-cdzombak-net.gpg] https://dist.cdzombak.net/deb/oss any oss\\n\" | sudo tee -a /etc/apt/sources.list.d/dist-cdzombak-net.list \u003e /dev/null\nsudo apt-get update\n```\n\nThen install `newt` via `apt-get`:\n\n```shell\nsudo apt-get install newt\n```\n\nShell completions for bash and zsh are installed automatically.\n\n### Manual installation from build artifacts\n\nPre-built binaries are downloadable from each [GitHub Release](https://github.com/cdzombak/newt/releases). Debian packages for each release are available as well.\n\n### Build and install locally\n\n```shell\ngit clone https://github.com/cdzombak/newt.git\ncd newt\nmake build\n\ncp out/newt-[VERSION]-all $INSTALL_DIR/newt\n```\n\n### Shell Completions\n\n**Note:** If you installed via Homebrew or the Debian package, shell completions are already installed and configured. The instructions below are only needed for manual installations.\n\nFor Homebrew installations, completions should work immediately in new shell sessions. For Debian installations, you may need to restart your shell or source the completion files:\n\n```shell\n# Bash (Debian)\nsource /usr/share/bash-completion/completions/newt\n\n# Zsh (Debian)\n# Ensure /usr/share/zsh/vendor-completions is in your $fpath\n# and run: compinit\n```\n\n#### Manual Installation\n\nShell completion scripts are available in the `completions/` directory.\n\n##### Bash\n\nAdd to your `~/.bashrc` or `~/.bash_profile`:\n\n```shell\nsource /path/to/newt/completions/newt.bash\n```\n\nOr copy the completion script to your system's bash completions directory:\n\n```shell\n# macOS (Homebrew)\ncp completions/newt.bash $(brew --prefix)/etc/bash_completion.d/newt\n\n# Linux\nsudo cp completions/newt.bash /etc/bash_completion.d/newt\n```\n\n##### Zsh\n\nCopy the completion script to a directory in your `$fpath`:\n\n```shell\n# Example: using ~/.zsh/completions\nmkdir -p ~/.zsh/completions\ncp completions/_newt ~/.zsh/completions/\n```\n\nThen add to your `~/.zshrc` (before `compinit`):\n\n```shell\nfpath=(~/.zsh/completions $fpath)\nautoload -Uz compinit \u0026\u0026 compinit\n```\n\nOr for Homebrew users:\n\n```shell\ncp completions/_newt $(brew --prefix)/share/zsh/site-functions/_newt\n```\n\n## About\n\n- Issues: [github.com/cdzombak/newt/issues](https://github.com/cdzombak/newt/issues)\n- Author: [Chris Dzombak](https://www.dzombak.com)\n  - [GitHub: @cdzombak](https://www.github.com/cdzombak)\n\n## License\n\nMIT; see `LICENSE` in this repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdzombak%2Fnewt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcdzombak%2Fnewt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdzombak%2Fnewt/lists"}