diff --git a/README.md b/README.md
index e24f785..36cddaa 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,135 @@
-# shell-memory-cli
+# Shell Memory CLI
 
-A CLI tool that learns from terminal command patterns to automate repetitive workflows
\ No newline at end of file
+A CLI tool that learns from your terminal command patterns to automate repetitive workflows. It records command sequences, detects patterns, suggests time-saving shortcuts, and can generate shell scripts from natural language descriptions.
+
+## Features
+
+- **Command Recording**: Save frequently used commands with descriptions and tags
+- **Pattern Detection**: Automatically detect repeated command sequences and workflows
+- **Command Library**: Personal searchable command library with tagging system
+- **Session Recording**: Record terminal sessions for replay
+- **Script Generation**: Generate shell scripts from natural language descriptions
+
+## Installation
+
+```bash
+# Clone the repository
+cd shell-memory-cli
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Install the package
+pip install -e .
+```
+
+## Quick Start
+
+### Record a Command
+
+```bash
+# Add a command to your library
+shell-memory cmd add "git status" -d "Check repository status" -t git -t vcs
+
+# List all commands
+shell-memory cmd list
+
+# Search for commands
+shell-memory cmd search git
+```
+
+### Detect Patterns
+
+```bash
+# Detect patterns in your command history
+shell-memory pattern detect
+
+# View workflow statistics
+shell-memory pattern stats
+
+# Get suggestions for shortcuts
+shell-memory pattern suggestions
+```
+
+### Record Sessions
+
+```bash
+# Start recording a session
+shell-memory session start my-workflow
+
+# Record commands during the session
+shell-memory session record "cd /path/to/project"
+shell-memory session record "npm install"
+shell-memory session record "npm test"
+
+# Stop recording
+shell-memory session stop
+
+# List all sessions
+shell-memory session list
+
+# Replay a session
+shell-memory session replay 1
+
+# Export session as shell script
+shell-memory session export 1 -o workflow.sh
+```
+
+### Generate Scripts
+
+```bash
+# Generate a shell script from natural language
+shell-memory script generate "deploy application to production"
+
+# List available templates
+shell-memory script templates
+
+# Add a custom template
+shell-memory script add-template deploy production "#!/bin/bash\necho deploying..."
+```
+
+## Configuration
+
+Set environment variables to customize behavior:
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `SHELL_MEMORY_DB` | Path to SQLite database file | `~/.shell_memory/shell_memory.db` |
+| `SHELL_MEMORY_HOME` | Base directory for data | `~/.shell_memory` |
+| `SHELL_MEMORY_VERBOSE` | Enable verbose output | `false` |
+| `SHELL_MEMORY_FORMAT` | Output format (table, json, plain) | `table` |
+
+## Commands Reference
+
+### Command Management (`cmd`)
+
+- `shell-memory cmd add <command>` - Add a command to library
+- `shell-memory cmd list` - List all commands
+- `shell-memory cmd search <query>` - Search commands
+- `shell-memory cmd delete <id>` - Delete a command
+- `shell-memory cmd similar <command>` - Find similar commands
+
+### Pattern Detection (`pattern`)
+
+- `shell-memory pattern detect` - Detect patterns in command history
+- `shell-memory pattern suggestions` - Get workflow shortcuts
+- `shell-memory pattern stats` - View workflow statistics
+
+### Session Recording (`session`)
+
+- `shell-memory session start [name]` - Start recording
+- `shell-memory session record <command>` - Record a command
+- `shell-memory session stop` - Stop and save session
+- `shell-memory session list` - List all sessions
+- `shell-memory session replay <id>` - Replay a session
+- `shell-memory session export <id>` - Export as script
+
+### Script Generation (`script`)
+
+- `shell-memory script generate <description>` - Generate script
+- `shell-memory script templates` - List templates
+- `shell-memory script add-template <keywords> <description> <template>` - Add template
+
+## License
+
+MIT
\ No newline at end of file