diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..c889b7e
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,111 @@
+# Changelog
+
+### 0.5.5
+
+- Ask Mode: a streamlined prompt-first interaction mode with improved transcript rendering.
+- New session commands: `auggie session list` and `auggie session resume` to manage and continue sessions.
+- MCP quality-of-life: simpler `mcp add` syntax, automatic migration of legacy settings, and a `/status` check.
+- Add Ask Mode for CLI/TUI, with formatting and input history improvements.
+- Add `auggie session list` and `auggie session resume` commands.
+- Add `--permission` flag to configure tool permissions at runtime.
+- Support compressed syntax for `mcp add` and auto-migrate legacy MCP settings.json format.
+- Add `/status` command to check MCP and rules status.
+- Add `--max-turns` to cap agent iterations in print mode.
+- Add basic JSON output mode.
+- Improve keyboard handling: Ctrl+C to clear input, Ctrl+D forward delete; fix Delete key acting as Backspace.
+- Improve non-interactive error messages when auth is missing.
+- Fix crash when denying indexing by properly initializing status messaging.
+- Fix markdown list indentation in TUI output.
+- Fixed issue where rules were dropped when combined content was too long.
+- MCP settings now use a record-based schema; legacy formats auto-migrate on run.
+
+### 0.5.4
+
+- Manage Model Context Protocol (MCP) servers with `auggie mcp add|list|remove`
+- Configure MCP servers in your settings file (`~/.augment/settings.json`) or via a config file passed with `--mcp-config`
+- Skip waiting for indexing to complete before codebase retrieval executes in TUI mode
+- If API requests are retried, the CLI shows a clear message so you know what's happening
+- Interrupting an operation now cleans up any partial output to keep the screen tidy
+- Custom slash command help text now shows the selected model; logging and parsing are consistent in both interactive and non‑interactive modes
+- Session tracking is more reliable between the CLI and the API
+- Authentication works correctly when you provide both an API token and an API URL
+- On Windows, home‑directory detection across different drives has been fixed to avoid incorrect indexing
+
+### 0.5.3
+
+- Non-interactive slash command syntax: Run custom commands directly from the shell with `auggie /<command> ...` (e.g., `auggie "/joke robot" -p`)
+- Indexing is now enabled by default in print mode, with a safety guard that disables indexing when running from your home directory to avoid accidentally uploading your entire home folder
+
+### 0.5.2
+
+- Custom commands can now specify which AI model to use in their frontmatter configuration
+- Slash commands can be run directly from the command line (e.g., `auggie /help`)
+- Improved paste functionality on Windows and support for Chinese character input
+- Enhanced feedback submission with proper handling of bracketed paste
+- Quiet mode (`--quiet`) now automatically defaults to text output mode
+- Empty agent responses are no longer displayed in the CLI interface
+- CLI continues gracefully when settings fail to load instead of crashing
+- Invalid MCP configuration no longer causes crashes
+- Added workspace size limits to prevent indexing excessively large directories
+- Fixed typo: "enchance" → "enhance" in prompt enhancer
+
+### 0.5.1
+
+- Added ability to edit existing tool permission rules without recreating them (press 'e' to edit)
+- Improved tool permissions UI with better visual hierarchy and clearer permission types display
+- Simplified permissions management
+- Added long help text that can be toggled with '?' in Normal mode
+- Fixed Ctrl+C and double escape shortcuts to work properly in vim mode
+- Automatically enter INSERT mode when typing `/vim` command
+- Cleaned up vim mode help text for better clarity
+- Added slash commands to the history manager for easier command recall
+- Fixed command exit behavior - commands like `model list`, `tokens print`, and `session delete` now properly exit after completion
+- Prevented indexing when running CLI from home directory to avoid performance issues
+- Fixed git worktree detection
+- Limited @ file cache size to prevent performance degradation when opened in large directories
+- Display default model in brackets when no model is explicitly selected
+- Updated onboarding messages and tips for better user experience
+
+### 0.5.0
+
+- Added `/editor` command to compose prompts in your preferred external editor (VS Code, vim, nano, etc.)
+- Added `Ctrl+O` keyboard shortcut for quick access to external editor
+- Added current AI model name display in the status line footer
+- Added `j/k` keyboard navigation support for all menus (Task List, Model Picker, GitHub workflow)
+- Improved popover heights for better visibility on smaller screens
+- Fixed footer wrapping issues on narrow terminal widths
+- Added `/verbose` command to toggle between compact and detailed transcript views
+- Fixed verbose command toggle to properly apply changes in the current session
+- Improved help text with dynamic command listing and better keyboard shortcut documentation
+- Enhanced onboarding experience with clearer feature descriptions
+- Implemented comprehensive theme-based system across markdown, tool formatters, and status indicators
+- Reduced flicker in iTerm when opening/closing popovers
+- Added smart git update events with file tracking for better performance
+- Improved error handling in str-replace-editor tool to detect when old and new strings are the same
+- Enhanced settings management with structured return types and better error handling
+- Fixed double @ appearing in file picker mode
+- Fixed indexing confirmation to wait before initializing runtime
+- Fixed tool permission type display for "ask-user" permissions
+- Corrected typos and improved help text clarity
+- Fixed clipboard functionality with proper feedback and error handling
+- Enhanced scrollable list components for better handling of long item lists
+
+### 0.4.0
+
+- Added support for custom slash commands (`/<command>`) in interactive mode and `--command` flag in non-interactive mode
+- Support for nested custom commands using colon separator (e.g., `nested:command`)
+- Custom commands can be defined in `.augment/commands` or `~/.augment/commands` directories
+- Added tab completion for slash commands in interactive mode
+- Custom commands from Claude Code are now automatically detected and imported
+- Added detailed help section for `--command` flag with `auggie --command --help`
+- Added shorthand flags for common options: `-i` (input), `-if` (input-file), `-p` (prompt), `-q` (query), `-lm` (list-models), `-m` (model), `-cm` (command)
+- Added user settings support via `~/.augment/settings.json` for persistent model preferences
+- Support for CLAUDE.md and AGENTS.md configuration files in addition to .augment/guidelines.md
+- Settings are validated with schema and gracefully handle malformed JSON
+- Added prompt enhancement via Ctrl+P in interactive mode to improve prompts using AI
+- Improved navigation in input box with Option+Left/Right for word navigation
+- Enhanced multi-line prompt navigation with up/down arrows
+- Added repository and branch information badges to agent cards
+- Improved select menu system with better modularity and pagination support
+- Fixed regression in input history and cursor movement in interactive mode
+- Fixed extraneous border display on successful side effects with green border