cosmiconfig/cosmiconfig

Health v2 · maintenance only

Adoption not part of the score

4157 stars · 143 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Cosmiconfig is a Node.js library that searches for and loads configuration files for JavaScript tools and applications. It supports conventional locations like package.json properties, rc files, and JS/TS config modules, with flexible search strategies and caching.

Use cases

• load configuration from package.json property
• find and load rc files for a CLI tool
• support multiple config file formats (json, yaml, js, ts)
• search up the directory tree for a config file
• add configurable settings to a JavaScript library
• load TypeScript config modules

When to choose

• you're building an npm tool or library that needs user configuration
• you want to support the standard JS ecosystem config conventions out of the box
• you need flexible config file discovery with caching

When to avoid

• you need environment-variable-only configuration
• you're not in the Node.js/JavaScript ecosystem
• you need a full config validation schema system (combine with a validator instead)

Facets

library · maturity stable

configuration-management parser developer-tools developer-tools web-development backend cross-platform config-loading rc-files package-json config-discovery javascript-tooling npm automation nodejs javascript typescript

Member repositories

For agents

markdown · JSON · MCP: product_card(name="cosmiconfig/cosmiconfig")