Merge pull request #31 from AnswerDotAI/devin/1738701021-enhance-docs-and-tmux

feat: enhance tmux config and documentation

Author: ncoop57

.tmux.conf

@@ -3,6 +3,36 @@ set -g status-right '#{pane_id} | %H:%M '
 set-option -g alternate-screen off
 
 set-window-option -g mode-keys vi
+
+# Pane splitting (keep current path)
+bind-key / split-window -h -c "#{pane_current_path}"
+bind-key - split-window -v -c "#{pane_current_path}"
+
+# Window management
+bind-key -n M-n new-window -c "#{pane_current_path}"
+bind-key -n M-1 select-window -t 1
+bind-key -n M-2 select-window -t 2
+bind-key -n M-3 select-window -t 3
+bind-key -n M-4 select-window -t 4
+bind-key -n M-5 select-window -t 5
+
+# Pane navigation (vim-style)
+bind-key -n M-h select-pane -L
+bind-key -n M-j select-pane -D
+bind-key -n M-k select-pane -U
+bind-key -n M-l select-pane -R
+
+# Pane resizing
+bind-key -n M-H resize-pane -L 5
+bind-key -n M-J resize-pane -D 5
+bind-key -n M-K resize-pane -U 5
+bind-key -n M-L resize-pane -R 5
+
+# Session management
+bind-key -n M-s choose-session
+bind-key -n M-d detach-client
+
+# Copy mode and search
 bind-key / copy-mode\; send-key ?
 bind-key -T copy-mode-vi y \
   send-key -X start-of-line\; \
@@ -11,4 +41,6 @@ bind-key -T copy-mode-vi y \
   send-key -X cursor-left\; \
   send-key -X copy-selection-and-cancel\; \
   paste-buffer
+
+# Clear history
 bind-key -n C-l send-keys C-l \; send-keys -R \; clear-history

README.md

@@ -173,6 +173,60 @@ ssage --provider openai --model gpt-4o-mini "explain this error"
 ssage --history-lines 50 "what commands did I just run?"
 ```
 
+### Advanced Use Cases
+
+#### Git Workflow Enhancement
+
+``` sh
+# Review changes before commit
+git diff | ssage summarize these changes
+
+# Get commit message suggestions
+git diff --staged | ssage suggest a commit message
+
+# Analyze PR feedback
+gh pr view 123 | ssage summarize this PR feedback
+```
+
+#### Log Analysis
+
+``` sh
+# Quick error investigation
+journalctl -xe | ssage what's causing these errors?
+
+# Apache/Nginx log analysis
+tail -n 100 /var/log/nginx/access.log | ssage analyze this traffic pattern
+
+# System performance investigation
+top -b -n 1 | ssage explain system resource usage
+```
+
+#### Docker Management
+
+``` sh
+# Container troubleshooting
+docker logs my-container | ssage "what is wrong with this container?"
+
+# Image optimization
+docker history my-image | ssage suggest optimization improvements
+
+# Compose file analysis
+cat docker-compose.yml | ssage review this compose configuration
+```
+
+#### Database Operations
+
+``` sh
+# Query optimization
+psql -c "EXPLAIN ANALYZE SELECT..." | ssage optimize this query
+
+# Schema review
+pg_dump --schema-only mydb | ssage review this database schema
+
+# Index suggestions
+psql -c "\di+" | ssage suggest missing indexes
+```
+
 ## Tips & Best Practices
 
 ### Effective Usage Patterns

nbs/index.ipynb

@@ -7,9 +7,14 @@
    "source": [
     "# ShellSage\n",
     "\n",
-    "> ShellSage saves sysadmins’ sanity by solving shell script snafus super swiftly\n",
+    "> ShellSage saves sysadmins' sanity by solving shell script snafus super swiftly\n",
     "\n",
-    "ShellSage is an AI-powered command-line assistant that integrates seamlessly with your terminal workflow through tmux. It provides contextual help for shell operations, making it easier to navigate complex command-line tasks, debug scripts, and manage your system."
+    "ShellSage is an AI-powered command-line assistant that integrates seamlessly with your terminal workflow through tmux. It provides contextual help for shell operations, making it easier to navigate complex command-line tasks, debug scripts, and manage your system.\n",
+    "\n",
+    "[![PyPI version](https://badge.fury.io/py/shell-sage.svg)](https://badge.fury.io/py/shell-sage)\n",
+    "[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)\n",
+    "[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n",
+    "[![Documentation](https://img.shields.io/badge/docs-nbdev-blue.svg)](https://answerdotai.github.io/shell_sage/)"
    ]
   },
   {
@@ -192,6 +197,62 @@
     "```"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "47d6bfb8",
+   "metadata": {},
+   "source": [
+    "### Advanced Use Cases\n",
+    "\n",
+    "#### Git Workflow Enhancement\n",
+    "```sh\n",
+    "# Review changes before commit\n",
+    "git diff | ssage summarize these changes\n",
+    "\n",
+    "# Get commit message suggestions\n",
+    "git diff --staged | ssage suggest a commit message\n",
+    "\n",
+    "# Analyze PR feedback\n",
+    "gh pr view 123 | ssage summarize this PR feedback\n",
+    "```\n",
+    "\n",
+    "#### Log Analysis\n",
+    "```sh\n",
+    "# Quick error investigation\n",
+    "journalctl -xe | ssage what's causing these errors?\n",
+    "\n",
+    "# Apache/Nginx log analysis\n",
+    "tail -n 100 /var/log/nginx/access.log | ssage analyze this traffic pattern\n",
+    "\n",
+    "# System performance investigation\n",
+    "top -b -n 1 | ssage explain system resource usage\n",
+    "```\n",
+    "\n",
+    "#### Docker Management\n",
+    "```sh\n",
+    "# Container troubleshooting\n",
+    "docker logs my-container | ssage \"what is wrong with this container?\"\n",
+    "\n",
+    "# Image optimization\n",
+    "docker history my-image | ssage suggest optimization improvements\n",
+    "\n",
+    "# Compose file analysis\n",
+    "cat docker-compose.yml | ssage review this compose configuration\n",
+    "```\n",
+    "\n",
+    "#### Database Operations\n",
+    "```sh\n",
+    "# Query optimization\n",
+    "psql -c \"EXPLAIN ANALYZE SELECT...\" | ssage optimize this query\n",
+    "\n",
+    "# Schema review\n",
+    "pg_dump --schema-only mydb | ssage review this database schema\n",
+    "\n",
+    "# Index suggestions\n",
+    "psql -c \"\\di+\" | ssage suggest missing indexes\n",
+    "```"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "73adb8a7",