diff --git a/.agents/AGENTS.md b/.agents/AGENTS.md new file mode 120000 index 0000000..be77ac8 --- /dev/null +++ b/.agents/AGENTS.md @@ -0,0 +1 @@ +../AGENTS.md \ No newline at end of file diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..3102ee7 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,54 @@ +# Agent Instructions + +Key non-negotiable rules from that file: + +- **Always present a plan first** and wait for user approval before making any changes — no matter how small the task. +- Never commit or create branches unless explicitly asked. + +# Agent Guidelines — nixos-setup + +Rules and best practices for any AI agent working in this repository. +Read this file before making any changes. + +--- + +## Mandatory First Step — Always Present a Plan + +Before making **any** change to this repository, you MUST present a short plan to the user and wait for their approval. This applies to every task, no matter how small. + +Your plan must include: + +1. **What** you intend to change (files, options, packages) +2. **Why** the change is needed +3. **How** you will do it (which files you will edit, in what order) +4. **What you will NOT do** (e.g., "I will not run any builds") + +Only after the user approves the plan may you proceed with edits. + +--- + +## Hard Rules — Never Break These + +**Your job:** Make correct edits to source files. The user validates and runs builds themselves. + +**Even if the user says "go ahead":** Do NOT run these. Your role is to write good Nix, not execute it. + +### ❌ NEVER modify `GUIDELINES.md` unless explicitly requested by the user + +You must **live and die by these rules** and hold yourself accountable to them. +These are not suggestions — they are non-negotiable. + +### KEEP EVERYTHING CONCISE, shorter concise comments are preferable, less jargon and more common words. + +## When In Doubt + +If you are unsure whether a command is safe, **assume it is NOT SAFE and don't run it.** + +Instead: describe what you would do and ask the user for permission. + +## Commit / Branch / Git Policy + +- Do NOT commit changes or create branches unless the user explicitly asks +- Do NOT `git add`, `git commit`, or `git push` autonomously +- You may run `git add` **only** if required for a Nix evaluation (e.g., new files must be tracked for flakes) +- Describe what you changed in your final message so the user can review before committing diff --git a/flake.nix b/flake.nix new file mode 100644 index 0000000..71b419e --- /dev/null +++ b/flake.nix @@ -0,0 +1,31 @@ +{ + description = "Quickshell app carousel launcher"; + + inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable"; + + outputs = + { self, nixpkgs }: + let + systems = [ + "x86_64-linux" + "aarch64-linux" + ]; + forAllSystems = nixpkgs.lib.genAttrs systems; + in + { + packages = forAllSystems ( + system: + let + pkgs = nixpkgs.legacyPackages.${system}; + in + rec { + skygqts = pkgs.callPackage ./package.nix { }; + default = skygqts; + } + ); + + overlays.default = final: prev: { + skygqts = final.callPackage ./package.nix { }; + }; + }; +} diff --git a/package.nix b/package.nix new file mode 100644 index 0000000..60c25a6 --- /dev/null +++ b/package.nix @@ -0,0 +1,40 @@ +{ + lib, + stdenvNoCC, + makeWrapper, + quickshell, +}: + +stdenvNoCC.mkDerivation { + pname = "skygqts"; + version = "0.1.0"; + + src = lib.fileset.toSource { + root = ./.; + fileset = lib.fileset.unions [ + ./app-carousel + ./example.json + ]; + }; + + nativeBuildInputs = [ makeWrapper ]; + + dontBuild = true; + + installPhase = '' + runHook preInstall + mkdir -p $out/share/skygqts + cp -r app-carousel $out/share/skygqts/ + cp example.json $out/share/skygqts/ + mkdir -p $out/bin + makeWrapper ${lib.getExe quickshell} $out/bin/skygqts \ + --add-flags "-p $out/share/skygqts/app-carousel" + runHook postInstall + ''; + + meta = { + description = "Quickshell app carousel launcher"; + platforms = lib.platforms.linux; + mainProgram = "skygqts"; + }; +}