Skip to main content

Overview

All Drevon settings live in drevon.config.json. This is the only file you need to edit — run drevon sync to propagate changes to all agent configs.

Full Config Example

drevon.config.json
{
  "$schema": "https://drevon.dev/schema/v1.json",
  "version": 1,
  "mode": "hub",
  "name": "my-workspace",
  "identity": {
    "role": "founder-agent",
    "description": "High-autonomy AI assistant for a startup founder",
    "posture": "Take initiative. Don't ask for permission on obvious decisions. Move fast, ship things, document what you do.",
    "capabilities": ["product", "engineering", "design", "marketing"]
  },
  "instructions": [
    {
      "id": "memory-protocol",
      "title": "Memory Protocol",
      "content": "Read all files in .drevon/memory/ at the start of every session.",
      "alwaysApply": true
    },
    {
      "id": "typescript-rules",
      "title": "TypeScript Standards",
      "content": "Use strict TypeScript. Prefer interfaces over types. Use zod for runtime validation.",
      "globs": ["**/*.ts", "**/*.tsx"]
    }
  ],
  "agents": {
    "copilot": { "enabled": true },
    "claude": {
      "enabled": true,
      "allowedCommands": ["git", "npm", "npx", "node", "python3"],
      "extraInstructions": ["Always explain your reasoning before making changes."]
    },
    "cursor": { "enabled": true },
    "codex": { "enabled": false },
    "windsurf": { "enabled": false },
    "cline": { "enabled": false },
    "aider": { "enabled": false },
    "continue": { "enabled": false }
  },
  "memory": {
    "enabled": true,
    "directory": ".drevon/memory",
    "files": ["user.md", "projects.md", "systems.md", "log.md"]
  },
  "skills": {
    "enabled": true,
    "directory": ".drevon/skills",
    "lockFile": "skills-lock.json"
  },
  "prompts": {
    "enabled": true,
    "directory": ".drevon/prompts"
  },
  "workspace": {
    "enabled": true,
    "directory": "workspace",
    "rules": [
      "One folder per project or task",
      "Never create files outside workspace/ unless explicitly told",
      "Register new projects in .drevon/memory/projects.md"
    ]
  }
}

Config Fields

Top-Level

FieldTypeRequiredDescription
$schemastringNoJSON Schema URL for editor autocompletion
versionnumberYesConfig schema version (currently 1)
mode"hub" | "project"YesWorkspace mode
namestringYesWorkspace or project name

Identity

The identity object defines how agents present themselves and behave.
FieldTypeRequiredDescription
rolestringYesAgent role label (e.g., "founder-agent")
descriptionstringYesOne-line description of the agent’s purpose
posturestringYesOperating behavior instructions
capabilitiesstring[]NoList of capability domains

Instructions

The instructions array contains custom rules injected into every agent config.
FieldTypeRequiredDescription
idstringYesUnique identifier for the instruction
titlestringYesHuman-readable title
contentstringYesThe instruction text
alwaysApplybooleanNoApply to all files (default: true). Used by Cursor’s .mdc format
globsstring[]NoFile glob patterns for conditional application (Cursor only)
The globs field is primarily used by the Cursor adapter, which generates separate .mdc rule files that activate only when matching files are open. Other agents receive all instructions regardless.

Agents

Each key in the agents object corresponds to a supported agent ID.
FieldTypeDescription
enabledbooleanWhether to generate config for this agent
extraInstructionsstring[]Additional instructions specific to this agent
allowedCommandsstring[]Commands the agent can run (Claude only)
configobjectAgent-specific configuration (Aider only)
Valid agent IDs: copilot, claude, cursor, codex, windsurf, cline, aider, continue

Memory

FieldTypeDescription
enabledbooleanEnable persistent memory system
directorystringMemory files directory
filesstring[]List of memory files
customFilesstring[]Additional custom memory files

Skills

FieldTypeDescription
enabledbooleanEnable skills integration
directorystringSkills directory
lockFilestringLock file path

Prompts

FieldTypeDescription
enabledbooleanEnable prompts system
directorystringPrompts directory

Workspace (Hub Mode Only)

FieldTypeDescription
enabledbooleanEnable workspace management
directorystringWorkspace directory name
rulesstring[]Workspace organization rules

Editing & Syncing

After editing drevon.config.json, always regenerate agent configs:
drevon sync
Never edit the generated agent config files directly (e.g., CLAUDE.md, .github/copilot-instructions.md). They will be overwritten on the next drevon sync. All changes should go through drevon.config.json.