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

# nut schema

> Manage Coconut schema reference files

# Schema Commands

Manage Coconut schema reference files that define the structure of your proposals, agents, and configuration.

## `nut schema refresh`

Regenerate the reference schema files in `.nut/.schema`.

```bash theme={null}
nut schema refresh
```

This command regenerates the JSON schema files that Coconut uses for validation and autocomplete. Run this after updating Coconut or when schema files become outdated.

**Example:**

```bash theme={null}
nut schema refresh
```

<Tip>
  Schema files help provide autocomplete and validation in editors that support JSON schemas. They're automatically kept in the `.nut/.schema` directory.
</Tip>

## When to Use Schema Refresh

You should refresh schema files when:

* You've updated to a new version of Coconut
* Schema validation errors occur
* Autocomplete isn't working correctly in your editor
* You've manually modified schema files and want to restore defaults

<Note>
  Schema files are typically regenerated automatically, but this command is useful for troubleshooting or after major updates.
</Note>