# entheai

> entheai is a personal, macOS/Apple-Silicon, terminal-native hybrid coding agent written in Rust — a cloud orchestrator plans, then fans out to model-matched sub-agents that build in parallel and merge back verified.

## Overview

- [What is entheai](https://entheai.com/docs/#what-is): entheai is a personal, macOS/Apple‑Silicon, terminal‑native hybrid coding agent written in Rust.
- [Hybrid brain & fan-out](https://entheai.com/docs/#concept): The tiered hybrid brain separates planning from execution.
- [Who it's for](https://entheai.com/docs/#who): Solo developers on Apple Silicon who want an agent that lives in the terminal, respects local compute, and can parallelize large refactors without a cloud bill for every token.

## Getting started

- [Install & build](https://entheai.com/docs/#install): Clone the repo and build a release binary.
- [Configure entheai.toml](https://entheai.com/docs/#configure): entheai reads entheai.toml from the working directory.
- [First run](https://entheai.com/docs/#first-run): Ask entheai to summarize your repo.

## Configuration

- [Providers](https://entheai.com/docs/#providers): entheai speaks to several model backends.
- [Models & ids](https://entheai.com/docs/#models): Every model is referenced with the <provider>/<model> convention.

## Concepts

- [The agent loop](https://entheai.com/docs/#loop): Perceive → plan → act → verify.
- [The tiered router](https://entheai.com/docs/#router): The router matches each unit of work to a model tier by difficulty, cost, and locality — planning to the strongest model, mechanical edits to fast local ones.
- [Fan-out & roles](https://entheai.com/docs/#fanout): Roles include coder, docs, test, and review.
- [Permission gate & YOLO](https://entheai.com/docs/#permissions): By default every side‑effecting tool call asks for approval.
- [Memory namespaces](https://entheai.com/docs/#memory): Compounding memory with auto‑compaction keeps context lean while retaining what matters.
- [Skills · plugins · MCP](https://entheai.com/docs/#extend): Bundle reusable procedures as skills, add capabilities with plugins, and connect external tools over MCP.

## The visual TUI

- [Shader & codebase graph](https://entheai.com/docs/#tui): The TUI renders an animated shader background and can toggle a live 3D graph of your codebase — nodes are modules, edges are dependencies, lit as the agent touches them.
- [Companion & Radio](https://entheai.com/docs/#companion-radio): Two small extras that run alongside the terminal session: a desktop companion window and an in-TUI music player.

## Architecture

- [Crate map & system](https://entheai.com/docs/#arch): entheai is a Rust workspace.

## Roadmap

- [Roadmap & design docs](https://entheai.com/docs/#roadmap): Longer‑form specs and plans live alongside the source.