The short answer
The GDSense panel lives in Godot’s upper-right dock and has three main tabs: Chat for requests and responses, History for saved conversations, and Settings for your API key and interface preferences. In Chat, the top controls start a new conversation, choose Chat or Agent when your account supports it, select a reasoning level, insert context commands, and send a request.
Chat is the primary work area
The Chat tab keeps the current conversation, request controls, context indicators, and prompt editor together. Start here for questions, explanations, debugging help, and tasks that use explicitly attached project context.

- + New Chat ends the current conversation and gives the next task a clean thread.
- The mode control keeps Chat available and shows Agent access according to the account.
- The reasoning control offers Standard, Thinking, and Max choices when available.
- Commands inserts @file, @selection, @openscript, @scene, or @node into the prompt.
- Send Request sends the prompt; Enter also sends, while Shift+Enter inserts a new line.
Read the status indicators before sending
The context meter shows how much request capacity the current conversation and attachments use. A separate credit bar shows the remaining account balance for the current billing cycle. Reduce unrelated attachments when the context warning appears.
Keep in mind: Context capacity and account credits answer different questions: one describes how much material fits in the current request, while the other tracks available usage.
History organizes completed conversations
History separates recent chats from favorites. Select an entry to preview it, then load, rename, favorite, or delete it. The panel also exposes import and export controls for GDSense conversation files.
- Recent Chats keeps the latest conversations that are not favorites.
- Favorites preserve conversations you explicitly mark for longer-term reference.
- Load Chat returns a selected conversation to the Chat tab.
- Import and export use GDSense session files so you can move a conversation intentionally.
Settings stores connection and editor preferences
Use Settings to enter the API key, inspect the connection status, and adjust available plugin preferences such as font scaling. Additional controls can appear according to the installed release and account access.
- 1
Connect the account
Paste the API key, choose Save, and read the status beneath the field.
- 2
Adjust readability
Leave Font Scale on Auto or select a fixed size when the dock text needs to be larger or smaller.
- 3
Change one preference at a time
Review the label and any access note before enabling a setting that changes editor behavior.