# AthenaOS

By AI. For AI.

AthenaOS is an AI-native Linux development platform built as a thin layer on top of Ubuntu Server LTS or Debian Stable. It starts as a reproducible bootstrap system, developer environment, and CLI, then grows toward WSL, macOS VM, VPS, and future ISO targets.

## What This Repo Contains

- `athena/cli/athena.py` - the Athena CLI entrypoint.
- `scripts/install-core.sh` - installs the core developer toolchain.
- `scripts/setup-shell.sh` - configures shell aliases, banner, and workspace directories.
- `templates/` - starter project templates for generated applications.
- `configs/` - AthenaOS banner and MOTD assets.
- `Dockerfile` - fast feedback environment and base for WSL rootfs export.
- `build-wsl.sh` - builds `dist/athenaos-wsl.tar.gz` for WSL import.
- `lima/athenaos-lima.yaml` - macOS Lima VM profile.

## Quick Start

Run the CLI directly during development:

```bash
python3 athena/cli/athena.py doctor
python3 athena/cli/athena.py new fastapi my-api
```

Install the thin Athena layer on a compatible Ubuntu/Debian host:

```bash
bash scripts/install-core.sh
bash scripts/setup-shell.sh
```

Build a Docker validation image:

```bash
docker build -t athenaos-dev .
docker run -it athenaos-dev athena doctor
```

Build the WSL rootfs:

```bash
./build-wsl.sh
```

Install on Windows:

```powershell
mkdir C:\WSL\AthenaOS
wsl --import AthenaOS C:\WSL\AthenaOS dist\athenaos-wsl.tar.gz --version 2
wsl -d AthenaOS
```

Start the macOS Lima equivalent:

```bash
brew install lima
limactl start --name athenaos lima/athenaos-lima.yaml
./scripts/install-lima-athena.sh athenaos
limactl shell athenaos
athena doctor
```

## Philosophy

AthenaOS should stay modular and testable:

```text
Ubuntu/Debian Base
        ↓
AthenaOS bootstrap scripts
        ↓
Developer tooling
        ↓
AI tooling
        ↓
Athena CLI
        ↓
Docker workflows
        ↓
WSL/macOS/VPS targets
        ↓
Future ISO packaging
```

Small changes should be tested locally before larger environment builds.
