finds.dev

Aylur/ags

Scaffolding CLI for Astal+Gnim

View on GitHubHomepage ↗

★ 3,113TypeScriptGPL-3.0updated Apr 2026

// the take

AGS is the scaffolding CLI for building custom Linux desktop shells (bars, launchers, notification popups) on top of Astal and Gnim — you get a Go-built CLI that generates a GTK3 or GTK4 TypeScript project, and a GJS runtime that renders it with JSX. It's for people on Wayland (or X11) who want to build their own panel/bar instead of using a pre-made one like Waybar.

Writing widgets in JSX/TSX against real GTK through Astal's Vala/C bindings means you get native GTK rendering and GObject signal handling instead of an Electron wrapper. The CLI itself is a compiled Go binary (fast startup, no runtime deps) while the generated project is TypeScript bundled with esbuild, so you get type checking and a fast dev loop without shipping a JS toolchain into the final app. Shipping both GTK3 and GTK4 templates plus a Nix flake/devshell lowers the bar for people who want a reproducible NixOS setup, which is a big chunk of this project's actual user base.

This only matters if you're already deep in the Wayland ricing/dotfiles scene — it has zero use outside building a custom GTK layer-shell shell, so the 3k stars overstate how broadly applicable it is. The README tells you almost nothing; all real documentation lives on an external wiki/docs site, so you can't evaluate or debug from the repo alone. You're coupled to two other actively-moving dependencies (Astal and Gnim) that live in separate repos, so a breaking change upstream can break your shell with no local source to patch against. Anything that goes wrong below the JSX layer means debugging GJS/SpiderMonkey interop with Vala-generated GObject bindings, which is a much rougher debugging experience than a typical TypeScript stack trace.

We read the README, the directory tree and a key source file in November 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
3,113
Forks
149
Language
TypeScript
License
GPL-3.0
Last commit
8 Apr 2026

// nearby

If ags isn't quite it.

All repos →