# Start interactive mode
praisonai chat

# Include a file in your prompt
❯ @main.py explain this code

# Include a directory listing
❯ @src/ what files are in this directory?

# Multiple @ mentions
❯ @config.yaml @main.py compare these files

┌─────────────────────────────────────────────────────────────┐
│                    @ Mention Flow                            │
├─────────────────────────────────────────────────────────────┤
│  1. User types @                                             │
│     ↓                                                        │
│  2. Autocomplete shows matching files/directories            │
│     ↓                                                        │
│  3. User selects or types full path                          │
│     ↓                                                        │
│  4. On submit, file content is injected into prompt          │
│     ↓                                                        │
│  5. LLM receives prompt + file content                       │
└─────────────────────────────────────────────────────────────┘

❯ @main
  📄 main.py
  📄 main_test.py
  📁 main/

❯ @README.md summarize this file
📄 Included: README.md (5432 chars)

# Summary of README.md
...

❯ @src/ what's in this directory?
📁 Listed: src/ (15 items)

--- Directory listing of src/ ---
  main.py
  utils.py
  config.yaml
  tests/
--- End of src/ ---

❯ @package.json @tsconfig.json compare these configs

📄 Included: package.json (1234 chars)
📄 Included: tsconfig.json (567 chars)

# Comparison
...

from praisonai.cli.features import FileSearchService, CombinedCompleter

# File search service
service = FileSearchService(
    root_dir="/path/to/project",
    cache_ttl=30,  # seconds
    max_depth=5
)

# Search for files
results = service.search("main", max_results=20)
for result in results:
    print(f"{result.file_type}: {result.path} (score: {result.score})")

# Combined completer for prompt_toolkit
completer = CombinedCompleter(
    commands=["help", "exit", "queue"],
    root_dir="/path/to/project"
)

from praisonai.cli.features.at_mentions import detect_at_mention

# Detect @ mention context
context = detect_at_mention("read @src/main.py", cursor_pos=17)
if context and context.is_active:
    print(f"Query: {context.query}")  # "src/main.py"
    print(f"Start: {context.start_pos}")  # 5