···1+# Grain CLI
2+3+⚠️ **Work in Progress**: This CLI is currently under development and is not
4+ready for use yet.
5+6+A command-line interface for [grain.social](https://grain.social) - a platform
7+for sharing photo galleries.
8+9+## Features
10+11+- **Authentication**: OAuth login flow with grain.social
12+- **Gallery Management**: List and create photo galleries
13+- **Image Upload**: Bulk upload images from local folders with automatic
14+ resizing
15+16+## Requirements
17+18+- [Rust](https://rustup.rs/) installed
19+- AT Protocol account ([Bluesky](https://bsky.app))
20+21+## Installation
22+23+Build from source:
24+25+```bash
26+cargo build --release
27+```
28+29+The binary will be available at `target/release/grain`.
30+31+## Usage
32+33+### Authentication
34+35+First, authenticate with your grain.social account:
36+37+```bash
38+grain login
39+```
40+41+This will open your browser for OAuth authentication.
42+43+### Gallery Commands
44+45+List your existing galleries:
46+47+```bash
48+grain gallery list
49+```
50+51+Create a new gallery from a folder of images:
52+53+```bash
54+grain gallery create
55+```
56+57+You'll be prompted for:
58+59+- Gallery title
60+- Gallery description (optional)
61+- Path to folder containing images
62+63+The CLI will automatically resize images and upload them to your new gallery.
64+65+### Verbose Output
66+67+Add `--verbose` to any command for detailed output:
68+69+```bash
70+grain login --verbose
71+grain gallery create --verbose
72+```