README.md in chronicle-shell-0.2.2 vs README.md in chronicle-shell-0.2.3
- old
+ new
@@ -1,19 +1,25 @@
# Chronicle::Shell
+[](https://badge.fury.io/rb/chronicle-shell)
Shell importer for [chronicle-etl](https://github.com/chronicle-app/chronicle-etl)
## Available Connectors
### Extractors
-- `shell-history` - Extract shell history from bash or zsh
+- `shell:history` - Extract shell history from bash or zsh
### Transformers
-- `shell-history` - Process a shell command
+- `shell:history` - Turn a shell command into Chronicle Schema
-## Usage
+## Usage and examples
```bash
+# install chronicle-etl and then this plugin
gem install chronicle-etl
chronicle-etl plugins:install shell
-chronicle-etl --extractor shell-history --since "2022-02-07" --transformer shell-history --loader table
+# output commands since Feb 7 as json
+chronicle-etl --extractor shell:history --transformer shell:history --since "2022-02-07" --loader json
+
+# Show recent commands sorted by frequency of use
+chronicle-etl --extractor shell:history --limit 500 --fields command --silent | sort | uniq -c | sort -nr
```