Skip to main content

Mentions

Type @ in the composer to attach extra context. Placeholder: Ask anything! Type @ for more features... Landmark name: Context mentions.

Arrow keys move, Enter / Tab insert a chip, Esc closes. Enter with the list open never sends the message.

File and folder chips open in the editor (hover shows the path). Provider chips (@diff, @problems, …) do not. Remove a chip with its delete control (Remove mention).

This is not a slash command. / is Slash commands.

List layout​

With an empty query the list is Open (open editors, up to 8 files) then Providers. After you type, sections are Files, Folders, Providers (and Other if needed). Submenus have Back.

Top of the list is capped at 40 rows. Live workspace search starts after two characters, if fewer than 8 path hits are already showing (150 ms debounce, walk cap 200). Ranking prefers open files, then exact basename, prefix / camelCase token, then path match; files beat folders on a tie.

Empty: No files match / Try a file name or path. A truncated walk shows Showing first N files.

Defaults (always on)​

These six are always in the picker after load:

Type @UI titleWhat it attaches
@fileFile | FolderSubmenu: files and folders in the workspace. Same as typing a path after @.
@diffGit DiffCurrent git diff
@problemsProblemsDiagnostics
@repo-mapRepository Structure MapSubmenu: repo map (zoom with a path)
@terminalTerminalTerminal buffer
@memoryProject MemoryQuery Memories (lexical; not a vector store)

Open editors appear under Open without typing @file first.

Knox already sends Turn Context (open files, git, diagnostics) and a workspace card on submit. Mentions are extra, when you want a specific file, diff, or memory.

Opt-in (context: in config)​

These exist in the registry. They show only if you add them under context: in config.yaml (or a loaded package):

currentFile, open, clipboard, commit, tree, search, os, url, serial

They are not on a stock KnoxCoder install.

Integrations (keys / config)​

Never default. Missing required params are skipped (fail closed):

NameNeeds
googleserperApiKey
discorddiscordKey
postgreshost and database
databaseconnections[]
httpurl
issuegithubToken
greptile, web, debuggeran explicit context: entry (runtime may still need tokens)

Do not expect @google or @debugger until you configure them. There is no MCP mention provider.

Cmd+I edit mode​

In inline edit mode these titles are hidden: tree, open, web, diff, folder, search, debugger, repo-map. File mentions still work.

Next​

Composer and context · Slash commands