@-mentions

Type @ in the planner to attach files, symbols, folders, git context, errors, or specific code ranges to your prompt.

How it works

Type @ anywhere in the composer. A floating picker opens with six categories:

Glyph	Category	Syntax
📄	File	`@file:path/to/file.py`
🔣	Symbol	`@symbol:function_name`
📁	Folder	`@folder:path/to/dir`
🌿	Git	`@git:status` / `@git:diff` / `@git`
⚠	Error	`@error:latest` / `@error`
✂	Code range	`@code:path:120-180`

Type to filter. Arrow keys to navigate. Enter to insert.

The mention renders as a chip in the composer ([@file:auth.py]). At send time, KrowForge resolves the chip — pulls the file content, the symbol's body, the git diff, etc. — and prepends that resolved context to the model's prompt.

File mentions

@file:services/auth.py injects the entire file content (up to 50 KB per mention).

Files you've recently mentioned float to the top of the picker with a ★ glyph.

Multiple file mentions in the same task are deduped automatically.

Symbol mentions

@symbol:validate_user searches the symbol index for matching functions/classes. Up to 8 matches are listed with file:line. Selecting one injects the symbol's source body ± 18 context lines.

Folder mentions

@folder:routes/ walks the folder, skips ignored directories (node_modules, .git, etc.), and injects up to 24 textlike files (8 KB each, 50 KB total per mention).

Git mentions

@git:status — output of git status --short.
@git:diff — output of git diff (unstaged changes, 40 KB cap).
@git (no qualifier) — both.

Only works in workspaces that have a .git directory.

Error mentions

@error:latest — the most recent error frame from the run buffer.
@error — same as above.

Useful for the pattern: "I just got this error. Why?"

Code range mentions

@code:services/auth.py:120-180 injects exactly those lines.

The picker has a two-step UI: pick the file first, then a range slider showing the file's line count. Live preview of the selected lines.

Caps & dedup

Per-mention cap: 50 KB (file/folder), 40 KB (git), 8 KB × 24 (folder fan-out).
Per-task total cap: enforced by the budget estimate. Mentions that would push past the cap are flagged red.
Identical mentions deduplicate (one file mentioned twice = one inject).

When mentions are most valuable

"Refactor @file:services/auth.py to use bcrypt" — gives the agent the exact file.
"What does @symbol:validate_user do, and where is it called?" — agent gets the symbol body + can grep for callers.
"Why is @error:latest happening?" — agent gets the actual error.
"Update tests for the changes in @git:diff" — agent sees what just changed.