docs: add readme

README.md

@@ -0,0 +1,54 @@
+# chot
+
+**`chot` (ちょっと)** - pronounced /cho-tto/ - is a minimalist launcher for running or editing ephemeral, one-off scripts.
+
+It lets you keep messy glue code, experimental snippets, or temporary scripts in a central place — and run or edit them with a simple command.
+
+## Features
+
+- `chot foo` runs a script called `foo`
+- `chot edit foo` opens the script in `$EDITOR`
+- `help` and `--help` are supported
+- Script directory is configurable and auto-created
+- Fish shell completion included
+
+## Usage
+
+```sh
+chot foo         # Runs the script named 'foo'
+chot edit foo    # Opens 'foo' in your $EDITOR
+chot help        # Show help
+```
+
+## Script Directory Resolution
+
+chot stores and looks for scripts in this order:
+
+1. `$CHOT_SCRIPT` (if set)
+2. `$XDG_DATA_HOME/chot/scripts` (if `$XDG_DATA_HOME` is set)
+3. `~/.local/share/chot/scripts`
+
+If the directory does not exist, it will be created automatically the first time you run or edit a script.
+
+💡 **Note:** We intentionally delay creating this directory until it's needed — just viewing `--help` shouldn't modify your filesystem.
+
+## Installation
+
+```sh
+make install
+```
+
+This will install:
+
+- `bin/chot` to `~/.local/bin/`
+- Fish shell completion to the appropriate directory
+
+## Uninstallation
+
+```sh
+make uninstall
+```
+
+## License
+
+MIT