Settings¶

Cogitus stores user settings using XDG config paths.

Settings File¶

Configuration is persisted under your XDG config directory for cogitus (for example ~/.config/cogitus/config.toml on many Linux systems).

Current Settings¶

last_viewed_idea_pk¶

Stores the last selected idea when the app exits.

• Type: integer
• Default: 0 (means no selection persisted yet)

edit_body_cursor_mode¶

Controls initial cursor placement when opening an existing idea in edit mode.

• Type: string
• Default: remember

Valid options are:

• "remember"
  • Uses the previously saved cursor position for that idea.
• "start"
  • Places the cursor at the start of the body text.
• "end"
  • Places the cursor at the end of the body text.

Example:

edit_body_cursor_mode="start"

new_idea_group_mode¶

Controls which group is preselected when opening the New Idea form.

• Type: string
• Default: contextual

Valid options are:

• "contextual"
  • Uses the current selection in the left tree pane.
  • If a group is selected, that group is used.
  • If an idea is selected, that idea's group is used.
  • If nothing usable is selected, falls back to default-group behavior.
• "default_group"
  • Uses default-group behavior directly.

If the configured value is invalid, Cogitus falls back to "contextual" and shows a warning toast at startup.

Example:

new_idea_group_mode="default_group"

default_group_name¶

Controls the canonical fallback group name used when no explicit group is selected.

• Type: string
• Default: default

Behavior:

• Value is normalized to lowercase and trimmed.
• Empty values are treated as invalid and fall back to default.
• Cogitus ensures this group exists at startup.
• This configured group is treated as the protected default group and cannot be deleted.

Example:

default_group_name="inbox"

Notes¶

• Settings are saved on app exit.