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

# JSON output

> Parse Jolter machine output for inventory, diagnostics, plugins, and CI setup.

Use JSON modes for automation. Human wording, progress messages, colors, and spacing are not parsing contracts.

## Inventory

```bash theme={null}
jolter list --json
```

Shape:

```json theme={null}
{
  "runtimes": [
    {
      "active": true,
      "kind": "node",
      "path": "/home/user/.jolter/runtimes/node/24.5.0",
      "ready": true,
      "version": "24.5.0"
    }
  ],
  "tools": [
    {
      "active": true,
      "kind": "pnpm",
      "path": "/home/user/.jolter/tools/pnpm/10.12.1",
      "ready": true,
      "version": "10.12.1"
    }
  ],
  "pluginTools": [],
  "plugins": []
}
```

Consumers should identify records by fields rather than array position.

## Doctor

```bash theme={null}
jolter doctor --json
```

Shape:

```json theme={null}
{
  "healthy": true,
  "checks": [
    {
      "name": "storage",
      "status": "pass",
      "message": "using /home/user/.jolter"
    }
  ]
}
```

`status` is `pass`, `warning`, or `fail`. A check may include `remediation`. `healthy` is false only when at least one check fails.

## CI setup

```bash theme={null}
jolter setup-ci --json
```

Shape:

```json theme={null}
{
  "provider": "github-actions",
  "runtime": {
    "kind": "node",
    "version": "24.5.0",
    "path": "/home/user/.jolter/runtimes/node/24.5.0"
  },
  "tools": [
    {
      "kind": "pnpm",
      "version": "10.12.1",
      "path": "/home/user/.jolter/tools/pnpm/10.12.1"
    }
  ],
  "pluginTools": [
    {
      "name": "eslint",
      "provider": "@eslint/eslint",
      "version": "8.57.0",
      "path": "/home/user/.jolter/plugin-tools/@eslint/eslint/eslint/8.57.0"
    }
  ],
  "plugins": [
    {
      "name": "@eslint/eslint",
      "version": "1.0.0",
      "path": "/home/user/.jolter/plugins/@eslint/eslint/1.0.0"
    }
  ],
  "shims": "/home/user/.jolter/shims",
  "cache": "/home/user/.jolter/cache"
}
```

Provider values currently include `github-actions`, `gitlab-ci`, `circleci`, `azure-pipelines`, `buildkite`, and `generic`.

## Plugin inventory

```bash theme={null}
jolter plugin list --json
```

Shape:

```json theme={null}
{
  "plugins": [
    {
      "name": "@eslint/eslint",
      "requestedName": "eslint",
      "version": "1.0.0",
      "path": "/home/user/.jolter/plugins/@eslint/eslint/1.0.0",
      "commands": ["eslint"]
    }
  ]
}
```

## Stream contract

* Standard output contains final tables, instructions, JSON, and generated completion scripts.
* Standard error contains progress events and failures.
* JSON modes keep standard output free from decorative progress.

Use:

```bash theme={null}
jolter setup-ci --json --no-color > jolter.json
```

Avoid:

```bash theme={null}
jolter setup-ci --json > jolter.json 2>&1
```


## Related topics

- [GitLab CI](/automation/gitlab-ci.md)
- [Troubleshooting](/operations/troubleshooting.md)
- [Release operations](/maintainers/releasing.md)
- [CI automation](/automation/ci.md)