{"id":20162592,"url":"https://github.com/zdharma-continuum/git-url","last_synced_at":"2026-06-08T11:02:33.342Z","repository":{"id":103426695,"uuid":"423690445","full_name":"zdharma-continuum/git-url","owner":"zdharma-continuum","description":null,"archived":false,"fork":false,"pushed_at":"2023-04-16T05:39:24.000Z","size":46,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-11-30T21:38:43.731Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zdharma-continuum.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":"2021-11-02T03:07:14.000Z","updated_at":"2021-11-10T17:44:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"82106d01-d0fd-4857-b505-97c3000aa7b2","html_url":"https://github.com/zdharma-continuum/git-url","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zdharma-continuum/git-url","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdharma-continuum%2Fgit-url","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdharma-continuum%2Fgit-url/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdharma-continuum%2Fgit-url/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdharma-continuum%2Fgit-url/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zdharma-continuum","download_url":"https://codeload.github.com/zdharma-continuum/git-url/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdharma-continuum%2Fgit-url/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34059157,"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-06-08T02:00:07.615Z","response_time":111,"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":[],"created_at":"2024-11-14T00:25:50.968Z","updated_at":"2026-06-08T11:02:33.322Z","avatar_url":"https://github.com/zdharma-continuum.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# git-url\n\nThis package adds two Git commands:\n\n- **url** – generates so called *giturl* which encodes repository fetch-URL and revision (can also hold paths to files);\n  example giturl: `gitu://ҝjȩMżEäḝЃȣϟṈӛŀї` (points to `master` branch of this project),\n- **guclone** – clones given giturl, checkouts revision stored in this giturl.\n\nIn short:\n\n1. The giturls use 1024 **unicode letters** via base-1024 encoding, and also Huffman codes, to compress resulting\n   string.\n   - **SMALL SIZE**\n1. Thanks to using glyphs that are **letters** (not symbols) double clicking on giturl always selects whole string,\n   regardless if it's done in e.g. Firefox, Chrome, iTerm2, xterm, etc.\n   - **CALM SELECTING**\n1. `git url ...` and `git guclone ...` understand giturls also without leading `gitu://`, and with leading `//`, so\n   grabbing and using such url is easy.\n   - **EASY USE**\n1. You can encode path to file in the giturl, to e.g. point someone to a location in project.\n   - **PACKED WITH DATA**\n\nCompare length of the above example giturl to the data it stores:\n\n```\nҝjȩMżEäḝЃȣϟṈӛŀї\nhttps://github.com/zdharma/git-urlmaster\n```\n\n## Screenshot\n\n![Screenshot](https://raw.githubusercontent.com/zdharma/git-url/images/git-url.png)\n\n# Installation\n\n#### make install\n\nRecursively clone and run `make install`. Default install location is `/usr/local`. It can be overriden by setting\n`PREFIX`, e.g. `make install PREFIX=/opt`.\n\n```sh\ngit clone --recursive https://github.com/zdharma/git-url\ncd git-url\nmake install\n```\n\n#### Zplugin\n\nIf you use Zshell then there's a nice way of installing – via [Zplugin](https://github.com/zdharma-continuum/zinit):\n\n```zsh\nzplugin ice as\"program\" pick\"$ZPFX/bin/git-(url|guclone)\" make\"install PREFIX=$ZPFX\"\nzplugin light zdharma/git-url\n```\n\nTo update, execute `zplugin update zdharma/git-url`. `$ZPFX` is `~/.zplugin/polaris` by default.\n\n#### Extra info\n\nThe project uses two subprojects, one of them written in C++ (compiled with CMake), second one in Zshell. They are the\ncomputation backends, and any of the two will work (choose with `export GITURL_TOOL=zgiturl` or `...=cgiturl`).\n\n# Limitations\n\nOnly a subset of ASCII is encoded. This is sufficient for typical Github usage, where user and repository name are\nrequired to not use symbols, and where typical project branch names and file names are simple ASCII. Following\ncharacters can appear in input data – in the server, repository path, user name, revision, file path:\n\\[a-zA-Z0-9.\\_~:/-\\].\n\n# Encoding file paths\n\nUse `-p` option to embed path to file in giturl:\n\n```sh\n% git url -p lib/common.sh\nEncoding... INPUT is next paragraph:\n\nProtocol: https\nSite: github.com\nRepo: zdharma/zplugin.git\nRevision: master\nFile: lib/common.sh\n\ngitu://ŬϽẝá0ȘéőϞȳƾDZϠѝŌěcḆΚṳȣϟṈӛŀї\n```\n\nSuggested is to use tilde `~` to separate multiple file paths. The project can be easily extended if this workaround\nwill not suffice, to encode multiple file paths natively.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzdharma-continuum%2Fgit-url","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzdharma-continuum%2Fgit-url","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzdharma-continuum%2Fgit-url/lists"}