chore: update doc

Author: ekaone

README.md

@@ -1,6 +1,10 @@
-# json-cli
+# @ekaone/json-cli
+
+AI-powered CLI task runner. Just write in plain English, AI generates a validated JSON command plan, and the runner executes it step by step.
+
+## Think safety first
+> For safety, `json-cli` will generate the plan and ask for confirmation before running the steps. You can also use the `--dry-run` flag to preview the plan without executing it. 
 
-AI-powered CLI task runner. Write in plain English, AI generates a validated JSON command plan and finally runner executes it step by step.
 
 ## Installation
 
@@ -99,6 +103,10 @@ json-cli "run tests, check git diff, then git add and commit with message 'fix:
 json-cli "install deps, run typecheck, run tests, build, git add, commit with message 'ci: local pipeline passed', push"
 ```
 
+### More examples
+
+💡 There are a lot cool examples in the [examples](./examples/README.md) file.
+
 ### Options
 
 ```bash

examples/README.md

@@ -0,0 +1,123 @@
+## Shell Examples
+
+```bash
+json-cli "list files in current directory"
+```
+
+```bash
+json-cli "Find child processes in the 3000–4000 range in Git Bash"
+```
+
+```bash
+json-cli "Check disk usage and show top 10 largest files in current directory"
+```
+
+```bash
+json-cli "Kill all processes using port 3000"
+```
+
+```bash
+json-cli "Find all JavaScript files modified in the last 7 days"
+```
+
+```bash
+json-cli "Compress all log files older than 30 days into a tar.gz archive"
+```
+
+## Docker Examples
+
+```bash
+json-cli "Build a Docker image from the current directory and run it"
+```
+
+```bash
+json-cli "Pull nginx image, run a container, and show running containers"
+```
+
+```bash
+json-cli "Stop all running containers and remove them"
+```
+
+```bash
+json-cli "Show all containers, their logs, and remove stopped containers"
+```
+
+```bash
+json-cli "Build image from Dockerfile, tag it, and push to registry"
+```
+
+```bash
+json-cli "Execute command in running container and show the output"
+```
+
+```bash
+json-cli "Clean up: remove all stopped containers and unused images"
+```
+
+```bash
+json-cli "Pull latest image, stop existing container, and restart with new image"
+```
+
+```bash
+json-cli "Show running containers, check their resource usage, and display logs"
+```
+
+## File System Examples
+
+```bash
+json-cli "list files in current directory"
+```
+
+```bash
+json-cli "Create a new directory called 'project' and navigate into it"
+```
+
+```bash
+json-cli "Create multiple nested directories: src/components/ui"
+```
+
+```bash
+json-cli "Copy all JavaScript files from src to dist directory"
+```
+
+```bash
+json-cli "Move all log files to logs directory and rename them with timestamp"
+```
+
+```bash
+json-cli "Create empty files: index.js, styles.css, README.md"
+```
+
+```bash
+json-cli "Read package.json and display its contents"
+```
+
+```bash
+json-cli "Remove all temporary files and clean up node_modules"
+```
+
+```bash
+json-cli "Backup important files by copying them to backup directory"
+```
+
+```bash
+json-cli "Create project structure with folders: src, tests, docs, build"
+```
+
+## Git Examples
+
+```bash
+json-cli "Check git status"
+```
+
+```bash
+json-cli "Add all files, commit with message 'feat: add multi-intent support', then push"
+```
+
+```bash
+json-cli "Run tests, check git diff, then git add and commit with message 'fix: catalog types'"
+```
+
+```bash
+json-cli "Install deps, run typecheck, run tests, build, git add, commit with message 'ci: local pipeline passed', push"
+```