From f2c9889272bb51db0b6513467593dda7623d8c2b Mon Sep 17 00:00:00 2001
From: kj_sh604
Date: Sat, 20 Dec 2025 23:31:57 -0500
Subject: kj-gitbot: README.md

---
 README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fee083b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+# kjagave 
+
+a color picker inspired by agave, but only with the features I actually used
+
+![screenshot of kjagave](./pics/readme-greeter.png)
+
+## features
+
+- visual color picker with rgb/hsv sliders
+- **pick colors from anywhere on screen (only on x11 because I'm lazy)**
+- alpha channel support
+- save and manage favorite colors
+- copy hex color codes to clipboard
+- clean, minimal interface
+
+## requirements
+
+- go 1.21 or higher
+- gtk3 development libraries
+- `xcolor` or `grabc` for screen color picking
+
+## building
+
+```sh
+cd src
+go mod download
+go build -o ./kjagave main.go
+```
+
+## running
+
+from the src/ directory:
+
+```bash
+./kjagave
+```
+
+## usage
+
+1. use the color picker button to open the full color selection dialog
+2. **click "Pick from Screen" to grab a color from anywhere on your screen** - your cursor will change to a crosshair, click on any pixel to select its color
+3. click "Copy to Clipboard" to copy the hex color code
+4. click "Save..." to save the current color to your favorites list
+5. expand "Saved Colors" to view and manage your saved colors
+6. select a saved color to load it in the picker
+7. click "Delete" to remove a selected saved color
+
+saved colors are stored in `~/.config/kjagave.json` as json.
\ No newline at end of file
-- 
cgit v1.2.3