{"id":13479628,"url":"https://github.com/tiged/tiged","last_synced_at":"2025-05-14T18:06:58.715Z","repository":{"id":37954970,"uuid":"338164424","full_name":"tiged/tiged","owner":"tiged","description":"Community driven fork of degit","archived":false,"fork":false,"pushed_at":"2025-04-23T06:26:05.000Z","size":1538,"stargazers_count":366,"open_issues_count":17,"forks_count":24,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-09T11:08:40.132Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/tiged.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2021-02-11T22:03:59.000Z","updated_at":"2025-05-02T08:27:10.000Z","dependencies_parsed_at":"2024-06-18T14:39:49.267Z","dependency_job_id":"9e59768f-bfae-4779-bc0f-b5c5bf45a0c6","html_url":"https://github.com/tiged/tiged","commit_stats":{"total_commits":646,"total_committers":31,"mean_commits":"20.838709677419356","dds":0.5588235294117647,"last_synced_commit":"21cb3020736e0977d08f28fed8d0695072c61877"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiged%2Ftiged","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiged%2Ftiged/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiged%2Ftiged/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiged%2Ftiged/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tiged","download_url":"https://codeload.github.com/tiged/tiged/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254198515,"owners_count":22030966,"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":[],"created_at":"2024-07-31T16:02:20.462Z","updated_at":"2025-05-14T18:06:53.706Z","avatar_url":"https://github.com/tiged.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","others","JavaScript"],"sub_categories":[],"readme":"\u003e Awesome fork of [degit](https://github.com/Rich-Harris/degit). **Please join our [discord](https://discord.gg/bNHqU797ee) \u003c- new fixed link.**\n\n\u003cdiv align=\"center\"\u003e\n\n# tiged — straightforward project scaffolding\n\n![tiged-logo](https://user-images.githubusercontent.com/6876030/195346830-f1804e60-2842-436a-b013-a3b2095cea8e.png)\n\u003csup\u003eStable diffusion (AI) generated logo\u003c/sup\u003e\n\n[![Build Status](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Ftiged%2Ftiged%2Fbadge%3Fref%3Dmain\u0026style=flat)](https://actions-badge.atrox.dev/tiged/tiged/goto?ref=main)\n[![Known Vulnerabilities](https://snyk.io/test/npm/degit/badge.svg)](https://snyk.io/test/npm/tiged)\n[![install size](https://badgen.net/packagephobia/install/tiged)](https://packagephobia.now.sh/result?p=tiged)\n[![npm package version](https://badgen.net/npm/v/tiged)](https://npm.im/tiged)\n[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)\n\n\u003c/div\u003e\n\n**tiged** makes copies of git repositories. When you run `tiged some-user/some-repo` or (for backward compatibility) `degit some-user/some-repo`, it will find the latest commit on https://github.com/some-user/some-repo and download the associated tar file to `~/.degit/some-user/some-repo/commithash.tar.gz` if it doesn't already exist locally. (This is much quicker than using `git clone`, because you're not downloading the entire git history.)\n\n## Installation\n\n```bash\nnpm uninstall -g degit\nnpm install -g tiged\n```\n\n## Usage\n\n### Basics\n\n\u003e You can use tiged or degit as the command. So no automated scripts break if you swap degit for tiged.\n\nThe simplest use of tiged is to download the main branch of a repo from GitHub to the current working directory:\n\n```bash\ntiged user/repo\n\n# these commands are equivalent\ntiged github:user/repo\ntiged git@github.com:user/repo\ntiged https://github.com/user/repo\n```\n\nOr you can download from GitLab, BitBucket, Sourcehut, Hugging Face, and Codeberg:\n\n```bash\n# download from GitLab\ntiged gitlab:user/repo\ntiged git@gitlab.com:user/repo\ntiged https://gitlab.com/user/repo\n\n# download from BitBucket\ntiged bitbucket:user/repo\ntiged git@bitbucket.org:user/repo\ntiged https://bitbucket.org/user/repo\n\n# download from Sourcehut\ntiged git.sr.ht/user/repo\ntiged git@git.sr.ht:user/repo\ntiged https://git.sr.ht/user/repo\n\n# download from Hugging Face\ntiged huggingface:user/repo\ntiged git@huggingface.co:user/repo\ntiged https://huggingface.co/user/repo\n\n# download from Codeberg\ntiged codeberg:user/repo\ntiged git@codeberg.org:user/repo\ntiged https://codeberg.org/user/repo\n```\n\n### Specify a tag, branch or commit\n\n```bash\ntiged user/repo#dev       # branch\ntiged user/repo#v1.2.3    # release tag\ntiged user/repo#1234abcd  # commit hash\n```\n\n### Create a new folder for the project\n\nIf the second argument is omitted, the repo will be cloned to the current directory.\n\n```bash\ntiged user/repo my-new-project\n```\n\n### Disable cache\n\nNormally tiged caches tar.gz of the repo for future use. This is sometimes unwanted (e.g. scroll down for known bug)\n\n```bash\ntiged --disable-cache user/repo\n```\n\n### Specify a subdirectory\n\nTo clone a specific subdirectory instead of the entire repo, just add it to the argument:\n\n```bash\ntiged user/repo/subdirectory\n```\n\n### Subgroups (GitLab)\n\nTo get a GitLab repo that has a subgroup use the `--subgroup` option.\n\n```bash\ntiged --subgroup https://gitlab.com/group-test-repo/subgroup-test-repo/test-repo my-dir\ntiged -s https://gitlab.com/group-test-repo/subgroup-test-repo/test-repo my-dir\n```\n\nTo get a subdirectory of a repo inside a subgroup, use the `--sub-directory` option.\n\n```bash\ntiged --subgroup https://gitlab.com/group-test-repo/subgroup-test-repo/test-repo --sub-directory subdir1 my-dir\n```\n\n### HTTPS proxying\n\nIf you have an `https_proxy` environment variable, Tiged will use it.\n\n### Private repositories\n\nPrivate repos can be cloned by specifying `--mode=git` (the default is `tar`). In this mode, Tiged will use `git` under the hood. It's much slower than fetching a tarball, which is why it's not the default.\n\nNote: this clones over SSH, not HTTPS.\n\n### See all options\n\n```bash\ntiged --help\n```\n\n## Wait, isn't this just `git clone --depth 1`?\n\nA few salient differences:\n\n- If you `git clone`, you get a `.git` folder that pertains to the project template, rather than your project. You can easily forget to re-init the repository, and end up confusing yourself\n- Caching and offline support (if you already have a `.tar.gz` file for a specific commit, you don't need to fetch it again).\n- Less to type (`tiged user/repo` instead of `git clone --depth 1 git@github.com:user/repo`)\n- Composability via [actions](#actions)\n- Future capabilities — [interactive mode](https://github.com/Rich-Harris/degit/issues/4), [friendly onboarding and postinstall scripts](https://github.com/Rich-Harris/degit/issues/6)\n\n## JavaScript API\n\nYou can also use tiged inside a Node script:\n\n```js\nconst tiged = require('tiged');\n\nconst emitter = tiged('user/repo', {\n  disableCache: true,\n  force: true,\n  verbose: true,\n});\n\nemitter.on('info', info =\u003e {\n  console.log(info.message);\n});\n\nemitter.clone('path/to/dest').then(() =\u003e {\n  console.log('done');\n});\n```\n\n## Actions\n\nYou can manipulate repositories after they have been cloned with _actions_, specified in a `degit.json` file that lives at the top level of the working directory. Currently, there are two actions — `clone` and `remove`. Additional actions may be added in future.\n\n### clone\n\n```json\n// degit.json\n[\n  {\n    \"action\": \"clone\",\n    \"src\": \"user/another-repo\"\n  }\n]\n```\n\nThis will clone `user/another-repo`, preserving the contents of the existing working directory. This allows you to, say, add a new README.md or starter file to a repo that you do not control. The cloned repo can contain its own `degit.json` actions.\n\n### remove\n\n```json\n// degit.json\n[\n  {\n    \"action\": \"remove\",\n    \"files\": [\"LICENSE\"]\n  }\n]\n```\n\nRemove a file at the specified path.\n\n## Known bugs and workarounds\n\n- `zlib: unexpected end of file`: this is solved by using option `--disable-cache` or clearing the cache folder (`rm -rf ~/.degit`); more details in [#45](https://github.com/tiged/tiged/issues/45)\n\n### Why I forked degit?\n\n- `degit` was last released over a year ago Feb 5, 2020, and Rich is not answering pull requests or issues there. He is probably very busy with Svelte and we love him for that._Rich has now (April 1, 2021) merged the main branch fix. Regardless currently this fork is still more fully featured and will continue to be developed._\n- We want pull requests merged. E.g. like automatically working with `main` or other default branch (has been merged!).\n- Update dependencies.\n- Hopefully get multiple active maintainers.\n\n### What has been fixed?\n\n- Works with `main` or any default branch automatically. [#243](https://github.com/Rich-Harris/degit/pull/243)\n- `--mode=git` with private repos now work on Windows [#191](https://github.com/Rich-Harris/degit/pull/191).\n- `degit --help` now works. Previously it would crash instead of displaying help.md contents. [#179](https://github.com/Rich-Harris/degit/pull/179)\n- `--mode=git` is now faster. [#171](https://github.com/Rich-Harris/degit/pull/171)\n- Github Actions CI tests working. Added Github Actions badge and removed old CI badges.\n- Added support for privately hosted git repositories ([#10](https://github.com/tiged/tiged/pull/10))\n- GitLab works again. [#18](https://github.com/tiged/tiged/pull/18)\n- Subdir works in `--mode=git` [#19](https://github.com/tiged/tiged/pull/19)\n- Subgroups work in GitLab [#24](https://github.com/tiged/tiged/pull/24)\n- Hashes work with git mode [#34](https://github.com/tiged/tiged/pull/34)\n- Using full async + cjs (no build needed) [#41](https://github.com/tiged/tiged/pull/41)\n- Option to not use cache [#36](https://github.com/tiged/tiged/issue/36)\n\n#### It might be time to move on.\n\n## Special Thanks\n\n## See also\n\n- [zel](https://github.com/vutran/zel) by [Vu Tran](https://twitter.com/tranvu)\n- [gittar](https://github.com/lukeed/gittar) by [Luke Edwards](https://twitter.com/lukeed05)\n- [gitpick](https://github.com/nrjdalal/gitpick) - by [Neeraj Dalal](https://twitter.com/nrjdalal_com)\n\n## License\n\n[MIT](LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiged%2Ftiged","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftiged%2Ftiged","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiged%2Ftiged/lists"}