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

> Initialize Coconut in your repository

# `nut init`

Initialize Coconut in the current repository.

```bash theme={null}
nut init [options]
```

## Overview

The `init` command sets up the necessary configuration files and directory structure for Coconut in your project. This is the first command you should run when starting to use Coconut in a new repository.

## What It Does

When you run `nut init`, Coconut will:

* Create a `.nut` directory in your repository root
* Generate default configuration files
* Set up the schema reference files
* Initialize the proposal tracking system
* Configure the local Coconut instance

## Usage

**Basic initialization:**

```bash theme={null}
nut init
```

**Options:**

* `--name <name>` - Repository name
* `--description <description>` - Repository description
* `--id <id>` - Coconut instance ID (for non-interactive use)
* `--force` - Force initialization even if already initialized

**Examples:**

```bash theme={null}
# Interactive initialization (prompts for details)
nut init

# Initialize with specific name
nut init --name "My Project"

# Initialize with name and description
nut init --name "My Project" --description "A web application"

# Force re-initialization
nut init --force

# Non-interactive initialization with instance ID
nut init --id coconut-123456 --name "Project" --description "Description"
```

## Next Steps

After initializing Coconut, you can:

<CardGroup cols={2}>
  <Card title="Create a task" icon="lightbulb" href="/cli/task">
    Start your first task with `nut task create`
  </Card>

  <Card title="Launch web interface" icon="globe" href="/cli/serve">
    Open Coconut Studio with `nut serve`
  </Card>

  <Card title="Configure skills" icon="wand-magic-sparkles" href="/cli/skill">
    Set up AI skills for your project
  </Card>

  <Card title="Set API keys" icon="key" href="/cli/config">
    Configure API keys with `nut config`
  </Card>
</CardGroup>

<Tip>
  Run `nut init` in the root directory of your repository for best results.
</Tip>