Initial commit. Initial working version.

README.md

@@ -1,3 +1,57 @@
 # keila_csv
 
-Contact data exchange with Keila using CSV files.
+Contact data exchange with Keila using CSV files.
+
+**Tools to work with contact data from Keila.**
+
+These are two scripts to work with contact data that is imported to
+or exported from [Keila][], the mailings software.
+
+## Run inside a Docker container
+
+### Build image
+
+```bash
+docker build . -t keila_csv
+```
+
+### Run program
+
+```bash
+# Normal use, mounting a local data directory
+docker run -v $(pwd)/data:/data keila_csv keila2csv /data/export.csv /data/flat.csv
+docker run -v $(pwd)/data:/data keila_csv csv2keila /data/flat.csv /data/import.csv
+
+# Explicit help
+docker run keila_csv --help
+```
+
+## Use of Artificial Intelligence (AI)
+
+Anthropic Claude was used in conjunction with Human Brain to write
+this program.
+
+## The MIT License (MIT)
+
+Copyright © 2026 Daniel Kraus <bovender@bovender.de>
+
+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.
+
+[Keila]: https://keila.io