Skip to main content

​
Config File Locations

PathDescription
~/.config/lukan/config.jsonMain configuration
~/.config/lukan/credentials.jsonAPI credentials
~/.config/lukan/sessions/Chat sessions
~/.config/lukan/reminders.mdReminders
~/.config/lukan/workers.jsonWorker definitions
~/.config/lukan/workers/Worker run history
~/.config/lukan/trusted-dirs.jsonTrusted directories
~/.config/lukan/MEMORY.mdGlobal memory
~/.config/lukan/memory.mdGlobal memory (alternative path)
~/.config/lukan/indexes/Symbol index files
~/.config/lukan/plugins/Installed plugins
.lukan/config.jsonPer-project permissions
.lukan/memories/MEMORY.mdPer-project memory
.lukan/memory.mdPer-project memory (alternative path)
.lukan/.activeProject memory activation marker
.lukan/skills/Per-project skills
.lukan/plans/Implementation plans
.lukan/tasks.mdSession task list

​
Main Config (config.json)

{
  "provider": "nebius",
  "model": "MiniMaxAI/MiniMax-M2.1",
  "maxTokens": 8192,
  "temperature": 0.7,
  "timezone": "Europe/Madrid",
  "syntaxTheme": "vitesse-dark",
  "models": ["anthropic:claude-sonnet-4-5-20250929", "nebius:MiniMaxAI/MiniMax-M2.1"],
  "visionModel": "anthropic:claude-sonnet-4-5-20250929",
  "visionModels": [],
  "disabledTools": [],
  "browserCdpUrl": null,
  "browserAllowInternal": false,
  "browserScreenshots": true,
  "webPassword": null,
  "webTokenTTL": 24,
  "openaiCompatibleBaseURL": null,
  "openaiCompatibleProviderName": null,
  "openaiCompatibleProviderOptions": {},
  "plugins": {
    "enabled": ["whatsapp", "email"],
    "overrides": {
      "whatsapp": {
        "provider": "anthropic",
        "model": "claude-sonnet-4-5-20250929",
        "tools": ["ReadFiles", "WebSearch"],
        "maxResponseLen": 10000,
        "autoRestart": true
      }
    }
  }
}

​
New Config Fields

FieldTypeDescription
disabledToolsstring[]List of tool names to disable globally
visionModelsstring[]List of available vision models
openaiCompatibleBaseURLstringBase URL for OpenAI-compatible provider
openaiCompatibleProviderNamestringDisplay name for OpenAI-compatible provider
openaiCompatibleProviderOptionsobjectCustom options for OpenAI-compatible provider
pluginsobjectPlugin system configuration
plugins.enabledstring[]List of plugin names to auto-start
plugins.overridesobjectPer-plugin configuration overrides

​
Credentials (credentials.json)

{
  "nebiusApiKey": "...",
  "anthropicApiKey": "...",
  "fireworksApiKey": "...",
  "githubToken": "...",
  "copilotToken": "...",
  "braveApiKey": "...",
  "tavilyApiKey": "...",
  "openaiApiKey": "...",
  "codexAccessToken": "...",
  "codexRefreshToken": "...",
  "zaiApiKey": "...",
  "ollamaCloudApiKey": "...",
  "openaiCompatibleApiKey": "...",
  "lukanCloudApiKey": "...",
  "googleClientId": "...",
  "googleClientSecret": "...",
  "googleAccessToken": "...",
  "googleRefreshToken": "...",
  "skillCredentials": {
    "my-skill": {
      "CUSTOM_API_KEY": "..."
    }
  }
}

​
New Credential Fields

FieldDescription
ollamaCloudApiKeyAPI key for Ollama Cloud provider
openaiCompatibleApiKeyAPI key for OpenAI-compatible endpoint (optional)
lukanCloudApiKeyAPI key for Lukan Cloud provider
skillCredentialsPer-skill environment variables (injected when skill is loaded)
Environment variables are checked first (e.g., NEBIUS_API_KEY, ANTHROPIC_API_KEY, OLLAMA_CLOUD_API_KEY, OPENAI_COMPATIBLE_API_KEY, LUKAN_CLOUD_URL).

​
Project Configuration (.lukan/config.json)

{
  "permissionMode": "manual",
  "permissions": {
    "deny": [],
    "ask": ["Bash(git push:*)", "Bash(git commit:*)", "Bash(rm:*)", "Bash(sudo:*)"],
    "allow": ["Bash(git status:*)", "Bash(git diff:*)", "Bash(git log:*)", "Bash(npm:*)", "Bash(bun:*)"]
  },
  "trusted": false,
  "allowedPaths": ["~/other-project"]
}

​
New Project Config Fields

FieldTypeDescription
trustedbooleanMarks workspace as trusted (reduces permission prompts)
allowedPathsstring[]Extra directories the agent can access (supports ~ expansion)

​
Provider Configuration

You can override the provider per-channel (WhatsApp, Email) via plugin overrides in config.json: 
{
  "plugins": {
    "overrides": {
      "whatsapp": {
        "provider": "anthropic",
        "model": "claude-sonnet-4-5-20250929"
      }
    }
  }
}
See Providers for available providers and models.