Skip to content

File References ​

Type @ in your message to open a fuzzy file picker. Selected files are expanded inline into your prompt, wrapped in fenced code blocks with syntax highlighting.

Usage ​

bash
# Fuzzy search across the project
❯ Refactor @auth_middleware     # opens autocomplete

# Browse a specific directory
❯ Review @lib/src/routes/       # lists files in that dir

# Paths with spaces
❯ Check @"my project/config.yaml"

How It Works ​

  • Fuzzy matching -- exact matches rank first, then prefix matches, then substrings.
  • Directory browsing -- type @dir/ to list contents of a directory.
  • Language detection -- files get syntax tags based on extension (.dart, .ts, .py, .rs, etc.).
  • Smart expansion -- content is wrapped in fenced code blocks, backtick-aware.

Limits ​

LimitValue
Max file size for expansion100 KB
Max tree entries in autocomplete2,000
Max directory depth scanned3 levels
Autocomplete cache TTL2 seconds

WARNING

Files larger than 100 KB are skipped during expansion. Split large files or reference specific sections instead.

See also ​

Released under the MIT License.