How aylur/ags works
AGS is a scaffolding CLI for Astal/Gnim desktop-shell projects, alongside a GJS runtime library for GTK3/GTK4 applications. The documented starter flow is to use the CLI to scaffold a project and then run an application; command-level links are limited because the supplied excerpts do not show those implementations. The runtime excerpts show app startup, D-Bus control, compatibility patches, and process-backed polling. Other library exports are represented as capabilities without inferred call paths.
Main entry points: overrides.ts Astal Compatibility · dbus.ts App D-Bus Service · gtk3/app.ts GTK3 App Runtime · gtk4/app.ts GTK4 App Runtime
Components 25
Scaffolding CLI
- CLI Entrypoint
cli/main.go - Command Framework
cli/cmd/root.go - Project Init
cli/cmd/init.go - Project Bundling
cli/cmd/bundle.go - Run Projects
cli/cmd/run.go - Instance Controls
cli/cmd/list.go - Instance Requests
cli/cmd/request.go - Inspect Instance
cli/cmd/inspect.go
Starter Projects
- GTK3 Starter
cli/data/gtk3/app.ts - GTK3 Bar
cli/data/gtk3/Bar.tsx - GTK4 Starter
cli/data/gtk4/app.ts - GTK4 Bar
cli/data/gtk4/Bar.tsx
GTK Applications
- GTK3 App Runtime
lib/gtk3/app.ts - GTK4 App Runtime
lib/gtk4/app.ts - App D-Bus Service
lib/app/dbus.ts - App Management API
lib/app/index.ts - GTK3 JSX Runtime
lib/gtk3/jsx-runtime.ts - GTK4 JSX Runtime
lib/gtk4/jsx-runtime.ts
Runtime Utilities
- Astal Compatibility
lib/overrides.ts - Process API
lib/process.ts - Timers And Polling
lib/time.ts - File Utilities
lib/file.ts - Other Runtime Exports
lib/fetch.ts
Other components
- Project Developer
- Astal GI Extensions
Connections 9
- Project Developer → CLI Entrypoint: uses
README.md - CLI Entrypoint → Command Framework: initializes and executes
cli/main.go - GTK3 App Runtime → App D-Bus Service: constructs service
lib/gtk3/app.ts - GTK4 App Runtime → App D-Bus Service: constructs service
lib/gtk4/app.ts - App Management API → App D-Bus Service: proxies calls
lib/app/index.ts - GTK3 App Runtime → Astal Compatibility: imports patches
lib/gtk3/app.ts - GTK4 App Runtime → Astal Compatibility: imports patches
lib/gtk4/app.ts - Timers And Polling → Process API: executes commands
lib/time.ts - Astal Compatibility → Astal GI Extensions: patches when available
lib/overrides.ts