AI Linux distribution · v0.3.6 public preview

AthenaOS

The AI Linux distribution for developers who build faster with Codex, Claude Code, and Docker.

Install in WSL Install on macOS Preview desktop Explore features
No Microsoft Store macOS Lima VM APT updates Docker-first Agent-ready
athena — zsh — 80×24
AI Agents3 active
Codex
running
Claude Code
indexing
athena-cli
ready
Dockercompose up
demo-apihealthy
postgreshealthy
port:8000 → free
Projectfastapi
self-testpassed
releasestable
Installable today via WSL + macOS Lima
.deb packages + live APT repo
Built for AI-agent workflows
Capabilities

An environment built to ship web apps

Not a theme. A distribution with a CLI, project templates, an APT server, self-test tooling, and an environment tuned for coding with AI agents.

Athena CLI

A terminal that thinks in projects

Self-test your install, scaffold a FastAPI service, and check your version — all from one CLI designed for AI-first developers.

athena new
athena self-test
athena version
Classic Linux vs AthenaOS

Same Linux you trust, tuned for AI builders

AthenaOS starts from a solid Linux base and adds the layer that web developers and AI agents actually need on day one.

Classic Linux

baseline

AthenaOS

+ AI layer
Built for AI developers

Designed for coding with multiple agents

AthenaOS keeps project context in one place so Codex, Claude Code, and your own scripts work from the same source of truth.

Shared project context

Every agent reads the same templates, env, and config — no drift between tools.

Agent-ready workflows

Codex and Claude Code drop into a clean, predictable environment from first boot.

One CLI, many agents

Scaffold, test, and run from athena — built to be driven by humans and agents alike.

Install & update

Ship it like a real product

Import locally through WSL today, then keep current through the AthenaOS APT repository — the same way you update any package.

Available now

Local WSL installation

Install AthenaOS without the Microsoft Store on Windows through WSL, or run it on macOS as a lightweight Lima VM.

WSL importDownload the latest public rootfs tarball and import it into WSL.
Local setupAn AI Linux distro you can test locally today.
Ready-to-useCLI, templates, shell branding, and Docker-first tooling ready from first boot.
Install on macOS Desktop demo Install guide
Install in WSL powershell
# PowerShell: install AthenaOS in WSL
irm https://apt.athena-os.org/install-wsl.ps1 | iex

# Open AthenaOS and verify
wsl -d AthenaOS
athena version
athena self-test
APT source & update bash
# Linux/WSL: install or upgrade AthenaOS CLI
curl -fsSL https://apt.athena-os.org/install.sh | bash

# Then verify the install
athena version
athena self-test

# Manual APT setup is available in /install/
Live repository

AthenaOS APT server

Updates arrive through sudo apt update. New versions ship through a signed APT repository — the public HTTPS domain at apt.athena-os.org.

Signed packagesGPG-keyed archive keyring for verified upgrades.
Standard toolingUpdate like any other package — no custom installer.
Local → public DNSPublic HTTPS repo available now.
A real distribution in progress

Shipping in stages, not someday

AthenaOS is a rapidly evolving AI Linux distribution. Here's exactly where it is — and where it's going.

Build, generate, test,
Dockerize, and ship.

AthenaOS is the AI Linux distribution that treats your dev environment like a real product.

PS> irm https://apt.athena-os.org/install-wsl.ps1 | iex
Install in WSL Install on macOS Preview desktop Explore features