diff --git a/README.md b/README.md
index 5e3b430..022ca8d 100644
--- a/README.md
+++ b/README.md
@@ -6,11 +6,29 @@ A desktop GUI for [TaskWarrior](https://taskwarrior.org/) built with [GPUI](http
 
 ## Features
 
-- View and filter tasks by project, status, priority, and due date
-- Project tree with task counts
-- Tag filtering with multi-select
-- Sortable task table with pagination
-- Dark theme (Ayu-inspired)
+### Task Management
+- **Create, Edit, Delete**: Full CRUD operations with keyboard shortcuts and mouse support
+- **View Task Details**: Rich modal view with complete task information and metadata
+- **Annotations**: Add, edit, copy, and delete annotations with visual feedback
+- **Smart Autocomplete**: Hierarchical project suggestions and tag filtering
+
+### Navigation & Filtering
+- **Project Tree**: Collapsible tree view with task counts and keyboard navigation
+- **Tag Filtering**: Multi-select tag filtering with task counts
+- **Advanced Filters**: Filter by status, priority, due date, and search text
+- **Sortable Table**: Click headers or use keyboard to sort by any column
+
+### Keyboard-First Design
+- **Complete Keyboard Navigation**: Navigate the entire UI without touching the mouse
+- **Context-Aware Shortcuts**: Different shortcuts for different contexts (table, modal, filters)
+- **Vim-Like Bindings**: `j`/`k` navigation, `h`/`l` for horizontal movement
+- **Modal Edit Mode**: Full keyboard workflow for editing with undo/redo support
+
+### Visual Polish
+- **Dark Theme**: Ayu-inspired color scheme optimized for readability
+- **Toast Notifications**: Non-intrusive feedback for actions
+- **Smooth Scrolling**: GPU-accelerated rendering for buttery-smooth performance
+- **Pagination**: Navigate large task lists efficiently
 
 ## Requirements
 
@@ -33,6 +51,36 @@ cargo install --path .
 
 The application will use your existing TaskWarrior data directory.
 
+## Quick Start
+
+### Keyboard Shortcuts
+
+| Action | Shortcut |
+|--------|----------|
+| Create task | `c` |
+| Edit task | `e` |
+| Delete task | `Delete` |
+| View task | `Enter` |
+| Navigate | `j`/`k` or arrow keys |
+| Focus search | `Ctrl+F` |
+| Sync tasks | `Ctrl+R` |
+| Close modal | `Escape` |
+
+For a complete list of keyboard shortcuts, see [docs/keyboard-shortcuts.md](docs/keyboard-shortcuts.md).
+
+### Basic Workflow
+
+1. **View Tasks**: Tasks are displayed in the main table with filtering options at the top
+2. **Create Task**: Press `c` or click "+ New" button, fill in details, and save with `Ctrl+S`
+3. **Edit Task**: Select a task and press `e`, or double-click to view then press `e`
+4. **Filter**: Use the sidebar to filter by project/tag, or use the filter bar for more options
+5. **Sync**: Press `Ctrl+R` to sync changes with TaskWarrior
+
+## Documentation
+
+- [Keyboard Shortcuts](docs/keyboard-shortcuts.md) - Complete keyboard shortcut reference
+- [Keymap Guide](docs/keymap.md) - Understanding the keymap system and adding custom bindings
+
 ## License
 
 MIT OR Apache-2.0