chore: publish de-cli with readme demo

Author: arimxyer

.gitignore

@@ -1 +1,3 @@
 /target
+demo/*.termctrl
+demo/*.mp4

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
-name = "de"
-version = "0.1.0"
+name = "de-cli"
+version = "0.1.1"
 edition = "2024"
 rust-version = "1.88"
 description = "A tiny inline directory explorer for your shell"
@@ -11,6 +11,14 @@ readme = "README.md"
 keywords = ["cli", "directory", "terminal", "tui"]
 categories = ["command-line-utilities"]
 
+[lib]
+name = "de"
+path = "src/lib.rs"
+
+[[bin]]
+name = "de"
+path = "src/main.rs"
+
 [dependencies]
 chrono = { version = "0.4", default-features = false, features = ["clock"] }
 clap = { version = "4.5", features = ["derive"] }

Cargo.toml

@@ -4,6 +4,8 @@
 directory, lets you walk into or out of folders, and changes the shell's working
 directory only when you confirm.
 
+![Navigating directories with de](demo/de.gif)
+
 At normal terminal widths, the left pane is the directory you are currently
 exploring and the right pane previews the highlighted destination. Below 58
 columns, `de` collapses to a single pane instead of squeezing the listings.
@@ -15,10 +17,11 @@ delete, rename, copy, edit, or open commands.
 
 ## Install
 
-Install the latest source directly with Cargo:
+Install from crates.io with Cargo (the package is named `de-cli`, but the
+installed command is `de`):
 
 ```sh
-cargo install --git https://github.com/reyamira/de --locked
+cargo install de-cli --locked
 ```
 
 Prebuilt archives for Linux and macOS on x86-64 and ARM64 are available from
@@ -203,6 +206,18 @@ cargo clippy --all-targets --all-features -- -D warnings
 cargo test
 ```
 
+The README demo is driven by the checked-in Terminal Control tape. To replay it
+after building the release binary:
+
+```sh
+cargo build --release
+termctrl play demo/de.tape
+```
+
+The tape creates and removes its own synthetic fixture under `/tmp`; its private
+`.termctrl` timeline and intermediate MP4 are gitignored. `demo/de.gif` is the
+small public artifact embedded above.
+
 The UI is rendered on stderr so stdout remains a clean selected-path protocol
 for the shell wrapper. On Unix, path bytes are preserved by the executable; like
 most command-substitution integrations, directories whose names end in newline

README.md

@@ -0,0 +1,9 @@
+{
+  "clips": [
+    {
+      "from": "ready",
+      "to": "done",
+      "caption": "Explore, filter, and cd without leaving the terminal"
+    }
+  ]
+}

demo/de-edit.json

@@ -0,0 +1,46 @@
+# Rebuild the binary, then replay with: termctrl play demo/de.tape
+Session de-readme-demo
+Viewport 92 10
+Cell 9 18
+Cwd ".."
+Env TERM "xterm-256color"
+Record "de.termctrl"
+Color always
+Setup "/bin/bash" "demo/fixture.sh" "setup"
+Cleanup "/bin/bash" "demo/fixture.sh" "cleanup"
+Launch "/bin/bash" "demo/shell.sh"
+
+Wait "de-demo workspace $"
+Sleep 800ms
+Mark ready
+Type "de" Pace 100ms
+Key enter
+Wait "workspace"
+Mark picker
+Sleep 1200ms
+Key down
+Sleep 650ms
+Key up
+Key right
+Wait "api"
+Sleep 900ms
+Key down
+Sleep 500ms
+Key up
+Sleep 350ms
+Key right
+Wait "src"
+Sleep 900ms
+Key left
+Wait "api"
+Sleep 700ms
+Type "/test" Pace 120ms
+Sleep 900ms
+Mark filtered
+Key escape
+Sleep 500ms
+Key enter
+Wait "de-demo api $"
+Mark done
+Sleep 1400ms
+Stop

demo/de.gif

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+demo_root=/tmp/de-readme-demo
+
+case "${1:-}" in
+  setup)
+    rm -rf -- "$demo_root"
+    mkdir -p \
+      "$demo_root/config/de" \
+      "$demo_root/workspace/api/src" \
+      "$demo_root/workspace/api/tests" \
+      "$demo_root/workspace/docs/guides" \
+      "$demo_root/workspace/frontend/components" \
+      "$demo_root/workspace/frontend/pages"
+    touch \
+      "$demo_root/workspace/api/Cargo.toml" \
+      "$demo_root/workspace/api/README.md" \
+      "$demo_root/workspace/api/src/main.rs" \
+      "$demo_root/workspace/api/tests/health.rs" \
+      "$demo_root/workspace/docs/guides/getting-started.md" \
+      "$demo_root/workspace/frontend/package.json"
+    printf '%s\n' \
+      '[theme]' \
+      'selected = "ocean"' \
+      '' \
+      '[display]' \
+      'modified = false' \
+      > "$demo_root/config/de/config.toml"
+    ;;
+  cleanup)
+    rm -rf -- "$demo_root"
+    ;;
+  *)
+    printf 'usage: %s setup|cleanup\n' "$0" >&2
+    exit 2
+    ;;
+esac

demo/de.tape

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+repo_root=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)
+export PATH="$repo_root/target/release:$PATH"
+export XDG_CONFIG_HOME=/tmp/de-readme-demo/config
+export PS1=$'\e[38;5;81mde-demo\e[0m \W $ '
+
+eval "$(command de init bash)"
+export -f de
+
+cd /tmp/de-readme-demo/workspace
+exec bash --noprofile --norc -i