HaltOS

0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000

v1.2 SIGKILL

A Claude Code workstation OS for your VPS. One command turns a blank Ubuntu server into a monochrome KDE Plasma desktop you reach over RDP, with claudegrid to run several Claude Code agents side by side.

curl -fsSL https://raw.githubusercontent.com/halitsever/haltos/main/bootstrap.sh | sudo bash
claudegrid on HaltOS: four Claude Code agents in a two by two grid, each answering a question about the HaltOS repository
claudegrid running four Claude Code agents side by side, each on its own task.

HaltOS in 30 seconds

From the first boot line to four Claude Code agents working side by side.

What's inside

Everything HaltOS changes, listed the way your server would list it.

systemctl list-units 'haltos-*' claude-code-vps

UnitActiveDescription
haltos-identityactiveos-release, lsb_release and the About page say HaltOS 1.2 (SIGKILL). The ID stays ubuntu, so apt and PPAs keep working.
haltos-desktopactiveMonochrome Plasma colour scheme, JetBrains Mono everywhere, a translucent floating top bar and flat titlebars.
haltos-widgetsactiveA Kvantum theme with outline buttons, quiet inputs, rounded menus, tabs and thin scrollbars that hide themselves.
haltos-gtkactiveGTK and libadwaita apps pick up the same palette, with white as the primary colour.
haltos-terminalactiveA Konsole profile, a two-line prompt with the git branch and exit code, and fastfetch with the HALTOS banner.
haltos-bootactiveA splash screen with a scrolling boot log, an SDDM login card and a Plymouth splash.
haltos-motdactiveAn SSH banner with uptime, load, memory, disk and pending updates, without Ubuntu's ads.
claudegridactiveOpens a grid of Claude Code agents in one window, with a prompt, model and git worktree per pane. See claudegrid.
haltos-editoractiveThe latest VS Code from Microsoft's apt repository, so apt upgrade keeps it current.
claude-code-vpsactivePlasma over RDP, key-only SSH, ufw, Docker, Claude Code and claudegrid. Its own project, and it runs fine without HaltOS.

10 units listed.

Every surface, one palette

From the boot splash to a GNOME calculator, nothing keeps its stock colours.

The HaltOS desktop: HALTOS in ASCII block letters on a black wallpaper with a floating panel and a dot start button
The desktop right after the first RDP login.

What the command does

Run it as root on a fresh Ubuntu 25.04 or newer server. Options after bash -s -- go to claude-code-vps, for example --user dev --yes.

  1. Checks for Plasma 6

    Before installing anything. On Ubuntu 24.04, which ships Plasma 5, it stops and says why.

  2. Sets up the workstation

    claude-code-vps adds your sudo user, key-only SSH, ufw, Plasma over RDP on port 53389, Docker and Claude Code.

  3. Gives the system its name

    HaltOS identity files, login banner, Kvantum, the SDDM and Plymouth themes, and defaults for new users.

  4. Dresses your desktop

    Your user gets the theme right away. The panel and wallpaper finish on your first RDP login.

# update both layers later

sudo claude-vps update && sudo haltos update

# put Ubuntu back the way it was

haltos undo-user && sudo haltos undo-system

Why the name

HALTOS(7)HaltOS ManualHALTOS(7)

NAME

haltos - an operating system named after the command that stops one

DESCRIPTION

halt is the oldest way to stop a Unix machine. HaltOS takes the word and turns it around: a desktop that lives on a server that never sleeps, so Claude Code keeps working while you are away. Its wallpaper says it plainly: shutdown -h never.

Take the i out of Halit, the name of the person who made it, and you get halt.

CODENAME

SIGKILL, the one signal a process cannot catch or ignore. The first release is the one that ends the half-measures.

SEE ALSO

halt(8), shutdown(8), signal(7), claude-code-vps

Questions

Is HaltOS a Linux distribution?

No. It is a layer on top of Ubuntu. Packages and updates still come from Ubuntu, and /etc/os-release keeps ID=ubuntu so apt, PPAs and vendor install scripts keep working. HaltOS changes how the system looks and introduces itself.

Which Ubuntu releases does it support?

Ubuntu 25.04 or newer, because HaltOS needs KDE Plasma 6. Ubuntu 24.04 ships Plasma 5, and the installer stops before changing anything there.

Do I need claude-code-vps?

The one-command install includes it. claude-code-vps sets up the server and keeps your config in sync from a git repository, HaltOS owns the look. claude-code-vps also works on its own, and HaltOS keeps its theme files out of your synced dotfiles.

Will a claude-vps sync undo the theme?

No. HaltOS lists the files it owns in claude-vps's local-only list, so a sync leaves them alone and a publish never pushes them into your public dotfiles.

How do I remove it?

haltos undo-user restores the KDE config saved before the first install. sudo haltos undo-system restores Ubuntu's identity files, login banner and defaults.