Customize

Configuration

Configure Morbium with a morbium.json file: set your model, agents, permissions, MCP servers, and more, globally or per project.

Morbium reads its settings from a morbium.json file. You can set one globally for all projects and one per project, and the two are merged.

Where it lives

  • Project: morbium.json (or morbium.jsonc, or .morbium/morbium.json) in the project folder.
  • Global: ~/.config/morbium/morbium.json.

Project settings are deep-merged on top of global ones, so a project can override just the pieces it needs.

Config is validated strictly: an invalid file stops with an error rather than loading halfway. It is read once at startup, so after you edit it, restart Morbium for the changes to take effect.

Editor autocomplete

Add the $schema key to get autocomplete and validation in your editor:

{
            "$schema": "https://morbium.co/config.json",
            "model": "anthropic/claude-sonnet-4-5"
          }

Top-level keys

Key What it does
model The default model, as provider/model-id.
small_model The model used for background tasks.
default_agent Which agent a new session starts with.
instructions Extra instruction files to always load. See Rules.
agent Define or override agents.
command Define custom commands.
provider Configure model providers.
enabled_providers / disabled_providers Narrow which providers appear.
mcp Connect MCP servers.
permission Set permissions.
skills Add skills by path or URL.
references Add external folders or repos as context. See References.
plugin Load plugins.
share Control conversation sharing.
autoupdate true, false, or "notify".
compaction Tune automatic context compaction.
tool_output Limit how much tool output is kept.

An example

{
            "$schema": "https://morbium.co/config.json",
            "model": "anthropic/claude-sonnet-4-5",
            "permission": {
              "edit": "allow",
              "bash": "ask"
            },
            "mcp": {
              "playwright": {
                "type": "local",
                "command": ["npx", "-y", "@playwright/mcp"],
                "enabled": true
              }
            }
          }

Next steps