# configure

Interactive configuration wizard

Canonical URL: https://docs.paradoc.dev/cli/commands/configure/

Interactive configuration wizard for the Paradoc CLI.

## Usage

```bash
paradoc configure
paradoc config
```

## Description

Walks you through each CLI setting interactively. Press Enter to keep the current value, or select a new one. Settings are saved to `~/.paradoc/config.json`.

The wizard configures:

1. **Output format** - How artifacts are saved when downloaded (`json`, `yaml`, `typed`, `ts`)
2. **Artifacts directory** - Where downloaded artifacts are stored (relative to project root)
3. **Cache duration** - How long to cache registry data before fetching fresh
4. **Telemetry** - Whether the CLI sends anonymous usage data

There is no registry setting. An artifact reference always names its namespace, as in `@acme/w9`. The built-in `@paradoc` namespace needs no configuration; add any other with [`paradoc registry add`](/cli/commands/registry/add).

## Examples

```bash
paradoc configure
```

```
Paradoc CLI Configuration
Walk through each setting to configure the CLI.
Press Enter to keep the current value, or select a new one.

──────────────────────────────────────────────────

1. Output Format
   How artifacts are saved when downloaded from a registry.

? Output format (current: json)
  ❯ JSON — Portable, widely supported
    YAML — Human-readable, easy to edit
    Typed — JSON + TypeScript declarations (.d.ts)
    TypeScript — Full TS modules with embedded types
```

## See also

* [reset](/cli/commands/reset) - Reset CLI to factory defaults
* [cache](/cli/commands/cache) - Manage registry cache