Skip to content
Developer Codex
Reference

Settings Reference

Open settings from the sidebar footer Settings button. The panel slides in from the right and closes with the X button, the Escape key, or a backdrop click.

SettingDescriptionDefault
Workspace nameThe display name for the current workspaceSet at creation

Settings for managing page templates in the workspace.

Settings for managing custom page types. See Create Custom Types.

Settings for the Virtual File System (projects your workspace as browsable markdown files).

SettingDescription
VFS enabledProjects your workspace as markdown files in the filesystem
Mount pathLocal path where the VFS mounts
Available on Pro tier.
SettingDescriptionDefault
Enable MCP ServerStarts the in-process MCP server on workspace openOff
PortPort the MCP server binds to7862

The MCP server exposes workspace tools to external AI clients via Streamable HTTP. See MCP Server for setup details. Port values below 1024 are rejected.

SettingDescriptionDefault
AnalyticsSend anonymized usage events to improve InklingsOn

Click the toggle to opt out. Opting out takes effect immediately and persists across app restarts.

Shows the current device and any registered devices for the workspace. Used for sync and presence.

Available on Pro+Agent tier.
SettingDescriptionDefault
ProviderLLM provider to use (Anthropic, OpenAI, xAI, Ollama, OpenRouter)None
ModelSpecific model within the selected providerProvider-dependent
API KeyYour API key for cloud providersNone

API keys are stored in the OS keychain — never in the settings file. The settings file records api_key_configured: true or false only. Ollama does not use an API key.

Appears when Ollama is selected as the provider.

SettingDescriptionDefault
StatusRunning state and version of the local Ollama instance
Model pickerRecommended models filtered by hardware tier
Endpoint (Advanced)Custom Ollama server URLhttp://localhost:11434

Pre-configure which workspace operations the agent can perform without prompting.

CapabilityDefaultDescription
PagesReadOnRead page content and metadata
SearchUseOnSearch the workspace
TagsReadOnRead tag information
PagesWriteOffCreate and modify pages
PagesDeleteOffMove pages to trash
PagesOrganizeOffMove pages in the hierarchy
TagsWriteOffCreate and modify tags
AttachmentsWriteOffUpload attachments

Capabilities set to Off trigger a per-operation permission request when the agent needs them. See Agent Permissions.

SettingDescriptionRangeDefault
Enable scheduled activitiesAgent generates workspace insights on a scheduleOff
IntervalHow often the agent runs scheduled activities5–120 minutes30 minutes

Values outside the 5–120 minute range are clamped to the nearest boundary.

Was this page helpful?