Small library for generating claude-code like unicde block mascots, and providing animations when they do stuff
docs: add README
+62
+62
README.md
+62
README.md
···
1
+
# clood 🟦
2
+
3
+
Generate cute unicode block characters in your terminal.
4
+
5
+
```
6
+
████████
7
+
██░██░████
8
+
██████████████
9
+
████████████
10
+
████████████
11
+
█ █ █ █
12
+
█ █ █ █
13
+
```
14
+
15
+
Every clood is randomized by default — run it again for a new friend.
16
+
17
+
## Install
18
+
19
+
```bash
20
+
cargo install --path .
21
+
```
22
+
23
+
## Usage
24
+
25
+
```bash
26
+
# Random clood
27
+
clood
28
+
29
+
# Customize your clood
30
+
clood --width 12 --height 6 --color '#88DDFF' --eyecolor '#000000' \
31
+
--numlegs 4 --round 2
32
+
33
+
# Expressive eyes
34
+
clood --mood 2 --lefteye 1 --righteyeclosed 1
35
+
36
+
# Animate! Ping-pong any parameter between two values
37
+
clood --anim mood:-1:3 # bobbing eyes
38
+
clood --anim leftarm:-1:2 --anim rightarm:2:-1 # waving
39
+
clood --anim lefteyeclosed:0:1 --fps 3 # blinking
40
+
```
41
+
42
+
## Parameters
43
+
44
+
| Flag | Default | Description |
45
+
|------|---------|-------------|
46
+
| `--width` | random 8–16 | Body width |
47
+
| `--height` | random 4–8 | Body height |
48
+
| `--color` | random | Body color (hex) |
49
+
| `--eyecolor` | random | Eye color (hex) |
50
+
| `--mood` | random -2–2 | Eye height offset |
51
+
| `--lefteye` | 0 | Left eye vertical offset |
52
+
| `--righteye` | 0 | Right eye vertical offset |
53
+
| `--lefteyeclosed` | 0 | Left eye closed (0/1) |
54
+
| `--righteyeclosed` | 0 | Right eye closed (0/1) |
55
+
| `--round` | 0 | Corner rounding (0 to width/2) |
56
+
| `--armsize` | random 2–4 | Arm width |
57
+
| `--leftarm` | 0 | Left arm vertical offset |
58
+
| `--rightarm` | 0 | Right arm vertical offset |
59
+
| `--numlegs` | random even 0–8 | Number of legs |
60
+
| `--legsize` | random 2–4 | Leg length |
61
+
| `--anim` | — | Animate: `param:min:max` (repeatable) |
62
+
| `--fps` | 4 | Animation frame rate |