AGS

▲ 0✓Sign-Off

01. Overview & Architecture 02. Installation & Deployment 03. Documentation & Guide

01. Overview & Architecture

Profile: v3.1.2

Schema validatedSource pinned

Purpose: Scaffolding CLI for Astal: build GTK shells and bars in TypeScript/JSX.
Compatibility: Any distro (Server: WAYLAND)
Desktop Part: Widgets & shells
Window Manager & Theme: Any WM / DE / Other

02. Installation & Deployment

Before you installThis changes your desktop configuration and installs packages. Run it as your normal user, never with sudo: it asks for sudo only where a step needs it (listed below).The guided installer shows its plan first. Files it would replace are kept unless you approve. Everything it copies, clones or appends to in your home folder is backed up and verified first, and --rollback restores it. Packages, sudo changes and the other commands listed under Impact are not undone.

Origingithub.com/Aylur/agsPinned to bbee2f18939f · reviewed in this config file

IntegrityEach release from main builds the installers in GitHub Actions and signs them with a GitHub build attestation. Verify your download against the repository, not this website (Option B, step 2). If it does not verify, don't run it.

ImpactPackages: aylurs-gtk-shell (some from the Arch AUR)

RecoveryGuided: backups in ~/.local/state/0xtsoa/backups/, undo with bash install.sh --rollback.Manual: the steps below only write in the download folder or run listed commands.

Option A: manual installAdvanced

Read the source at the reviewed commit, back up, then run each step yourself.

$git clone https://github.com/Aylur/ags ~/0xtsoa-review/aylur-ags# 1. clone to a review folder

$git -C ~/0xtsoa-review/aylur-ags checkout --detach bbee2f18939f1ec7ff720e717cf305e73635628f# 2. the reviewed commit

Then the steps. Package commands are written for Arch; on other distros use your package manager.

Step-by-step deployment protocol

Step-by-step deployment

1Install aylurs-gtk-shell (AUR)

Shell commands

$yay -S aylurs-gtk-shell # AUR

$# Other distros: see the upstream README

Option B: guided installerRecommended

The same steps as one script for any distro. It shows the plan first, keeps files you already have unless you approve replacing them, and backs up everything it changes in your home folder. Never pipe it into a shell.

$curl -fsSLo install.sh 'https://www.0xtsoa.dev/configs/aylur/ags/install.sh'# 1. download

gh attestation verify install.sh --repo nyharena25/0xTsoa --signer-workflow nyharena25/0xTsoa/.github/workflows/attest-installers.yml

# 2. verify (GitHub CLI 2.49+, signed in)

$less install.sh# 3. read it

$bash install.sh --dry-run# 4. preview: changes nothing

$bash install.sh# 5. install (asks first)

$bash install.sh --rollback# undo the file changes

View script in browserOther options: --force (replace conflicts, backed up first), --yes, --help

03. Documentation & Guide

Source: Aylur/agsRef: bbee2f1893

README.md|GitHub Flavored Markdown

Raw Source ↗

AGS

Scaffolding CLI tool for Astal+Gnim projects. Astal is a set of libraries written in Vala/C that makes writing a Desktop Shell easy. Gnim is a library which introduces JSX to GJS. GJS is a JavaScript runtime built on Firefox's SpiderMonkey JavaScript engine and the GNOME platform libraries, the same runtime GNOME Shell runs on.

Get started

To get started read the wiki.

GitHub Flavored Markdown (github-markdown-css)README snapshot at bbee2f1893