# Moji

> Find, inspect, and safely download fonts from the terminal.
- [Moji documentation](https://moji.micr.dev/docs): Find, inspect, and safely download fonts from the terminal.
- [Install Moji and find your first font](https://moji.micr.dev/docs/tutorial): Install the CLI, inspect a ranked result, and download a validated font.

## Use Moji
  - [Search and filter results](https://moji.micr.dev/docs/how-to/search-and-filter): Narrow a font search by format, weight, provider, and result count.
  - [Enable GitHub search](https://moji.micr.dev/docs/how-to/github-authentication): Configure the token required by the GitHub Code Search provider.
  - [Download a font family](https://moji.micr.dev/docs/how-to/download-families): Select multiple weights from the highest-ranked family source.
  - [Convert font formats](https://moji.micr.dev/docs/how-to/convert-font-formats): Convert TTF or OTF fonts to WOFF2 and restore WOFF2 fonts locally.
  - [Automate Moji with JSON](https://moji.micr.dev/docs/how-to/automate-with-json): Use structured output and exit codes in scripts and pipelines.
  - [Manage configuration and cache](https://moji.micr.dev/docs/how-to/manage-config-and-cache): Change persistent defaults, inspect effective settings, and clear cached results.

## Reference
  - [CLI reference](https://moji.micr.dev/docs/reference/cli): Commands, flags, output modes, and defaults.
  - [Configuration reference](https://moji.micr.dev/docs/reference/configuration): YAML fields, paths, environment variables, and precedence.
  - [Provider reference](https://moji.micr.dev/docs/reference/providers): Availability, authentication, trust, and fallback behavior.
  - [Source plugin protocol](https://moji.micr.dev/docs/reference/source-plugins): Add direct font discovery sources with a local executable.
  - [Errors and exit codes](https://moji.micr.dev/docs/reference/errors-and-exit-codes): Understand failures, preserved state, and the next recovery step.

## Understand Moji
  - [Architecture](https://moji.micr.dev/docs/explanation/architecture): How Moji separates providers, aggregation, ranking, interfaces, and downloads.
  - [Ranking and font families](https://moji.micr.dev/docs/explanation/ranking-and-families): Why Moji parses filenames and ranks groups before selecting downloads.
  - [Download safety and licensing](https://moji.micr.dev/docs/explanation/download-safety-and-licensing): What Moji validates, what it preserves on failure, and what remains the user's responsibility.