Agent profiles
Agent Profiles define which agent a new Faheem Code conversation runs with. A profile can use the built-in Faheem Code agent or an ACP agent such as Claude Code, Codex, or Gemini CLI.
The active Agent Profile is the default agent for new conversations.
Agent profiles vs LLM profiles
Agent Profiles and LLM profiles control different layers:
| Profile Type | Controls | Where to Manage |
|---|---|---|
| Agent Profile | Which agent runs the conversation and the agent-specific configuration | Settings > Agent |
| LLM Profile | Which LLM provider, model, and credentials an Faheem Code agent uses | Settings > LLM |
Faheem Code Agent Profiles reference an LLM profile. ACP Agent Profiles use the external agent's own model and authentication flow instead.
Manage agent profiles
Open Settings > Agent to manage the Agent Profile library.
From this page, you can:
- Create an Faheem Code or ACP Agent Profile
- Rename a profile
- Edit profile settings
- Set a profile as active
- Delete profiles you no longer need
When you set a profile as active, new conversations use that profile by default.
Choose an agent profile for a conversation
Before starting a conversation, you can open the + tools menu in the chat launcher and select Switch agent profile. Choose an Agent Profile to switch to that agent, and use it for the new conversation.
The LLM Model selector always remains visible in the chat launcher and allows you to select from any available LLM that the current Agent Profile supports. Once a conversation is started with an Agent Profile you are unable to switch to a different Agent Profile during the conversation.
Faheem Code profiles
Use an Faheem Code profile when you want Faheem Code to run the built-in Faheem Code agent.
An Faheem Code profile references an LLM profile, so model and credential changes are managed in Settings > LLM. Use this when you want Faheem Code to own both the agent behavior and the model configuration.
Let the agent switch LLM profiles
The Faheem Code profile editor includes a "Let the agent switch LLM profiles" toggle. When enabled, the agent is given the SwitchLLMTool, which lets it switch between available LLM profiles during a conversation. When disabled, the tool is removed from the agent's toolset.
This toggle is version-gated: it appears only when the connected backend reports agent-server 1.31.0 or later. On older backends (for example, agent-server 1.29.0–1.30.x) the toggle is hidden.
ACP profiles
Use an ACP profile when you want Faheem Code to drive an external coding agent through the Agent Client Protocol.
ACP profiles are useful for agents such as:
- Claude Code
- Codex
- Gemini CLI
- a custom ACP server
The external ACP agent owns its own model and tool behavior. Agent Server starts and manages the ACP process, while Faheem Code renders the conversation and profile controls.
First-time setup
During first-time setup, the agent you choose becomes the initial active Agent Profile.
If you choose Faheem Code, the setup flow also configures the LLM profile that the Agent Profile uses. If you choose an ACP agent, the setup flow creates an ACP Agent Profile and uses that provider's authentication path.