> ## 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 Directory

> Understanding the .nut directory structure

# The `.nut` Directory

When you run `nut init`, a `.nut` directory is created at the root of your repository. This directory contains all of Coconut's local configuration, skills, jobs, knowledge, and more.

```
.nut/
├── .gitignore
├── config.json
├── skills/
├── mcp/
├── jobs/
├── knowledge/
├── tasks/
├── resources/
├── context/
└── chats/
```

## `.gitignore`

Controls which files inside `.nut` are tracked by git and which are ignored. By default, ephemeral or sensitive data (such as chat history and generated resources) is excluded from version control.

## `config.json`

The main configuration file for your Coconut instance. Contains settings such as the instance ID, linked organization, model preferences, and feature flags.

## `/skills`

Contains AI skill definitions for your project. Each skill defines a specialized agent behavior — its instructions, model configuration, and tool access. Skills can be created locally or installed from the skill registry.

## `/mcp`

Stores Model Context Protocol (MCP) server configurations. MCP servers extend your agents' capabilities by providing additional tools and data sources.

## `/jobs`

Contains job definitions for scheduled and automated tasks. Jobs allow you to run agents on a recurring basis or trigger them based on events.

## `/knowledge`

Holds knowledge base documents that provide your agents with project-specific context. These documents are indexed and available for retrieval during agent interactions.

## `/tasks`

Contains local task (change proposal) data and metadata. Tasks represent units of work that agents can plan, implement, and track within your project.

## `/resources`

Stores generated resources such as images, audio, and video files created through the `nut resource` command or by agents during task execution.

## `/context`

Contains context documents that shape agent behavior. Context files provide project-level, role-level, or task-level instructions that agents reference when working on tasks.

## `/chats`

Stores chat session history from interactive agent conversations. Chat logs are typically excluded from version control via `.gitignore`.