aura init

Initialize a default Aura configuration.

Syntax

aura init [flags]

Description

Extracts the embedded default configuration to the specified directory. This scaffolds the complete .aura/config/ structure with all default agents, modes, providers, features, prompts, and sandbox settings.

Flags

Flag	Short	Default	Description
--dir	-d	.aura	Output directory for configuration

Directory Created

.aura/config/
├── agents/              # Agent definitions
│   └── features/        # Hidden feature agents (compaction, embeddings, etc.)
├── commands/            # Custom slash command definitions
├── features/            # Feature configs (compaction, embeddings, etc.)
├── hooks/               # Tool hook definitions
├── lsp/                 # LSP server configs
├── mcp/                 # MCP server definitions
├── modes/               # Mode definitions (Ask, Edit, Plan)
├── plugins/             # Go plugins (recursive discovery)
├── prompts/
│   └── system/          # System prompts (Agentic, Chat, Lite)
├── providers/           # Provider configs
├── sandbox/             # Landlock sandbox config
├── skills/              # LLM-invocable skill definitions
├── tasks/               # Scheduled task definitions
└── tools/               # Optional tool text overrides

Examples

# Initialize with default path
aura init

# Initialize to custom directory
aura init -d my-config

Note: If the output directory already exists, existing files are not overwritten. See Configuration for details on each config section.