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.
.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.