---
title: codex cli namespace
description: Build a documentation portal over multiple independent documentation sets, each with its own navigation. Clone all repositories and build the portal in...
url: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/2927/cli/codex
products:
  - Elastic Docs Builder
---

# codex cli namespace
```bash
docs-builder codex --help
```

Build a documentation portal over multiple independent documentation sets, each with its own navigation.

## Running without a subcommand

Clone all repositories and build the portal in one step.
```bash
docs-builder codex __argh_root <config> [options]
```


### Arguments

<definitions>
  <definition term="<config> string required">
    Path to the codex.yml configuration file.
    **Constraints:** symbolic links not allowed, must exist, extensions: yml, yaml, supports `~` home expansion
  </definition>
</definitions>


### Options

<definitions>
  <definition term="--[no-]strict">
    Treat warnings as errors.
    **Default:** `false`
  </definition>
  <definition term="--[no-]fetch-latest">
    Fetch the HEAD of each branch instead of the pinned ref.
    **Default:** `false`
  </definition>
  <definition term="--[no-]assume-cloned">
    Skip cloning; assume repositories are already on disk.
    **Default:** `false`
  </definition>
  <definition term="--output string">
    Output directory for the built portal. Defaults to .artifacts/codex/.
    **Constraints:** symbolic links not allowed, supports `~` home expansion
  </definition>
  <definition term="--[no-]serve">
    Serve the portal on port 4000 after a successful build.
    **Default:** `false`
  </definition>
  <definition term="-l --log-level enum">
    Minimum log level.
    **Values:** trace, debug, information, warning, error, critical, none
    **Default:** `information`
  </definition>
  <definition term="-c --config-source enum">
    Override the configuration source: local, remote
    **Values:** local, remote, embedded
  </definition>
  <definition term="--[no-]skip-private-repositories">
    Skip cloning private repositories
  </definition>
</definitions>


## Commands

<page-card>
  Build the portal from previously cloned repositories.
</page-card>

<page-card>
  Clone all repositories listed in the codex configuration.
</page-card>

<page-card>
  Index the built portal documentation into Elasticsearch.
</page-card>

<page-card>
  Serve the built portal at http://localhost:4000.
</page-card>

<page-card>
  Push the codex redirects mapping to CloudFront's KeyValueStore.
</page-card>