# IWE Init

Initializes the current directory as an IWE project.

## Usage

``` bash
iwe init
```

## What It Creates

Running `iwe init` creates:

```
.iwe/
└── config.toml    # Project configuration
```

The `.iwe/` directory marks the project root and stores configuration files.

## Default Configuration

The generated `config.toml` contains:

``` toml
version = 3

[markdown]
refs_extension = ""
date_format = "%b %d, %Y"
wiki_link_path = "preserve"

[library]
path = ""
date_format = "%Y-%m-%d"

[completion]

[commands]
[commands.default]
run = "claude -p"
timeout_seconds = 120

[actions]
[actions.extract]
type = "extract"
title = "Extract"
link_type = "markdown"
key_template = "{{id}}"

[actions.inline_section]
type = "inline"
title = "Inline section"
inline_type = "section"
keep_target = false

[actions.sort]
type = "sort"
title = "Sort A-Z"
reverse = false

[templates]
[templates.default]
key_template = "{{slug}}"
document_template = "# {{title}}\n\n{{content}}"
```

## Configuration Options

### Library Section

| Option             | Default    | Description                                                   |
| ------------------ | ---------- | ------------------------------------------------------------- |
| `path`             | `""`       | Subdirectory containing markdown files (empty = project root) |
| `date_format`      | `%Y-%m-%d` | Format for dates in document keys                             |
| `default_template` | `null`     | Template name for `iwe new` command                           |


### Markdown Section

| Option               | Default     | Description                                                       |
| -------------------- | ----------- | ----------------------------------------------------------------- |
| `refs_extension`     | `""`        | File extension to append to references (e.g., `.md`)              |
| `date_format`        | `%b %d, %Y` | Format for dates displayed in documents                           |
| `wiki_link_path`     | `preserve`  | How wiki link paths are written: `preserve`, `full`, or `short`   |


### Completion Section

| Option               | Default | Description                                                                       |
| -------------------- | ------- | --------------------------------------------------------------------------------- |
| `link_format`        | `null`  | Link style for completions: `markdown` or `wiki` (overridden by a typed `[`/`[[`) |
| `min_prefix_length`  | `0`     | Characters required in the search query before completions appear                 |
| `trigger_characters` | `["["]` | Characters that open the completion popup in the editor                           |


## Example

``` bash
cd ~/my-notes
iwe init
# Output: Creates .iwe/config.toml

# Verify initialization
ls -la .iwe/
# Output: config.toml
```

## Customization

After initialization, edit `.iwe/config.toml` to:

- Store markdown files in a subdirectory: set `library.path = "docs"`
- Use wiki-style links: set `completion.link_format = "wiki"`
- Change completion trigger characters: set `completion.trigger_characters = ["[", "+"]`
- Define custom templates for document creation
- Configure AI-powered actions with custom commands

## Re-initialization

Running `iwe init` in an already-initialized project is safe - it will not overwrite an existing `config.toml`.
