Settings Reference
Agent & completions
Section titled “Agent & completions”| Setting | Default | What it does |
|---|---|---|
agent.maxSteps |
0 (unlimited) |
Caps how many steps one agent run can take before stopping on its own. |
agent.autoApprove |
false |
Skips the approval prompt for every file write, terminal command, and MCP tool call during agent runs. Use with caution. |
agent.protocolRetries |
2 |
How many times the agent retries when a model’s reply isn’t valid — weaker/local models drift out of the expected format more often. Raise this if you’re using a small local model and see frequent protocol-error messages. |
completions.enabled |
true |
Turns ghost-text inline completions on or off. |
Model & provider configuration
Section titled “Model & provider configuration”Model selections (active chat model, embedding model, per-role overrides)
and provider configuration live in ~/.xpreiide/config.yaml, not editor
settings — see Getting Started. API keys are
never stored in that file; they live in your OS’s secure credential store.
Ignore file
Section titled “Ignore file”.xpreiIDEignore — one pattern per line, .gitignore-style syntax (#
comments, blank lines ignored, * within a path segment, ** across
segments, a pattern containing / anchors to the workspace root, a
pattern without / matches at any depth). Use it to keep extra paths out
of the codebase index — generated files, large data directories, anything
you don’t want the model reading via @codebase. This adds to, not
replaces, the built-in exclusions (node_modules, .git, dist, and
similar are always excluded regardless of this file). Affects the
codebase index, @open, and @repomap — not the agent’s file-search
tools. Not a full .gitignore implementation: ! negation and backslash
escaping aren’t supported.
Keyboard shortcuts
Section titled “Keyboard shortcuts”| Shortcut | Action |
|---|---|
| Ctrl/Cmd-K | Inline edit on the current selection |
| Enter (while an inline edit diff is showing) | Accept the inline edit |
| Esc (while an inline edit diff is showing) | Reject the inline edit |
| Ctrl-I | Inline chat popup |
Every other action (selecting a model, rebuilding the index, reverting an agent run, etc.) is available via the Command Palette, searching for “xpreiIDE”.