Architecture

The crates, and which way the dependencies point.

luxe/
├─ crates/
│  ├─ luxe-core/       Engine: types, session, context, agent loop, compaction
│  ├─ luxe-providers/  Provider adapters: openai_compat, anthropic; model catalog
│  ├─ luxe-tools/      Tool implementations: read/write/edit/bash/grep/glob/web/question/skill/git/task/todo
│  ├─ luxe-lsp/        Generic LSP client
│  ├─ luxe-tui/        Ratatui front-end
│  └─ luxe-cli/        Binary: config, wiring, launches tui|headless
├─ docs/                Security, hooks, and debugging guides
└─ AGENTS.md            Repository invariants + contributor guide

Dependency direction is inward to luxe-core. core has no UI or HTTP deps and defines the Provider, Tool, and Hook traits.