Install Moji and find your first font

This tutorial takes you from installation to a downloaded font. You need a terminal and npm, pnpm, Bun, or Homebrew. You do not need Go.

1. Install the CLI

Use one package manager.

npm

npm install -g @microck/moji

pnpm

pnpm add -g @microck/moji

Bun

bun add -g @microck/moji

Homebrew

brew tap microck/moji https://github.com/Microck/moji
brew install microck/moji/moji

Confirm that the launcher can find its bundled binary:

moji --version

The command prints the installed release version.

2. Search interactively

Open the home screen:

moji

Type Futura and press enter. You can also jump directly to the same live results:

moji "Futura"

In a terminal, Moji opens its live result interface. Use:

• up and down to move between results
• enter to inspect the selected file
• f to cycle the format filter
• / to filter the current results
• tab to change sorting
• q to exit

Provider statuses change as results arrive. A provider failure does not discard results returned by another provider.

3. Preview a non-interactive choice

Ask Moji to choose a bold face without downloading:

moji get "Futura bold" --dry-run

The output begins with Would download: and lists the selected format, weight, source, size when known, and license hint.

4. Download the result

Run the same command without --dry-run:

moji get "Futura bold"

The default destination is ~/Downloads/moji. A successful download reports its final path.

Before the file reaches that path, Moji:

1. requires HTTPS unless you explicitly allow HTTP;
2. limits redirects and download size;
3. checks the font signature;
4. writes to a temporary file;
5. atomically moves the validated file into place; and
6. deduplicates matching content by SHA-256.

You now have a validated font file and know how to inspect the result before downloading it.

Next steps

• Search and filter results
• Enable authenticated GitHub search
• Automate Moji with JSON