> ## Documentation Index
> Fetch the complete documentation index at: https://trytracely.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Modes

Choose between different AI agent modes which each have their own purpose in development

<Frame>
  <img src=" alt="App Agent Mode Dropdown" width="372" height="174" data-path="images/app/App_AgentModeDropdown.png" />
</Frame>

***

## **Agent Mode**

Agent mode lets Tracely apply changes in editor for you instead of only explaining. Use it when you want the assistant to create or edit things. For example: "*Add a platform for my character to stand on*" or "*Add WASD movement scripts and functionality to my character*". In this mode the assistant uses all available tools (create scripts, GameObjects, components, etc.) and focuses on doing the work, not giving step-by-step instructions.

***

## **Debug Mode**

Debug mode is used for diagnosing all problems with your game and codebase. The assistant can read your project and scripts, and it can only use `modify_script` to add or remove `Debug.Log` statements to help trace behavior. It will analyze code, add strategic logs, ask you to run the game and report what you see in the Console, then explain what’s going wrong and tell you to switch to Agent mode if you want it to apply a fix. It will not create GameObjects, add components, or change logic (except to add/remove its own debug logs).

***

## **Ask Mode**

Ask mode is read-only: the assistant can only use tools that read data (scripts, GameObjects, assets, etc.). Use it for questions, explanations, and guidance. For example, ask questions like "*How does this script work?*" or "*What’s the best way to set up a character controller?*" and it will give step-by-step instructions and code examples. If you ask it to make changes, it will explain what it would do and say: "To actually make these changes, please switch to Agent mode."
