CRYSTAL(1)       Crystal Compiler Command Line Reference Guide      CRYSTAL(1)

<?><?><?> (NAME)
       crystal - <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       (Crystal)

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       crystal <?><?><?><?><?> [<?><?><?><?><?><?><?><?>]
       <?><?><?><?>_<?><?><?><?><?><?> -- [<?><?><?><?><?><?><?><?><?><?>]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?><?> (Crystal) <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> (Statically type-checked) <?><?><?>. <?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> (Ruby) <?> <?><?><?><?><?><?> <?><?><?><?> C
       <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?> <?><?><?>.

<?><?><?><?> <?><?><?><?><?><?><?> (USAGE)
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?> <?><?><?><?>:

           crystal some_program.cr

       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> .cr <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       run <?><?><?><?><?><?><?> <?><?><?><?>:

           crystal run some_program.cr

       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> build <?><?><?><?><?><?><?> <?><?><?><?>:

           crystal build some_program.cr

       <?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?> "some_program" <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>. <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?> --release <?><?><?><?><?><?><?> <?><?><?><?>:

           crystal build --release some_program.cr

       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?> --release <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> crystal
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?>.

<?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (CRYSTAL COMMANDS)
   <?><?><?><?><?><?><?> <?><?><?><?> (Main commands)
       crystal-init(1)
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?>

       crystal-build(1)
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?>

       crystal-docs(1)
           <?><?><?><?><?> <?><?><?><?><?><?><?> API <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?>

       crystal-env(1)
           <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>

       crystal-eval(1)
           <?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?>

       crystal-play(1)
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>
           <?><?><?><?> (Playground) <?><?><?><?><?><?><?>

       crystal-run(1)
           <?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?>

       crystal-spec(1)
           <?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> (Spec) <?><?><?><?><?><?><?>

       crystal-clear_cache
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> (<?><?><?><?> <?><?> 'CRYSTAL_CACHE_DIR').

       crystal-help
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> --help <?><?> -h
           <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       crystal-version
           <?><?><?><?><?> <?><?><?><?>.

   <?><?><?><?><?><?><?> (Tools)
       crystal-tool-context
           <?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?> (Context)
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?>

       crystal-tool-dependencies(1)
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?>

       crystal-tool-expand
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?> <?><?> <?><?>

       crystal-tool-flags
           <?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
           'flag?'

       crystal-tool-format(1)
           <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>

       crystal-tool-hierarchy
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> (Types) <?><?> <?><?><?><?>. <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?>
           <?><?><?><?><?><?><?><?> (Struct) <?><?> <?><?><?><?><?> <?><?><?>
           <?> <?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> -e <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           (Regex) <?><?><?><?><?> <?><?><?>.

       crystal-tool-implementations
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>.
           <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> --cursor <?><?><?><?><?><?><?>
           <?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> file:line:column
           <?><?><?>.

       crystal-tool-macro_code_coverage
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?>.

       crystal-tool-types
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?>.

       crystal-tool-unreachable(1)
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>

<?><?><?><?><?><?><?><?><?><?><?><?><?> (OPTIMIZATIONS)
       <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> (Codegen) <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>) <?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       (<?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>) <?><?><?>.

       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> --release <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?> <?><?><?><?><?><?> --single-module <?><?> <?><?><?>
       <?><?> <?><?> <?><?><?><?>.

       -O0
           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?><?><?>)

       -O1
           <?><?><?><?><?><?><?><?><?><?> <?><?>

       -O2
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>

       -O3
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>

       -Os
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>

       -Oz
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>

<?><?><?><?><?><?><?><?> <?><?><?><?><?> (ENVIRONMENT VARIABLES)
   CRYSTAL_CACHE_DIR
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       'crystal build' <?><?> 'crystal run' <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

   CRYSTAL_EXEC_PATH
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       crystal <?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

   CRYSTAL_LIBRARY_PATH
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?><?>) <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> ":" <?><?> <?><?> <?><?><?> <?><?><?>.
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> -L <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.

       <?><?><?><?><?> '$ORIGIN' <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?>. <?><?> <?><?><?><?><?> <?><?><?><?><?>
       '$ORIGIN/../lib/crystal' <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> (<?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>)
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?>.

   CRYSTAL_PATH
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> ":" <?><?>
       <?><?> <?><?><?> <?><?><?>.

       <?><?><?><?><?> '$ORIGIN' <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?>. <?><?> <?><?><?><?><?> <?><?><?><?><?>
       '$ORIGIN/../share/crystal/src' <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> (<?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>)
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?>.

   CRYSTAL_OPTS
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>.
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> 'CRYSTAL_OPTS=--debug make
       build'.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       shards(1)

        <https://crystal-lang.org> <?><?><?><?><?><?><?> <?><?><?><?>.

        <https://github.com/crystal-lang/crystal> <?><?><?><?> <?><?><?><?>.

crystal 1.21.0                    2026-07-23                        CRYSTAL(1)