omagem 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 2344de2cc3f80a70f3d4b6a11ebb165bee0889404128750aa48ea8ee405b2b4f
+  data.tar.gz: ccd3fc5c8bd1520787c27fd15936ffc289de0efd9e3451abb73554c11d6cc4c0
+SHA512:
+  metadata.gz: e4fff8c4af197d669db31d245cf82309ff5ceccf96073a94d6892d333f9feb10b25efdfff9b26fceb42e55163bb0427b6977b8db8c69bf69058d7a6152c61f9f
+  data.tar.gz: a5a0e991ac167211d827f38d5734a1fde76f3c37a0405749202ab94d788d24b906b3b9a74bb6edecf4feaecfd3b2c9e0cc57d821f7c965a3431561df8ccfd1c3

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 azzen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,211 @@
+# Omarchy
+
+[![CI](https://github.com/azzenabidi/OmaGem/actions/workflows/ci.yml/badge.svg)](https://github.com/azzenabidi/OmaGem/actions/workflows/ci.yml)
+[![Gem Version](https://img.shields.io/gem/v/omagem)](https://rubygems.org/gems/omagem)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+A small Ruby DSL for configuring and managing [Omarchy](https://omarchy.org/)
+Linux systems: themes, backgrounds, packages, services, the shell bar,
+plugins, toggles, snapshots, and system operations. It wraps the single
+`omarchy` CLI, so it stays in sync with the real command surface.
+
+Designed to be used both in scripts and inside a Rails application.
+
+## Requirements
+
+- Ruby 3.0+
+- An [Omarchy](https://omarchy.org/) system with the `omarchy` CLI on your `PATH`
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "omagem"
+```
+
+Or install directly from the repository:
+
+```ruby
+gem "omagem", github: "azzenabidi/OmaGem", branch: "main"
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+## Usage
+
+```ruby
+require "omarchy"
+
+Omarchy.run do
+  theme "catppuccin"
+  background "/home/me/Pictures/forest.png"
+
+  add_packages "docker", "git"
+  add_packages "yay-bin", aur: true
+
+  install_service "tailscale"
+  install_dev_env "ruby"
+  install_browser "firefox"
+
+  nightlight :on
+  touchpad :on
+
+  bar_set "omarchy.clock", "format", "HH:mm"
+  clone_plugin "omarchy.workspaces"
+
+  update(yes: false)
+end
+```
+
+Every method is documented on `Omarchy::Config`. The block is evaluated
+against a fresh `Config`, so you can call any DSL method directly:
+
+```ruby
+config = Omarchy.run do
+  theme "catppuccin"
+  add_packages "git"
+end
+
+config.executed            # => [["theme", "set", "catppuccin"], ["pkg", "add", "git"]]
+config.client.run("theme", "current").stdout  # raw command passthrough
+```
+
+## DSL reference
+
+### Themes & backgrounds
+
+```ruby
+theme "catppuccin"              # apply a theme ("Tokyo Night" or "tokyo-night" both work)
+themes                          # list available themes
+install_theme "https://...git"  # install from a git repo
+remove_theme "my-theme"         # remove a user-installed theme
+refresh_theme                   # re-apply current theme from templates
+update_themes                   # update installed git themes
+
+background "/path/to/image.png" # set the desktop background
+background_next                 # cycle to next background
+background_switcher             # open the background switcher
+```
+
+### Packages
+
+```ruby
+add_packages "docker", "git"      # install Arch packages if missing
+add_packages "yay-bin", aur: true # install from the AUR
+drop_packages "vim"               # remove packages if installed
+
+package_present?("docker")          # true unless ALL listed are installed
+package_installed?("docker", "git") # true when ALL listed are installed
+```
+
+### Services, apps, tools
+
+```ruby
+install_service "tailscale"     # 1password, dropbox, nordvpn, once, signal, spotify, sunshine, tailscale
+remove_service "tailscale"
+
+install_browser "firefox"       # chrome, brave, brave-origin, edge, firefox, zen
+install_editor "helix"          # emacs, helix, vscode, zed
+install_terminal "kitty"        # alacritty, foot, ghostty, kitty
+install_dev_env "ruby"          # ruby, node, bun, deno, go, laravel, symfony, php, python, elixir, phoenix, rust, java, zig, ocaml, dotnet, clojure, scala
+install_game "steam"            # steam, heroic, lutris, retroarch, battlenet, geforce-now, xbox-cloud, xbox-controllers, gpu-lib32
+install_app "ChatGPT", "openai-chatgpt"
+```
+
+### System
+
+```ruby
+update(yes: true)        # full system + Omarchy update (-y skips prompts)
+version                  # installed version
+lock                     # lock screen
+reboot / shutdown / logout
+
+channel "stable"         # stable, rc, edge, dev
+default_terminal "kitty" # alacritty, foot, ghostty, kitty
+default_browser "zen"    # chromium, chrome, brave, brave-origin, edge, firefox, zen
+default_editor "nvim"    # code, cursor, zed, sublime_text, helix, vim, emacs, nvim
+
+font "JetBrainsMono Nerd Font"
+current_font
+
+create_snapshot / restore_snapshot
+debug
+```
+
+### Bar, plugins, toggles
+
+```ruby
+bar "local.neon-bar"              # switch bar layout
+bar_position "top"                # top, bottom, left, right
+bar_transparent true              # true, false, :toggle
+bar_set "omarchy.clock", "format", "HH:mm"
+bar_move "omarchy.clock", ["--section", "center", "--index", "0"]
+
+add_plugin "https://...git", enable: true
+clone_plugin "omarchy.workspaces"
+enable_plugin "omarchy.clock"
+disable_plugin "omarchy.clock"
+remove_plugin "omarchy.clock"
+list_plugins(json: false)
+
+nightlight :on               # :on, :off, :toggle
+touchpad :off
+touchscreen :on
+idle :toggle
+bar_visible :toggle
+notification_silencing       # do-not-disturb
+```
+
+### Misc
+
+```ruby
+screenshot
+screenrecord(fullscreen: true, desktop_audio: true, webcam: false)
+stop_screenrecord
+reminder 15, "Pick up Jack"
+focus_app "org.mozilla.firefox"
+```
+
+## From a Rails app
+
+Because `Omarchy.run` returns the `Config` (and records every executed
+command), you can invoke it from a controller, job, or service and inspect
+the results:
+
+```ruby
+result = Omarchy.run { theme params[:theme] }
+flash[:notice] = result.current_theme
+```
+
+### Reusable, non-destructive configuration
+
+Pass a fake (recording) client to build a config without touching the system:
+
+```ruby
+config = Omarchy::Config.new(client: Omarchy::Client::Fake.new)
+config.theme "catppuccin"
+config.executed # => [["theme", "set", "catppuccin"]]
+```
+
+## Errors
+
+- `Omarchy::CommandFailed` — a command exited non-zero (set `ignore_errors: true` in `Omarchy.run` to raise nothing and keep going).
+- `Omarchy::CommandNotFound` — the `omarchy` binary isn't on `PATH` (`ensure_command!`).
+- `Omarchy::ArgumentError` — an invalid enum value (e.g. an unknown terminal).
+
+## Development
+
+```bash
+bundle install
+bundle exec rake test
+bundle exec rubocop
+```
+
+## License
+
+MIT

data/lib/omarchy/client.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'open3'
+
+module Omarchy
+  # Wraps the `omarchy` CLI. It shells out to the single `omarchy` binary and
+  # exposes the resulting output, whether the command succeeded, and the exit
+  # status. Errors raised by the command are captured rather than thrown.
+  #
+  # The class is designed to be subclassed or stubbed in tests (see
+  # Omarchy::Client::Fake) so the DSL can be exercised without a live system.
+  class Client
+    Result = Struct.new(:success, :stdout, :stderr, :status, keyword_init: true) do
+      def success?
+        success
+      end
+
+      def output
+        stdout
+      end
+    end
+
+    def initialize(command: 'omarchy')
+      @command = command
+    end
+
+    # Run an `omarchy` command as in: client.run("theme", "set", "catppuccin")
+    def run(*args)
+      cmd = [@command, *args.map(&:to_s)]
+      stdout, stderr, status = Open3.capture3(*cmd)
+      Result.new(
+        success: status.success?,
+        stdout: stdout.to_s.strip,
+        stderr: stderr.to_s.strip,
+        status: status.exitstatus
+      )
+    end
+
+    # A no-op client that records every call instead of running anything.
+    # Useful for tests and for "dry run" configuration building.
+    class Fake < Client
+      attr_reader :calls
+
+      def initialize
+        super(command: 'omarchy')
+        @calls = []
+      end
+
+      def run(*args)
+        @calls << args
+        Result.new(success: true, stdout: '', stderr: '', status: 0)
+      end
+    end
+  end
+end

data/lib/omarchy/config.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require_relative 'client'
+require_relative 'errors'
+
+module Omarchy
+  # The DSL surface. A Config instance exposes all the management methods
+  # (theme, package, service, system, ...). The methods are defined in
+  # feature modules mixed in below, so the DSL is easy to extend and keep
+  # organized.
+  #
+  # To build a reusable configuration without executing anything, pass a
+  # fake (recording) client to Config.new.
+  class Config
+    attr_reader :client
+
+    def initialize(client: Omarchy::Client.new, ignore_errors: false)
+      @client = client
+      @ignore_errors = ignore_errors
+      @executed = []
+    end
+
+    # Every command that ran through #run, in order. Each entry is the
+    # argument array.
+    attr_reader :executed
+
+    # Run an Omarchy command and return the Omarchy::Client::Result.
+    # Records the call and validates the exit status unless ignore_errors.
+    def run(*args)
+      @executed << args
+      result = client.run(*args)
+      raise CommandFailed.new(args, result) unless result.success?
+
+      result
+    end
+
+    # Raise CommandNotFound if the underlying `omarchy` binary cannot be run.
+    def ensure_command!
+      # A lightweight availability check: run "omarchy version".
+      run('version')
+    rescue Errno::ENOENT
+      raise CommandNotFound, 'the `omarchy` CLI could not be found on PATH'
+    end
+
+    # -- Helpers shared by the feature DSL ---------------------------------
+
+    # True when at least one of the named packages is installed.
+    def package_present?(*names)
+      client.run('pkg', 'present', *names).success?
+    end
+
+    # True when every named package is installed.
+    def package_installed?(*names)
+      !client.run('pkg', 'missing', *names).success?
+    end
+
+    # Current theme name (from `omarchy theme current`).
+    def current_theme
+      client.run('theme', 'current').stdout
+    end
+
+    def valid_theme?(name)
+      available_themes.include?(name)
+    end
+
+    def available_themes
+      client.run('theme', 'list').stdout.lines.map(&:strip).reject(&:empty?)
+    end
+
+    # Raise Omarchy::ArgumentError unless value is in the allowed list.
+    def validate_in!(value, allowed, label)
+      return if allowed.include?(value.to_s)
+
+      raise ArgumentError, "unknown #{label} #{value.inspect}; expected one of: #{allowed.join(', ')}"
+    end
+  end
+end
+
+require_relative 'dsl/theme'
+require_relative 'dsl/package'
+require_relative 'dsl/service'
+require_relative 'dsl/system'
+require_relative 'dsl/bar'
+require_relative 'dsl/plugin'
+require_relative 'dsl/toggle'
+require_relative 'dsl/snapshot'
+require_relative 'dsl/misc'
+
+Omarchy::Config.include(Omarchy::DSL::Theme)
+Omarchy::Config.include(Omarchy::DSL::Package)
+Omarchy::Config.include(Omarchy::DSL::Service)
+Omarchy::Config.include(Omarchy::DSL::System)
+Omarchy::Config.include(Omarchy::DSL::Bar)
+Omarchy::Config.include(Omarchy::DSL::Plugin)
+Omarchy::Config.include(Omarchy::DSL::Toggle)
+Omarchy::Config.include(Omarchy::DSL::Snapshot)
+Omarchy::Config.include(Omarchy::DSL::Misc)

data/lib/omarchy/dsl/bar.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Omarchy
+  module DSL
+    # The status bar: which bar and widget layout is used, plus widget layout.
+    module Bar
+      POSITIONS = %w[top bottom left right].freeze
+
+      # Switch to a bar layout by id, or `:defaults`/`:reset`.
+      def bar(id)
+        run('bar', 'use', id)
+      end
+
+      def bar_position(pos)
+        validate_in!(pos, POSITIONS, 'bar position')
+        run('bar', 'position', pos)
+      end
+
+      def bar_transparent(value = :toggle)
+        run('bar', 'transparent', value.to_s)
+      end
+
+      # Put a widget somewhere; placement e.g. ["--after", "omarchy.clock"].
+      def bar_put(id, placement = [])
+        run('bar', 'put', id, *placement)
+      end
+
+      # Move a widget; placement e.g. ["--section", "center", "--index", "0"].
+      def bar_move(id, placement = [])
+        run('bar', 'move', id, *placement)
+      end
+
+      # Set a widget key/value; e.g. bar_set("omarchy.clock", "format", "HH:mm").
+      def bar_set(id, key, value)
+        run('bar', 'set', id, key, value)
+      end
+    end
+  end
+end

data/lib/omarchy/dsl/misc.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Omarchy
+  module DSL
+    # Misc: reminders, screen capture, launch app, focus app, default agent.
+    module Misc
+      # Full-screen screenshot saved to disk.
+      def screenshot
+        run('capture', 'screenshot', 'fullscreen', 'save')
+      end
+
+      def screenrecord(fullscreen: false, desktop_audio: false, microphone: false, webcam: false)
+        args = %w[capture screenrecording]
+        args << '--fullscreen' if fullscreen
+        args << '--with-desktop-audio' if desktop_audio
+        args << '--with-microphone-audio' if microphone
+        args << '--with-webcam' if webcam
+        run(*args)
+      end
+
+      def stop_screenrecord
+        run('capture', 'screenrecording', '--stop-recording')
+      end
+
+      # Set a desktop notification reminder; minutes accepts decimals.
+      def reminder(minutes, message)
+        run('reminder', minutes.to_s, message)
+      end
+
+      def focus_app(name)
+        run('hyprland', 'focus', 'app', name)
+      end
+    end
+  end
+end

data/lib/omarchy/dsl/package.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require_relative '../errors'
+
+module Omarchy
+  module DSL
+    # Package management: add / drop Arch and AUR packages, plus queries.
+    module Package
+      # Install one or more Arch packages if missing.
+      def add_packages(*names, aur: false)
+        if aur
+          run('pkg', 'aur', 'add', *names)
+        else
+          run('pkg', 'add', *names)
+        end
+        names.size == 1 ? names.first : names
+      end
+      alias install_packages add_packages
+
+      # Remove one or more packages if they are installed.
+      def drop_packages(*names)
+        run('pkg', 'drop', *names)
+        names.size == 1 ? names.first : names
+      end
+      alias remove_packages drop_packages
+    end
+  end
+end

data/lib/omarchy/dsl/plugin.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Omarchy
+  module DSL
+    # Shell plugin and bar-widget management.
+    module Plugin
+      # Add a shell plugin from a git URL. enable: true enables it immediately.
+      def add_plugin(url, enable: false)
+        args = ['plugin', 'add', url]
+        args << '--enable' if enable
+        args << '--yes'
+        run(*args)
+      end
+
+      # Clone a built-in plugin into the user config (switch to user copy).
+      def clone_plugin(id)
+        run('plugin', 'clone', id)
+      end
+
+      def enable_plugin(id, placement = nil)
+        args = ['plugin', 'enable', id]
+        args << placement if placement
+        run(*args)
+      end
+
+      def disable_plugin(id)
+        run('plugin', 'disable', id)
+      end
+
+      def remove_plugin(id)
+        run('plugin', 'remove', id, '--yes')
+      end
+
+      def list_plugins(json: false)
+        args = %w[plugin list]
+        args << '--json' if json
+        out = run(*args).stdout
+        json ? out : out.lines.map(&:strip).reject(&:empty?)
+      end
+    end
+  end
+end

data/lib/omarchy/dsl/service.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require_relative '../errors'
+
+module Omarchy
+  module DSL
+    # Install/manage optional software, services, apps, browsers, editors,
+    # terminals, development environments, and gaming.
+    module Service
+      # Install a supported standalone app, e.g. install_app("ChatGPT")
+      # wraps `omarchy install <display-name> <packages>`.
+      def install_app(display_name, packages)
+        run('install', 'app', display_name, packages)
+      end
+
+      # -- Optional software installers ------------------------------------
+
+      def install_browser(name)
+        validate_in!(name, %w[chrome brave brave-origin edge firefox zen], 'browser')
+        run('install', 'browser', name)
+      end
+
+      def install_editor(name)
+        validate_in!(name, %w[emacs helix vscode zed], 'editor')
+        run('install', 'editor', name)
+      end
+
+      def install_terminal(name)
+        validate_in!(name, %w[alacritty foot ghostty kitty], 'terminal')
+        run('install', 'terminal', name)
+      end
+
+      # -- Services ---------------------------------------------------------
+
+      SERVICES = %w[1password dropbox nordvpn once signal spotify sunshine tailscale].freeze
+
+      # Install and start a supported service (or bundle downloads a full version).
+      def install_service(name)
+        validate_in!(name, SERVICES, 'service')
+        run('install', 'service', name)
+      end
+
+      def remove_service(name)
+        validate_in!(name, SERVICES, 'service')
+        run('remove', 'service', name)
+      end
+
+      # -- Development environments (install dev-env <ruby|node|...>) ------
+
+      def install_dev_env(env)
+        allowed = %w[ruby node bun deno go laravel symfony php python elixir phoenix rust java zig ocaml dotnet clojure
+                     scala]
+        validate_in!(env, allowed, 'dev env')
+        run('install', 'dev-env', env)
+      end
+
+      # -- Gaming -----------------------------------------------------------
+
+      def install_game(platform)
+        allowed = %w[steam heroic lutris retroarch battlenet geforce-now xbox-cloud xbox-controllers gpu-lib32]
+        validate_in!(platform, allowed, 'gaming platform')
+        run('install', 'gaming', platform)
+      end
+    end
+  end
+end

data/lib/omarchy/dsl/snapshot.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Omarchy
+  module DSL
+    # System snapshots via snapper.
+    module Snapshot
+      def create_snapshot
+        run('snapshot', 'create')
+      end
+
+      def restore_snapshot
+        run('snapshot', 'restore')
+      end
+    end
+  end
+end

data/lib/omarchy/dsl/system.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Omarchy
+  module DSL
+    # System-level operations: updates, reboot/shutdown/lock, default apps,
+    # font, snapshots, and diagnostics.
+    module System
+      # Perform a full system + Omarchy update. Pass yes: true to skip prompts.
+      def update(yes: false)
+        args = ['update']
+        args << '-y' if yes
+        run(*args)
+      end
+
+      def version(channel: false)
+        args = ['version']
+        args << 'channel' if channel
+        run(*args).stdout
+      end
+
+      def reboot
+        run('system', 'reboot')
+      end
+
+      def shutdown
+        run('system', 'shutdown')
+      end
+
+      def lock
+        run('system', 'lock')
+      end
+
+      def logout
+        run('system', 'logout')
+      end
+
+      def channel(name = nil)
+        return run('channel', 'current').stdout if name.nil?
+
+        validate_in!(name, %w[stable rc edge dev], 'channel')
+        run('channel', 'set', name)
+      end
+
+      # Set the default terminal used by xdg-terminal-exec.
+      def default_terminal(name)
+        validate_in!(name, %w[alacritty foot ghostty kitty], 'terminal')
+        run('default', 'terminal', name)
+      end
+
+      def default_browser(name)
+        validate_in!(name, %w[chromium chrome brave brave-origin edge firefox zen], 'browser')
+        run('default', 'browser', name)
+      end
+
+      def default_editor(name)
+        validate_in!(name, %w[code cursor zed sublime_text helix vim emacs nvim], 'editor')
+        run('default', 'editor', name)
+      end
+
+      # Set the system monospace font.
+      def font(name)
+        run('font', 'set', name)
+      end
+
+      def current_font
+        run('font', 'current').stdout
+      end
+
+      def debug
+        run('debug', '--no-sudo', '--print').stdout
+      end
+    end
+  end
+end

data/lib/omarchy/dsl/theme.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require_relative '../errors'
+
+module Omarchy
+  module DSL
+    # Theme management: apply, list, install, remove, refresh, backgrounds.
+    module Theme
+      # Apply a theme by name. `"Tokyo Night"` and `"tokyo-night"` both work.
+      def theme(name)
+        run('theme', 'set', name)
+      end
+      alias apply_theme theme
+
+      # List themes Omarchy knows about.
+      def themes
+        run('theme', 'list').stdout.lines.map(&:strip).reject(&:empty?)
+      end
+
+      # Install a theme from a git repository URL.
+      def install_theme(url)
+        run('theme', 'install', url)
+      end
+
+      # Remove a user-installed theme by name.
+      def remove_theme(name)
+        run('theme', 'remove', name)
+      end
+
+      # Re-apply the current theme from its templates.
+      def refresh_theme
+        run('theme', 'refresh')
+      end
+
+      # Update user-installed git themes.
+      def update_themes
+        run('theme', 'update')
+      end
+
+      # -- Backgrounds ------------------------------------------------------
+
+      # Set the desktop background to the given image path.
+      def background(path)
+        run('theme', 'bg', 'set', path)
+      end
+      alias set_background background
+
+      # Cycle to the next background for the current theme.
+      def background_next
+        run('theme', 'bg', 'next')
+      end
+
+      # Open the background switcher.
+      def background_switcher
+        run('theme', 'bg-switcher')
+      end
+    end
+  end
+end

data/lib/omarchy/dsl/toggle.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Omarchy
+  module DSL
+    # Toggle Omarchy features on/off: nightlight, touchpad, Bluetooth, etc.
+    module Toggle
+      # Toggle a named feature: toggle("nightlight") or
+      # toggle("nightlight", :on | :off | :toggle).
+      def toggle(name, state = :toggle)
+        run('toggle', name, state.to_s)
+      end
+
+      def nightlight(state = :toggle)
+        run('toggle', 'nightlight', state.to_s)
+      end
+
+      def touchpad(state = :toggle)
+        run('toggle', 'touchpad', state.to_s)
+      end
+
+      def touchscreen(state = :toggle)
+        run('toggle', 'touchscreen', state.to_s)
+      end
+
+      def idle(state = :toggle)
+        run('toggle', 'idle', state.to_s)
+      end
+
+      def bar_visible(state = :toggle)
+        run('toggle', 'bar', state.to_s)
+      end
+
+      def notification_silencing
+        run('toggle', 'notification silencing')
+      end
+    end
+  end
+end

data/lib/omarchy/errors.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Omarchy
+  # Base class for all Omarchy::DSL errors.
+  class Error < StandardError; end
+
+  # Raised when the `omarchy` CLI is not available on the system.
+  class CommandNotFound < Error; end
+
+  # Raised (unless swallowed with `ignore_errors: true`) when an `omarchy`
+  # command exits with a non-zero status.
+  class CommandFailed < Error
+    attr_reader :args, :result
+
+    def initialize(args, result)
+      @args = args
+      @result = result
+      super("omarchy #{args.join(' ')} failed (exit #{result.status}): #{result.stderr}")
+    end
+  end
+
+  # Raised when a DSL value is outside the set of values Omarchy accepts.
+  class ArgumentError < Error; end
+end

data/lib/omarchy/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Omarchy
+  VERSION = '0.1.0'
+end

data/lib/omarchy.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative 'omarchy/version'
+require_relative 'omarchy/errors'
+require_relative 'omarchy/client'
+require_relative 'omarchy/config'
+
+# Omarchy is a Ruby DSL for configuring and managing Omarchy Linux systems.
+#
+#   require "omarchy"
+#
+#   Omarchy.run do
+#     theme "catppuccin"
+#     add_packages "docker", "git"
+#     install_service "tailscale"
+#     nightlight :on
+#   end
+#
+# The block is evaluated against an Omarchy::Config, which exposes every
+# DSL method. See Omarchy::Config for the full list.
+module Omarchy
+  class << self
+    # Execute a DSL block against a fresh Omarchy::Config. Returns the config
+    # so the caller can inspect what ran via config.executed / config.client.
+    #
+    #   config = Omarchy.run { theme "catppuccin" }
+    def run(client: Omarchy::Client.new, ignore_errors: false, &block)
+      config = Config.new(client: client, ignore_errors: ignore_errors)
+      config.instance_eval(&block) if block
+      config
+    end
+  end
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification
+name: omagem
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- azzen
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-09-09 00:00:00.000000000 Z
+dependencies: []
+description: A tiny Ruby DSL that wraps the `omarchy` CLI so you can manage themes,
+  packages, services, the shell bar, and more from Ruby or a Rails application.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/omarchy.rb
+- lib/omarchy/client.rb
+- lib/omarchy/config.rb
+- lib/omarchy/dsl/bar.rb
+- lib/omarchy/dsl/misc.rb
+- lib/omarchy/dsl/package.rb
+- lib/omarchy/dsl/plugin.rb
+- lib/omarchy/dsl/service.rb
+- lib/omarchy/dsl/snapshot.rb
+- lib/omarchy/dsl/system.rb
+- lib/omarchy/dsl/theme.rb
+- lib/omarchy/dsl/toggle.rb
+- lib/omarchy/errors.rb
+- lib/omarchy/version.rb
+homepage: https://github.com/azzenabidi/OmaGem
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Ruby DSL to configure and manage Omarchy Linux systems
+test_files: []