Xeref's IDE-native coding agent — chat, sessions, and approval-gated edits in your editor.
Connect your Xeref account, open the Agent Panel, and start chatting with your codebase — Xeref proposes diffs you review before anything changes.
Features
- Agent Panel — full chat interface inside VS Code. Ask questions, request edits, or kick off multi-step tasks without leaving your editor.
- Agent Manager — manage multiple Xeref agents and switch context between
them (
Ctrl+E/Cmd+E). - Sessions tree — browse and resume past code sessions from the Xeref activity-bar sidebar.
- Approval-gated edits — Xeref proposes file diffs; you accept or reject each one. Nothing is applied automatically (unless you opt in via settings).
- Send selection — right-click any highlighted code and choose "Xeref: Send Selection to Agent" to send it straight to the active session.
- Secure token storage — your Xeref API token is stored in VS Code SecretStorage (never in plain settings).
Getting Started
- Install the extension.
- Open the Command Palette (
Ctrl+Shift+P/Cmd+Shift+P) and run Xeref: Connect Account. - Paste your Xeref API token (get one at xeref.ai).
- Press
Ctrl+L/Cmd+Lto open the Agent Panel and start a session.
Keybindings
| Action | Windows / Linux | macOS |
|---|---|---|
| Open Agent Panel | Ctrl+L |
Cmd+L |
| Open Agent Manager | Ctrl+E |
Cmd+E |
Note:
Ctrl+LandCtrl+Eare scoped withwhen: "!terminalFocus"so they don't interfere with terminal usage. If they still conflict with your setup, rebind them in File › Preferences › Keyboard Shortcuts.
Settings
| Setting | Default | Description |
|---|---|---|
xeref.endpoint |
https://xeref.ai |
Xeref API base URL |
xeref.defaultModel |
xeref-free |
Default model id (must be allowed by your plan) |
xeref.autoApplyEdits |
false |
Apply agent edits without per-diff approval (not recommended) |
xeref.runtime.enabled |
true |
Enable the local runtime bridge for file edits and commands |
Compatibility
Works in VS Code, Cursor, and Antigravity IDE.
Links
Made by Bugra Karsli