Skip to content

Commit 6c7e664

Browse files
docs: keep custom model guidance concise
1 parent 358f309 commit 6c7e664

3 files changed

Lines changed: 15 additions & 36 deletions

File tree

‎docs/internals/glossary.md‎

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -33,16 +33,15 @@ Terms whose meaning matters across T3 Code. Architecture and lifecycle constrain
3333

3434
## Providers and checkpoints
3535

36-
| Term | Meaning |
37-
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
38-
| Provider | The agent runtime T3 Code controls, such as Codex or Claude Code. |
39-
| Driver | The integration for a provider kind. |
40-
| Provider instance | One configured provider, with its own settings and lifecycle. Multiple instances can use the same driver. |
41-
| Adapter | The boundary translating a provider's native protocol into T3 Code operations and events. |
42-
| Session | The provider runtime attached to a thread. A session can be stopped and resumed without deleting the thread. |
43-
| Runtime mode | The thread's permission policy. See [permission modes](../user/permission-modes.md). |
44-
| Interaction mode | How the agent approaches the task, such as planning. Separate from permission policy. |
45-
| Checkpoint | A saved workspace state used for diffs and restore, stored as a hidden Git ref. |
46-
| Checkpoint baseline | The workspace state captured before the work being compared. |
47-
| Turn diff | The workspace changes attributed to one turn. |
48-
| Custom model entry | A user-authored model slug with optional display name and option descriptors, scoped to a provider instance. See [custom models](./providers.md#custom-models). |
36+
| Term | Meaning |
37+
| ------------------- | ------------------------------------------------------------------------------------------------------------ |
38+
| Provider | The agent runtime T3 Code controls, such as Codex or Claude Code. |
39+
| Driver | The integration for a provider kind. |
40+
| Provider instance | One configured provider, with its own settings and lifecycle. Multiple instances can use the same driver. |
41+
| Adapter | The boundary translating a provider's native protocol into T3 Code operations and events. |
42+
| Session | The provider runtime attached to a thread. A session can be stopped and resumed without deleting the thread. |
43+
| Runtime mode | The thread's permission policy. See [permission modes](../user/permission-modes.md). |
44+
| Interaction mode | How the agent approaches the task, such as planning. Separate from permission policy. |
45+
| Checkpoint | A saved workspace state used for diffs and restore, stored as a hidden Git ref. |
46+
| Checkpoint baseline | The workspace state captured before the work being compared. |
47+
| Turn diff | The workspace changes attributed to one turn. |

‎docs/internals/providers.md‎

Lines changed: 0 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -72,19 +72,6 @@ checkpoints but cannot roll back its conversation. The [checkpoint boundary](./o
7272
therefore rejects revert before touching files. Native permission and question option IDs must
7373
also survive normalization; a display label is not necessarily a valid reply.
7474

75-
## Custom models
76-
77-
Provider settings accept legacy bare model slugs or `{ slug, name?, capabilities? }` entries.
78-
The [shared reader](../../packages/shared/src/model.ts) normalizes both forms, and snapshots use
79-
custom names and descriptors while preserving built-in models on slug collisions. Missing
80-
capabilities retain the driver's defaults.
81-
82-
Claude adds custom entries with capabilities to its instance-scoped catalog so effort and toggle
83-
lookups can resolve them. Custom entries have no built-in runtime profile, so copying descriptors
84-
does not copy model suffix mappings or prompt injection. The editor excludes prompt-injected
85-
choices when copying a built-in model. Arbitrary option ids can render in the composer, but each
86-
adapter still decides which ids it forwards and how.
87-
8875
## Attachments and stored history
8976

9077
Attachments live outside the project workspace. [ProviderService](../../apps/server/src/provider/Layers/ProviderService.ts)

‎docs/user/composer.md‎

Lines changed: 3 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -32,16 +32,9 @@ device until you sign back into the same account.
3232

3333
## Custom models
3434

35-
On web and desktop, open Settings → Providers → **Models** to add a model slug the provider does
36-
not list, such as a preview build. Antigravity only uses models from its account catalog and does
37-
not support adding custom models.
38-
39-
A custom model shows up in the picker under its slug until you edit it. The pencil next to it opens
40-
an editor for a display name and the options the composer should offer, such as reasoning choices
41-
or an on/off toggle. Presets suggest option ids, and **Copy from…** starts from a built-in model's
42-
options. You can edit the ids, labels, and values freely, but only options supported by the provider
43-
integration affect a turn. Clearing the name and options returns the model to a plain slug with the
44-
provider's default options.
35+
On web and desktop, use Settings → Providers → **Models** to add an unlisted model with a custom
36+
name and options. Only options supported by the provider integration affect turns. Antigravity
37+
uses its account catalog and does not support custom models.
4538

4639
## Model defaults
4740

0 commit comments

Comments
 (0)