@ Mentions

@ Mentions let you bring files, folders, and terminal output directly into the conversation context — no copy-pasting needed.

Type @ in the chat input to open the mentions menu. It opens with your recently opened files at the top, followed by workspace folders and files. Keep typing to search: matching is fuzzy (like Quick Open), so @conf finds config folders and files such as vite.config.ts anywhere in the workspace, and recently opened files that match stay pinned above the other results.

Mention Types

Files

Syntax: @/path/to/file or @"/path with spaces/file.ts"

Kodik includes the full contents of the file in context. Paths are relative to the workspace root.

Folders

Syntax: @/path/to/folder

Kodik includes the listing of the folder. Folder mentions are treated separately from file mentions (internal tag @folder:): clicking one in the panel opens the folder in the file explorer rather than opening a file.

Line ranges

A line range can be appended to any file mention:

• Single line: @/src/index.ts#L42
• Range: @/src/index.ts#L10-L50

The #L... suffix tells the agent which part of the file is most relevant, and is also used for navigation (the file opens at that line).

Terminals

Syntax: @terminal:<terminal name>

Attaches the output of the running terminal with the given name. Kodik captures up to 200 of the most recent lines from the terminal scrollback. If no terminal with that name is found, or its buffer is empty, this is indicated explicitly in context.

Open @ and choose Terminal to see the currently open integrated terminals. The list updates as terminals open, close, or receive their shell title, so a newly opened terminal is available immediately without sending a message first.

Examples: @terminal:bash, @terminal:npm run dev

Files and Images

Use the chat input’s Add files button to attach local files and images. If the picker cannot complete, Kodik reports the failure instead of silently adding no attachments.

How mentions are processed

When you send a message, Kodik processes all mentions and builds a <user_mentions> section in the context. File and folder mentions are passed as paths relative to the workspace root, with their type preserved explicitly:

<user_mentions>
  <file>src/api/users.ts</file>
  <folder>src/components</folder>
  <terminal>npm run dev</terminal>
</user_mentions>

This lets the agent distinguish folders from extensionless files without guessing from the path and preserves which terminal you selected. Files blocked by .kodikignore are excluded from context.

The selected terminal’s transcript is delivered separately in <terminal_context>; <user_mentions> carries only its typed identity.

Example usage

I'm getting an error in @/src/api/users.ts#L34-L56

Here is the config: @/vite.config.ts

Build output: @terminal:npm run build

Check the whole structure: @/src/components

Getting Started

1. Type @ in the chat input.
2. Select a mention type from the menu, or keep typing the path.
3. Send your message as usual.

Kodik automatically processes the mentions and includes the referenced content before calling the model.