{"id":15130927,"url":"https://github.com/frenchbread/repos2md","last_synced_at":"2025-10-23T07:30:55.474Z","repository":{"id":7007421,"uuid":"55902215","full_name":"frenchbread/repos2md","owner":"frenchbread","description":"Export GitHub user's repos list to .md file.","archived":false,"fork":false,"pushed_at":"2024-01-10T22:37:49.000Z","size":381,"stargazers_count":2,"open_issues_count":2,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-15T11:10:47.026Z","etag":null,"topics":["converter","exporter","markdown","md","repos","repositories"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/frenchbread.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}},"created_at":"2016-04-10T14:02:17.000Z","updated_at":"2022-04-18T08:06:37.000Z","dependencies_parsed_at":"2023-02-18T10:00:19.474Z","dependency_job_id":null,"html_url":"https://github.com/frenchbread/repos2md","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frenchbread%2Frepos2md","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frenchbread%2Frepos2md/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frenchbread%2Frepos2md/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frenchbread%2Frepos2md/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frenchbread","download_url":"https://codeload.github.com/frenchbread/repos2md/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237793960,"owners_count":19367422,"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":["converter","exporter","markdown","md","repos","repositories"],"created_at":"2024-09-26T03:08:36.199Z","updated_at":"2025-10-23T07:30:50.137Z","avatar_url":"https://github.com/frenchbread.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"repos2md [![npm version](https://badge.fury.io/js/repos2md.svg)](https://badge.fury.io/js/repos2md)\n--\n\n\u003e Export GutHub user repos list to a markdown file.\n\n[![NPM](https://nodei.co/npm/repos2md.png?downloads=true\u0026downloadRank=true\u0026stars=true)](https://nodei.co/npm/repos2md/)\n\n[![NPM](https://nodei.co/npm-dl/repos2md.png)](https://nodei.co/npm/repos2md/)\n\n## install\n\n```bash\n# globally\n\n❯ npm i repos2md --global\n\n# or in project\n\n❯ npm i repos2md --save\n```\n\n## usage\n\n### `cli`\n\n```bash\n❯ repos2md --help\n\n  Export repos list to a markdown file.\n\n  repos2md v2.0.1\n\n  Usage\n    $ repos2md \u003cusername\u003e\n    $ repos2md \u003cusername\u003e --save-to \u003cpath\u003e --exclude-repos-count\n    $ repos2md --token \u003ctoken\u003e\n\n  Options\n    --starred                 optional (default is user repos)        If provided, user's starred repos will be fetched\n    --save-to                 optional (defaults to project root)     Absolute path to the target file (.md document) to write to\n    --token                   optional (includes private repos)       Your GitHub token (Will return only authenticated user's public \u0026 private repos)\n    --exclude-repos-count     optional                                Exclude repos count from heading in target file\n\n  Examples\n    $ repos2md octocat\n    $ repos2md octocat --starred --save-to /Users/frenchbread/Desktop --exclude-repos-count\n    $ repos2md --token \u003cyour_gh_token\u003e\n    $ repos2md --token \u003cyour_gh_token\u003e --starred\n```\n\n### `nodejs`\n\n```js\nconst repos2md from 'repos2md'\n\n\nrepos2md('github')\n  .then(saved_to =\u003e console.log(`Repos saved to \"${saved_to}\"`))\n```\n\n## api\n\n### repos2md(github_username, options?)\n\nReturns `\u003cpath\u003e` to where file has been saved.\n\n#### options\n\ntype: `object`\n\n- **starred**\n\n  type: `boolean`\n\n  Fetch user's starred repos.\n\n- **save_to**\n\n  type: `string`\n\n  Custom path to where write file to. Can be both relative \u0026 absolute.\n\n- **token**\n\n  type: `string`\n\n  GitHub [token](https://github.com/settings/tokens), used to include private repos and extend rate-limits.\n\n- **exclude_repos_count**\n\n  type: `boolean`\n\n  Exclude repos count from target doc.\n\n### **note!**\n\n\u003e For unauthenticated requests, the rate limit allows for up to 60 requests per hour. Unauthenticated requests are associated with the originating IP address, and not the user making requests.\n\u003e\n\u003e [Source](https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting)\n\n\n### todos\n- [x] Change input username/path approach\n- [x] Write \u0026 add tests\n- [x] Handle paths containing `~`\n\n\u003e Contributions are welcome!\n\n### author\n\n- Damir Mustafin [@frenchbread](https://github.com/frenchbread)\n\n### license\n\n[MIT](https://github.com/frenchbread/repos2md/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrenchbread%2Frepos2md","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrenchbread%2Frepos2md","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrenchbread%2Frepos2md/lists"}