Update README.md

README.md

@@ -14,6 +14,15 @@ library_name: sentence-transformers
 
 # Shuu12121/Owl-ph2-len2048 🦉
 
+```
+ ██████╗ ██╗    ██╗██╗                ██████╗ ██╗      ██╗
+██╔═══██╗██║    ██║██║               ██╔════╝ ██║      ██║      ,______,
+██║   ██║██║ █╗ ██║██║      ██████╗  ██║      ██║      ██║     ( O v O )
+██║   ██║██║███╗██║██║      ╚═════╝  ██║      ██║      ██║      /  V  \
+╚██████╔╝╚███╔███╔╝███████╗          ╚██████╗ ███████╗ ██║     /(     )\
+ ╚═════╝  ╚══╝╚══╝ ╚══════╝           ╚═════╝ ╚══════╝ ╚═╝      ^^   ^^
+```
+
 ## Model Details
 
 ### Model Description
@@ -39,7 +48,7 @@ SentenceTransformer(
   (0): Transformer({'max_seq_length': 1024, 'do_lower_case': False, 'architecture': 'ModernBertModel'})
   (1): Pooling({'word_embedding_dimension': 768, 'pooling_mode_cls_token': True, 'pooling_mode_mean_tokens': False, 'pooling_mode_max_tokens': False, 'pooling_mode_mean_sqrt_len_tokens': False, 'pooling_mode_weightedmean_tokens': False, 'pooling_mode_lasttoken': False, 'include_prompt': True})
 )
-````
+```
 
 ## Intended Uses
 
@@ -73,22 +82,50 @@ The training set contains approximately **100,000 samples per language**, result
 * **Epochs:** 1
 * **Loss:** MultipleNegativesRankingLoss
 
+---
+
 ## Integrations
 
-### Owl-CLI
+### 🦉 Owl-CLI — Semantic Code Search in Your Terminal
+
+> **Repository:** [https://github.com/Shun0212/Owl-CLI](https://github.com/Shun0212/Owl-CLI)
+
+**Owl-ph2-len2048** is the embedding backbone of **[Owl-CLI](https://github.com/Shun0212/Owl-CLI)**, a command-line tool for semantic code search powered by dense retrieval.
+
+Owl-CLI indexes your codebase at the **function level**, encodes each function using this model, and performs **vector similarity search** to find relevant code for natural language queries — directly from your terminal.
 
-This model is used as the embedding model in **[Owl-CLI](https://github.com/Shun0212/Owl-CLI)**, a command-line tool for semantic code search.
+#### Key Features
 
-Owl-CLI indexes source code at the **function level**, generates dense embeddings using this model, and performs **vector similarity search** to retrieve relevant code for natural language queries.
+| Feature | Description |
+|---|---|
+|  Semantic search | Natural language → relevant functions via dense embeddings |
+|  Function-level indexing | Indexed with file paths and line numbers |
+|  Differential cache | Only re-embeds changed files |
+| JSON output | Easy integration with other tools and scripts |
+|  MCP server support | Plug into AI coding agents (e.g., Claude Code, Cursor) |
 
-Key features of Owl-CLI include:
+#### Example: Query Routing
 
-- **Semantic code search** using dense embeddings
-- **Function-level indexing** with file paths and line numbers
-- **Automatic indexing** on first search
-- **Differential embedding cache** to avoid re-embedding unchanged files
-- **JSON output** for tool integration
-- **MCP server support** for integration with AI coding agents (e.g., Claude Code)
+![example-routing](https://raw.githubusercontent.com/Shun0212/Owl-CLI/main/docs/images/example-routing.png)
+
+#### Example: Interactive Session
+
+![example-session](https://raw.githubusercontent.com/Shun0212/Owl-CLI/main/docs/images/example-session.png)
+
+#### Quick Start
+
+```bash
+# Install
+git clone https://github.com/Shun0212/Owl-CLI.git
+
+# Index your codebase and search
+owl search "function that handles authentication"
+
+# JSON output for tool integration
+owl search "parse config file" --json
+
+# Start MCP server for AI agent integration
+owl mcp
+```
 
-Repository:  
-https://github.com/Shun0212/Owl-CLI
+For full documentation and installation instructions, see the [Owl-CLI repository](https://github.com/Shun0212/Owl-CLI).