Settings
Access settings via the gear icon in the TF Design interface. Settings are organised into sections.
Appearance
| Setting | Options | Description |
|---|---|---|
| Theme | Light, Dark, System | Toggle between light and dark modes, or follow system preference |
| Pet/Companion | On, Off | Enable the animated sprite companion overlay |
The companion is a spritesheet-based pet that appears in the corner of the interface. Options include wake, tuck, adopt, drag, and idle animations. Community-submitted pets are available.
Agent
| Setting | Description |
|---|---|
| Agent picker | Select which coding agent to use for generation |
| Default agent | The agent used when no specific agent is selected |
In the ToothFairyAI Desktop app, the default agent is TF Code. The agent picker lists all detected agents on your system.
Model
| Setting | Description |
|---|---|
| Model picker | Select the AI model used by the agent |
| Default model | The model used when no specific model is selected |
Available models depend on your agent configuration and ToothFairyAI workspace. Common models include toothfairyai/kimi-k2p6 and other ToothFairyAI-hosted models.
Media Providers
Configure default models for image, video, and audio generation:
| Setting | Description |
|---|---|
| Image model | Default model for image generation (see Images) |
| Video model | Default model for video generation (see Video) |
| Audio model | Default model for audio generation (see Audio) |
Media provider settings sync automatically within the Desktop app when you change them in Settings. No API keys are required — all media generation routes through the ToothFairyAI backend.
Connectors
Configure Composio connectors for external data sources. See Connectors for full details.
| Setting | Description |
|---|---|
| Connector catalog | Browse and authenticate with available connectors |
| Tool safety | Override default approval policies for individual tools |
| Credential store | View and manage stored credentials (managed by Composio) |
MCP Server
View MCP server installation info for registering with external coding agents. See MCP Server.
Language
| Setting | Description |
|---|---|
| Language menu | Switch the TF Design interface language |
TF Design supports internationalisation (i18n) with multiple languages available via the language menu.
App Config
General application configuration is managed in Settings. For programmatic access, the running Desktop app exposes internal endpoints:
| Endpoint | Method | Description |
|---|---|---|
/api/app-config | GET | Get current app configuration |
/api/app-config | PUT | Update app configuration |
Data Location
TF Design stores all project data in a private data directory managed by the Desktop app:
| Store | Contents |
|---|---|
| Project database | Projects, conversations, messages, tabs, templates |
| Project folders | Per-project artifact folders (agent working directories) |
| Artifacts | Generated artifact outputs |
| Media config | Media provider configuration |
The data directory is managed by the Desktop app and is not intended to be relocated manually.