@@ 42,34 42,71 @@ Otherwise, once you've cloned the repo, either get `bin/session` and `bin/sessio
zef install .
```
-## Example
+## Example usage
```
-user@hostname ~ $ sessions
-┌───────┐
-│dolphin│
-├───────┴─────────┐
-│ dolphin │
-└─────────────────┘
-┌────┐
-│meta│
-├────┴────────────┐
-│ sessions │
-└─────────────────┘
+[ ~/dev/sessions ] on master
+λ | ➜ sessions --usage
+Usage:
+ sessions [--style=<Style> (boxed compact)] -- Default display style is boxed.
+
+[ ~/dev/sessions ] on master
+λ | ➜ sessions
┌────┐
│misc│
-├────┴────────────┐
-│ dev │
-└─────────────────┘
-┌────────┐
-│research│
-├────────┴────────┐
-│ demo │
-└─────────────────┘
-┌───┐
-│sys│
-├───┴─────────────┐
-│ admin │
-│ status │
-└─────────────────┘
-user@hostname ~ $
+├────┴─┐
+│ dev │
+└──────┘
+
+[ ~/dev/sessions ] on master
+λ | ➜ sessions --style=compact
+misc
+ dev
+
+[ ~/dev/sessions ] on master
+λ | ➜ session --usage
+Usage:
+ session -- Create or enter default session 'misc/dev'.
+ session <category> <session> -- Create or enter session '<category>/<session>'.
+ session <session> -- Search all categories for matching session, switch to result if unique.
+
+[ ~/dev/sessions ] on master
+λ | ➜ session foo bar
+[detached (from session foo/bar)]
+
+[ ~/dev/sessions ] on master took 2s
+λ | ➜ sessions --style=compact
+foo
+ bar
+
+misc
+ dev
+
+
+[ ~/dev/sessions ] on master
+λ | ➜ session foo bar
+
+[ ~/dev/sessions ] on master took 2s
+λ | ➜ session bar # equivalent
+
+[ ~/dev/sessions ] on master took 2s
+λ | ➜ session bar bar
+[detached (from session bar/bar)]
+
+[ ~/dev/sessions ] on master took 2s
+λ | ➜ sessions --style=compact
+bar
+ bar
+
+foo
+ bar
+
+misc
+ dev
+
+
+[ ~/dev/sessions ] on master
+λ | ➜ session bar
+Ambiguous session, choose one of:
+bar/bar
+foo/bar
```