fix: restore mcp flexibility and improve cli tooling

README.md

@@ -31,7 +31,8 @@ The OWLEN interface features a clean, multi-panel layout with vim-inspired navig
 - **Advanced Text Editing**: Multi-line input, history, and clipboard support.
 - **Session Management**: Save, load, and manage conversations.
 - **Theming System**: 10 built-in themes and support for custom themes.
-- **Modular Architecture**: Extensible provider system (currently Ollama).
+- **Modular Architecture**: Extensible provider system (Ollama today, additional providers on the roadmap).
+- **Guided Setup**: `owlen config doctor` upgrades legacy configs and verifies your environment in seconds.
 
 ## Getting Started
 
@@ -55,6 +56,8 @@ cargo install --path crates/owlen-cli
 #### Windows
 The Windows build has not been thoroughly tested yet. Installation is possible via the same `cargo install` method, but it is considered experimental at this time.
 
+From Unix hosts you can run `scripts/check-windows.sh` to ensure the code base still compiles for Windows (`rustup` will install the required target automatically).
+
 ### Running OWLEN
 
 Make sure Ollama is running, then launch the application:
@@ -66,9 +69,13 @@ If you built from source without installing, you can run it with:
 ./target/release/owlen
 ```
 
+### Updating
+
+Owlen does not auto-update. Run `owlen upgrade` at any time to print the recommended manual steps (pull the repository and reinstall with `cargo install --path crates/owlen-cli --force`). Arch Linux users can update via the `owlen-git` AUR package.
+
 ## Using the TUI
 
-OWLEN uses a modal, vim-inspired interface. Press `?` in Normal mode to view the help screen with all keybindings.
+OWLEN uses a modal, vim-inspired interface. Press `F1` (available from any mode) or `?` in Normal mode to view the help screen with all keybindings.
 
 - **Normal Mode**: Navigate with `h/j/k/l`, `w/b`, `gg/G`.
 - **Editing Mode**: Enter with `i` or `a`. Send messages with `Enter`.
@@ -83,16 +90,33 @@ For more detailed information, please refer to the following documents:
 - **[docs/architecture.md](docs/architecture.md)**: An overview of the project's architecture.
 - **[docs/troubleshooting.md](docs/troubleshooting.md)**: Help with common issues.
 - **[docs/provider-implementation.md](docs/provider-implementation.md)**: A guide for adding new providers.
+- **[docs/platform-support.md](docs/platform-support.md)**: Current OS support matrix and cross-check instructions.
 
 ## Configuration
 
-OWLEN stores its configuration in `~/.config/owlen/config.toml`. This file is created on the first run and can be customized. You can also add custom themes in `~/.config/owlen/themes/`.
+OWLEN stores its configuration in the standard platform-specific config directory:
+
+| Platform | Location |
+|----------|----------|
+| Linux    | `~/.config/owlen/config.toml` |
+| macOS    | `~/Library/Application Support/owlen/config.toml` |
+| Windows  | `%APPDATA%\owlen\config.toml` |
+
+Use `owlen config path` to print the exact location on your machine and `owlen config doctor` to migrate a legacy config automatically.
+You can also add custom themes alongside the config directory (e.g., `~/.config/owlen/themes/`).
 
 See the [themes/README.md](themes/README.md) for more details on theming.
 
 ## Roadmap
 
-We are actively working on enhancing the code client, adding more providers (OpenAI, Anthropic), and improving the overall user experience. See the [Roadmap section in the old README](https://github.com/Owlibou/owlen/blob/main/README.md?plain=1#L295) for more details.
+Upcoming milestones focus on feature parity with modern code assistants while keeping Owlen local-first:
+
+1. **Phase 11 – MCP client enhancements**: `owlen mcp add/list/remove`, resource references (`@github:issue://123`), and MCP prompt slash commands.
+2. **Phase 12 – Approval & sandboxing**: Three-tier approval modes plus platform-specific sandboxes (Docker, `sandbox-exec`, Windows job objects).
+3. **Phase 13 – Project documentation system**: Automatic `OWLEN.md` generation, contextual updates, and nested project support.
+4. **Phase 15 – Provider expansion**: OpenAI, Anthropic, and other cloud providers layered onto the existing Ollama-first architecture.
+
+See `AGENTS.md` for the long-form roadmap and design notes.
 
 ## Contributing
 
@@ -101,3 +125,4 @@ Contributions are highly welcome! Please see our **[Contributing Guide](CONTRIBU
 ## License
 
 This project is licensed under the GNU Affero General Public License v3.0. See the [LICENSE](LICENSE) file for details.
+For commercial or proprietary integrations that cannot adopt AGPL, please reach out to the maintainers to discuss alternative licensing arrangements.