Configuration

Configure ÆtherLight to match your workflow.

Project Configuration

Create a lumina.config.json in your project root for project-specific settings:

{
  "project": {
    "name": "my-app",
    "framework": "nextjs",
    "language": "typescript"
  },
  "context": {
    "include": ["src/**/*.ts", "src/**/*.tsx"],
    "exclude": ["**/*.test.ts", "node_modules/**"]
  },
  "sprint": {
    "defaultFile": "ACTIVE_SPRINT.toml"
  }
}

Sprint Configuration

The analyzer looks for sprint files in your project. Default settings:

sprint.defaultFilestring

Name of the active sprint file.

Default: ACTIVE_SPRINT.toml

context.includearray

Glob patterns for files to analyze.

Default: ["src/**/*"]

context.excludearray

Glob patterns for files to ignore.

Default: ["node_modules/**", "**/*.test.*"]

CLAUDE.md Integration

The analyzer reads your project's CLAUDE.md file to understand project conventions:

# .claude/CLAUDE.md

## Project Conventions

- Use conventional commits
- All functions must have JSDoc comments
- No default exports (use named exports)

## Protected Patterns

These patterns should not be modified:
- Authentication flow in src/auth/
- Payment processing in src/payments/

## Testing

- Run `npm test` before committing
- Minimum 80% coverage for new code

These conventions can be referenced in your sprint context and task descriptions.

Environment Variables

Optional environment variables for advanced configuration:

Variable	Description
`AETHERLIGHT_DEBUG`	Enable debug logging (true/false)

VS Code Extension Settings

Configure the ÆtherLight extension in VS Code settings:

aetherlight.voiceActivationKey

Keyboard shortcut to activate voice (default: backtick `)

aetherlight.defaultSprintFile

Default sprint file name (default: ACTIVE_SPRINT.toml)