Skip to content

etchebarne/kosmos

Repository files navigation

Kosmos

A code editor where every view is a tab you can place anywhere.

Release License: MIT Stars Issues

Why Kosmos

Most editors dictate where things go. Kosmos lets you treat every view as a tab you can place anywhere, split in any direction, and rearrange freely. Multiple workspaces stay alive in the background so you can context-switch without losing terminals, layouts, or in-progress work.

Platform support

Kosmos only runs on Linux. Windows and macOS are not supported, and support for those platforms is not planned at this time.

Installation

Choose the install method that matches your Linux distribution or workflow.

Quick Install

Use the install script for a distro-agnostic setup:

curl -fsSL https://raw.githubusercontent.com/etchebarne/kosmos/main/scripts/install.sh | sh

The script:

  • Downloads the latest release tarball
  • Installs Kosmos under ~/.local/Kosmos.app/
  • Symlinks kosmos into ~/.local/bin
  • Registers a desktop entry so Kosmos appears in your launcher

Manual Tarball Install

Use this if you already downloaded the release bundle.

Download kosmos-linux-x86_64.tar.gz from the latest release, then run:

KOSMOS_BUNDLE_PATH=./kosmos-linux-x86_64.tar.gz \
    sh <(curl -fsSL https://raw.githubusercontent.com/etchebarne/kosmos/main/scripts/install.sh)

Debian / Ubuntu

Download kosmos_<version>_amd64.deb from the latest release, then:

sudo apt install ./kosmos_<version>_amd64.deb

Fedora / RPM Distros

Download kosmos-<version>-1.x86_64.rpm from the latest release, then:

sudo dnf install ./kosmos-<version>-1.x86_64.rpm

AppImage

Download Kosmos-<version>-x86_64.AppImage from the latest release, then:

chmod +x ./Kosmos-<version>-x86_64.AppImage
./Kosmos-<version>-x86_64.AppImage

Arch Linux (AUR)

Install the pre-built binary:

yay -S kosmos-bin

Or build from source:

yay -S kosmos

Uninstall

Use the uninstall method that matches how you installed Kosmos.

Install Script

curl -fsSL https://raw.githubusercontent.com/etchebarne/kosmos/main/scripts/uninstall.sh | sh

Arch Linux (AUR)

Remove the pre-built package:

sudo pacman -R kosmos-bin

Or remove the source-built package:

sudo pacman -R kosmos

AppImage

Remove the AppImage desktop entry and icon:

./Kosmos-<version>-x86_64.AppImage --uninstall

Then delete the AppImage file itself.

Building from source

Install Rust stable and the GPUI system dependencies for your distro.

System Dependencies

Arch Linux
sudo pacman -S --needed base-devel pkgconf openssl fontconfig \
    libxcb libxkbcommon libxkbcommon-x11 wayland \
    vulkan-icd-loader vulkan-headers
Debian / Ubuntu
sudo apt install build-essential pkg-config libssl-dev libfontconfig-dev \
    libxcb1-dev libxkbcommon-dev libxkbcommon-x11-dev \
    libwayland-dev libvulkan-dev
Fedora
sudo dnf install gcc pkgconf openssl-devel fontconfig-devel \
    libxcb-devel libxkbcommon-devel libxkbcommon-x11-devel \
    wayland-devel vulkan-loader-devel

Run From Source

cargo run --release

License

MIT - see LICENSE.