> ## Documentation Index
> Fetch the complete documentation index at: https://docs.valiqor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> CLI commands for project initialization, viewing settings, updating config, testing connectivity, and uploading files.

## config

Project configuration — interactive setup, view, or update settings.

Running `valiqor config` with no subcommand launches the interactive wizard, which creates a `.valiqorrc` file in the current directory.

```bash theme={"system"}
valiqor config
```

The wizard prompts for:

| Setting        | Description                                          |
| -------------- | ---------------------------------------------------- |
| `project_name` | Name for your Valiqor project                        |
| `trace_dir`    | Directory for trace output files                     |
| `scan_dir`     | Directory for scan output files                      |
| `environment`  | Environment label (e.g. `development`, `production`) |

After saving, the CLI creates the output directories and shows next steps based on your auth status and installed modules.

Use a subcommand to view or update settings non-interactively.

```bash theme={"system"}
valiqor config <show|set>
```

### config show

Display current authentication info and local project settings.

```bash theme={"system"}
valiqor config show [flags]
```

| Flag     | Type   | Default | Description    |
| -------- | ------ | ------- | -------------- |
| `--json` | `flag` | `false` | Output as JSON |

```bash theme={"system"}
# Human-readable output
valiqor config show

# Machine-readable output
valiqor config show --json
```

Shows API key source (global/local), email, all `.valiqorrc` settings, and the config file path.

### config set

Update one or more settings non-interactively.

```bash theme={"system"}
valiqor config set <key=value> [key=value ...]
```

**Allowed keys:** `project_name`, `api_key`, `trace_dir`, `scan_dir`, `environment`, `valiqor_intelligence`, `debug`, `openai_api_key`

```bash theme={"system"}
# Set multiple values at once
valiqor config set project_name=my-app environment=production

# Enable debug mode
valiqor config set debug=true
```

Boolean keys (`valiqor_intelligence`, `debug`) accept `true`, `1`, `yes` as truthy values. If `trace_dir` or `scan_dir` change, the CLI creates the new directories automatically.

***

## status

Show a comprehensive status overview.

```bash theme={"system"}
valiqor status
```

Displays:

* **Authentication** — credential source (global vs local), email
* **Local config** — project name, environment, directories
* **Cloud connection** — API reachability
* **Files** — trace and scan file counts in configured directories
* **Modules** — availability of Trace, Scanner, Eval, Security, Failure Analysis
* **Version** — installed SDK version

***

## test

Validate that your project is correctly configured and can reach the Valiqor backend.

```bash theme={"system"}
valiqor test
```

Checks:

1. Trace and scan directories exist and are writable
2. API key is valid (local or global)
3. Backend API is reachable
4. Required modules are installed
5. Provider packages detected (openai, anthropic, langchain, ollama, agno)

Reports errors and warnings with actionable messages.

***

## upload

Upload trace and scan files to the Valiqor backend.

```bash theme={"system"}
valiqor upload [path] [flags]
```

| Flag             | Type                   | Default         | Description                                   |
| ---------------- | ---------------------- | --------------- | --------------------------------------------- |
| `path`           | `positional`           | configured dirs | Path to a file or directory to upload         |
| `-t` / `--type`  | `trace \| scan \| all` | `all`           | Type of files to upload                       |
| `--endpoint`     | `string`               | —               | Custom backend API endpoint URL               |
| `--api-key`      | `string`               | —               | API key override                              |
| `--delete-after` | `flag`                 | `false`         | Delete local files after successful upload    |
| `--dry-run`      | `flag`                 | `false`         | Show what would be uploaded without uploading |

### Examples

```bash theme={"system"}
# Upload everything from configured directories
valiqor upload

# Upload a specific trace file
valiqor upload ./traces/run_001.json --type trace

# Preview what would be uploaded
valiqor upload --dry-run

# Upload and clean up local files
valiqor upload --delete-after
```

<Info>
  Without an explicit `path`, the CLI uploads from the directories configured in `.valiqorrc` (`trace_dir` and `scan_dir`).
</Info>