agents, agents everywhere

Author: attogram

AGENTS.md

@@ -0,0 +1,61 @@
+# Bash Screensavers
+
+The Bash Screensavers project is a collection of fun screensavers written entirely in Bash.
+
+# Project Overview
+
+* `./screensaver.sh` is the main menu script
+  * it shows a list of available screensavers and prompts user to pick one to run.
+* `./gallery` is the gallery directory
+  * this is where all screensavers are stored.
+* Each screensaver has its own directory inside `./gallery`
+  * The name of the directory is the name of the screensaver.
+  * example: `./gallery/alpha`
+* Each screensaver must have a run script in format 'name.sh'
+  * example: `./gallery/alpha/alpha.sh`
+* `./tests` directory is the BATS test suite for this project
+* `./.github` directory is for GitHub Workflows for this project.
+
+# Project Structure
+
+```
+.
+├─ screensaver.sh
+├─ AGENTS.md
+├─ LICENSE
+├─ README.md
+├─ gallery
+│   ├─ alpha
+│   │   └─ alpha.sh
+│   ├─ bouncing
+│   │   └─ bouncing.sh
+│   ├─ cutesaver
+│   │   ├─ cutesaver.sh
+│   │   ├─ rollthecute.sh
+│   │   ├─ LICENSE
+│   │   ├─ readme.md
+│   │   └─ art
+│   ├─ fireworks
+│   │   └─ fireworks.sh
+│   ├─ matrix
+│   │   └─ matrix.sh
+│   ├─ pipes
+│   │   └─ pipes.sh
+│   ├─ rain
+│   │   └─ rain.sh
+│   ├─ stars
+│   │   └─ stars.sh
+│   └─ tunnel
+│       └─ tunnel.sh
+├─ tests
+│   └─ test_screensaver.sh
+└─ .github
+    └─ workflows
+        └─ create.release.for.tag.yml
+```
+
+# Requirements
+
+* Bash v3.2 or higher
+* All screensavers must gracefully handle ^C to clean up the terminal and exit
+* All shell scripts must have execute permission (chmod +x *.sh)

gallery/bouncing/bouncing.sh

@@ -1,22 +1,19 @@
 #!/usr/bin/env bash
 #
-# Bash Screensaver Chooser
+# Bash Screensavers
 #
 # A collection of screensavers written in bash.
 # Because who needs fancy graphics when you have ASCII?
 #
 
 BASH_SCREENSAVERS_NAME="Bash Screensavers"
-BASH_SCREENSAVERS_VERSION="0.0.2"
+BASH_SCREENSAVERS_VERSION="0.0.3"
 BASH_SCREENSAVERS_URL="https://github.com/attogram/bash-screensavers"
 BASH_SCREENSAVERS_DISCORD="https://discord.gg/BGQJCbYVBa"
 BASH_SCREENSAVERS_LICENSE="MIT"
 BASH_SCREENSAVERS_COPYRIGHT="Copyright (c) 2025 Attogram Project <https://github.com/attogram>"
 
-# Get the directory of this script
-# https://stackoverflow.com/questions/59895/how-do-i-get-the-directory-where-a-bash-script-is-located-from-within-the-script
 SCRIPT_DIR=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" &> /dev/null && pwd)
-
 BASH_SCREENSAVERS_DIR="$SCRIPT_DIR/gallery"
 
 # Lists all available screensavers.