General settings
Workspace-wide settings that apply across all projects. Per-project settings live in Project settings.
AI platform
Dropdown: claude / gemini / codex. Sets the default agent Ideafy spawns when starting work on a card that has no per-card override. Each platform has its own default config path and skills path; switching the dropdown updates those paths to the platform's defaults.
See Choose an AI agent for the per-card override workflow.
Skills path
The directory Ideafy looks in for skills files. Defaults by platform:
- Claude Code:
~/.claude/skills - Gemini CLI:
~/.gemini/skills - Codex CLI:
~/.codex/skills
Project-local skills in <project>/.claude/skills/ take precedence when both exist.
Ideafy uses this path to:
- Populate the
@skillmention autocomplete in card chat - Decide where to write bundled skills when you click Install Ideafy Skills in a project
If you point this at a non-existent folder, Ideafy creates it on first write.
MCP config path
The file Ideafy edits to register its MCP server with the agent CLI. Defaults:
- Claude Code:
~/.claude.json - Gemini CLI:
~/.gemini/settings.json - Codex CLI:
~/.codex/config.toml
The path is per-user, not per-project. Ideafy modifies only the mcpServers.ideafy entry — your other MCP servers in the same file are preserved.
Terminal app
Which terminal emulator Ideafy spawns when you click Open in Terminal on a card. Options:
- iTerm2 (if installed)
- Ghostty (if installed)
- Terminal.app (macOS default, always available)
Auto-detection picks the first installed option. Override if you want a specific one.
Remote connection
Toggle for the Electron remote device job listener. When on, Ideafy subscribes to ai_jobs via Supabase Realtime and the device can claim jobs dispatched from another device on the same team. Off in Public edition (feature not shipped). Opt-in on the Team edition.
See Remote device for the full workflow.
Theme
Light / Dark toggle. Inherits from system by default. Change it any time — your choice is stored per device.
Where General Settings live on disk
The AppSettings values are stored in the settings table of the local SQLite database. Back up ~/Library/Application Support/ideafy/kanban.db and you back up your settings along with everything else.
Prev: Subscription states & paywall Next: Project settings Up: User guide index