:::definition
Una función es continua en $a$ cuando {{? define continuidad con épsilon-delta}}
:::

El teorema fundamental dice que {{?}}

The AI assistant

ComdTeX’s AI assistant is optional and off by default. ComdTeX ships no built-in keys and makes no AI-related network request until you enable it in Settings. If you never touch that toggle, ComdTeX behaves exactly as if the feature did not exist.

It is a “bring your own provider” (BYO) model: you choose the provider, paste your own API key (or point at a local model), and ComdTeX talks directly to that provider.

Supported providers

Provider	What you need	Suggested model
Anthropic (Claude)	Anthropic API key	claude-3-5-sonnet-latest
OpenAI	OpenAI API key	gpt-4o-mini
Google Gemini	Google API key	gemini-1.5-flash
OpenAI-compatible (custom)	Your own base URL (DeepSeek, OpenRouter, LM Studio, local Ollama, etc.)	whatever your endpoint offers
Local agent CLI	An installed terminal command (claude, opencode, etc.)	(not applicable)

The “OpenAI-compatible” preset covers any server that speaks the same shape as the OpenAI chat API, including local engines like Ollama or LM Studio that need no key at all.

Check it works before you need it

Settings has a Test connection button next to the AI fields. It sends the smallest possible real request and tells you which of four things is wrong, because they all look identical until something is actually sent:

What it says	What to fix
The provider refused the key	The key is missing, expired, or belongs to a different provider
The provider does not have that model	The model name, exactly as that provider spells it
No answer at all	The address, and whether the service is running if it is local
That address is not allowed	Use https:// or a local address

When a message fails later, the assistant names the same causes the same way.

Any provider, not a fixed list

ComdTeX reaches your provider through the desktop layer, not the browser layer, so any endpoint reachable over https:// works, including one you host yourself. Earlier versions permitted only a handful of hard-coded hosts, and pointing at anything else failed with nothing useful to show for it.

The safety rule is unchanged, and it is about your key rather than about the host list: an address that is neither https:// nor a local address is refused before the key is ever sent.

Check it works before you need it

Settings has a Test connection button next to the AI fields. It sends the smallest possible real request and tells you which of four things is wrong, because they all look identical until something is actually sent:

What it says	What to fix
The provider refused the key	The key is missing, expired, or belongs to a different provider
The provider does not have that model	The model name, exactly as that provider spells it
No answer at all	The address, and whether the service is running if it is local
That address is not allowed	Use https:// or a local address

When a message fails later, the assistant names the same causes the same way.

Any provider, not a fixed list

ComdTeX reaches your provider through the desktop layer, not the browser layer, so any endpoint reachable over https:// works, including one you host yourself. Earlier versions permitted only a handful of hard-coded hosts, and pointing at anything else failed with nothing useful to show for it.

The safety rule is unchanged, and it is about your key rather than about the host list: an address that is neither https:// nor a local address is refused before the key is ever sent.

Where the API key is stored

The API key you paste in Settings is stored in the OS keychain, not in ComdTeX’s regular configuration file alongside your other preferences. If an older build stored the key somewhere else, ComdTeX migrates it into the keychain automatically the first time you open the app.

Two entry points

The AI panel (Ctrl+Shift+A)

Opens a side conversation with context from the active file or selection. Ask for explanations, rewrites, summaries, or any writing task, and apply the result to the document.

Inline edit (Ctrl+K)

Select text (or place the cursor where you want something inserted), press Ctrl+K, describe the change in a sentence, and the result replaces the selection or is inserted at the cursor.

In both cases, ComdTeX prepends an internal context that teaches the model ComdTeX’s own syntax (shorthands, environments, ::: special blocks), so responses arrive as correct Markdown+LaTeX for the app, not a generic format.

Every AI edit goes through the editor

This is a design guarantee, not a minor detail: no AI edit ever writes directly to disk. Every change (the panel, inline edit, or the gap filling described below) is applied through the Monaco editor, exactly as if you had typed it yourself.

Practical consequences:

• Ctrl+Z undoes any AI change, just as it undoes any other edit.
• ComdTeX never overwrites a file on its own or silently: if you don’t see the change in the editor, it hasn’t happened.
• Regular autosave persists the result, with the same behavior (and the same timing) as a manual edit.

{{?}} gaps: fill on demand

You can leave explicit markers while writing and fill them later, instead of the AI interrupting you with ghost-text autocompletion:

:::definition
A function is continuous at $a$ when {{? define continuity with epsilon-delta}}
:::

The fundamental theorem states that {{?}}

• {{?}}: a bare gap; the AI infers what to write from context.
• {{? a hint}}: with a hint of what you want, up to the }}.

Insert one with Ctrl+P → “Insert gap {{?}}”, and fill with Ctrl+P → “Complete gap with AI” (the one under the cursor) or “Complete all gaps with AI” (the whole document). Requires the assistant enabled and configured, like every other AI feature.

A {{?}} inside a fenced code block (```) is ignored: there it is syntax documentation, not an actual request. Only the block around the gap (about 12 lines on each side) plus your hint is sent to the model, never the whole document.

This is not Copilot-style autocompletion: you decide exactly where the AI is allowed to write, nothing is generated until you explicitly ask for it, and the Tab key stays free to expand shorthands, ComdTeX’s central shortcut.

Base URL validation (SSRF protection)

If you use the “OpenAI-compatible” provider with your own URL, ComdTeX only accepts:

• https://, any origin, or
• http://localhost / http://127.0.0.1 (loopback), for local engines like Ollama.

Any other combination (for example http:// to a remote host) is rejected before your API key is ever sent. This prevents a mistyped or malicious URL from leaking your key to an arbitrary server.

How to use a local model with Ollama

1. Install and start Ollama and pull a model, for example ollama pull llama3.1.
2. In ComdTeX, open Settings → AI assistant and turn on the master switch.
3. Choose the OpenAI-compatible (custom) provider.
4. As the base URL, enter http://localhost:11434/v1.
5. As the model, enter the exact name you pulled, for example llama3.1.
6. No API key is needed for Ollama; the field can stay empty.
7. Open the AI panel (Ctrl+Shift+A) or try an inline edit (Ctrl+K) to confirm it responds.

All of this runs on your machine: no request ever leaves it.