Skip to content
JS
Package

cosmiconfig

Find and load configuration from a package.json property, rc file, TypeScript module, and more!

v10.0.1, 30 Aug 2026MITCommonJSTypes: BundledConfiguration
$ npm install cosmiconfig
npmGitHubHomepage

Key numbers

As of 25 Sept 2026
Weekly downloads
98.7m
+47% over 12 months
Gzip bundle size
-
No Bundlephobia data
Dependencies
2
Direct, from package.json
Last release
25 days ago
v10.0.1
GitHub stars
4.2k
144 forks
Open issues / PRs
8 / 1
Contributors
42
Commits, last 52 weeks
35

Downloads

Last week 2026-09-15 to 2026-09-21
050m100m150mSept 2025Mar 2026Sept 2026High 132.6m (25 Aug 2026)Low 39.5m (23 Dec 2025)
Weekly npm downloads, one point per week, weeks starting 23 Sept 2025 to 15 Sept 2026. The y axis starts at zero.

98,716,314 downloads last week, 456,200,917 in the last month. The 12-month change of +47% compares the average of the last 4 weeks with the first 4 weeks of the series.

Maintenance

Releases, last 12 months
456 in total
Latest version
10.0.1, 30 Aug 202625 days ago
First published
12 Nov 2015
Last push to GitHub
1 Sept 202623 days before the snapshot
Repository archived
No
Open issues
8
Open pull requests
1
Commits, last 52 weeks
35
Dependents on npm
4,795

Major versions

  1. v10 first release 10.0.0, 2 Aug 2026
  2. v9 first release 9.0.0, 26 Nov 2023
  3. v8 first release 8.0.0, 21 Nov 2022
  4. v7 first release 7.0.0, 1 Aug 2020
  5. v6 first release 6.0.0, 2 Nov 2019
  6. v5 first release 5.0.1, 5 May 2018
  7. v4 first release 4.0.0, 16 Jan 2018
  8. v3 first release 3.0.0, 16 Sept 2017
  9. v2 first release 2.0.0, 8 Oct 2016
  10. v1 first release 1.0.0, 18 Nov 2015
  11. v0 first release 0.1.0, 12 Nov 2015

Recent releases

VersionPublished
10.0.130 Aug 2026
10.0.02 Aug 2026
9.0.27 Jun 2026
9.0.12 Mar 2026
9.0.026 Nov 2023
8.3.613 Sept 2023
8.3.58 Sept 2023
8.3.44 Sept 2023
8.3.33 Sept 2023
8.3.22 Sept 2023
8.3.12 Sept 2023
8.3.02 Sept 2023
8.2.04 Jun 2023
8.1.318 Mar 2023

Compatibility

Module format
CommonJSFrom package.json type, main and exports fields
TypeScript types
Bundled
Node.js engine range
^22.18 || >= 24
Runtimes
-
Unpacked size (npm)
77 kB
Dependencies (2)
js-yamlenv-paths

Install

npm install cosmiconfig

CDN

  • jsDelivrhttps://cdn.jsdelivr.net/npm/cosmiconfig@10.0.1/
  • unpkghttps://unpkg.com/cosmiconfig@10.0.1/
  • esm.shhttps://esm.sh/cosmiconfig@10.0.1
Sources: npm registry, npm downloads API, GitHub API. Data fetched 25 Sept 2026.

Indexability: Indexed.