Quickstart

Prerequisites

Node.js ≥ 18.0.0
Any supported AI coding agent installed

Create Your First Workspace

Hub Mode
Project Mode
Non-Interactive

Hub mode is for founders, researchers, and generalists managing multiple projects from one workspace.

mkdir my-workspace && cd my-workspace
npx drevon init

The interactive wizard will guide you through:

Mode — automatically detected as Hub (empty directory)
Name — your workspace name
Identity — choose a preset (founder, developer, team, researcher)
Agents — select which agents to configure
Memory — enable persistent cross-session memory
Prompts — optionally install starter workflow templates

Project mode embeds AI capabilities into an existing codebase.

cd my-existing-project
npx drevon init

Drevon detects your project (git repo, package.json, src/ folder) and configures accordingly. Your existing code is never modified.

Skip all prompts with flags:

npx drevon init --hub --agents copilot,claude,cursor -y

The -y flag requires --agents to be specified explicitly.

What Gets Created

After running drevon init, your directory will contain:

my-workspace/
├── drevon.config.json          # Single source of truth
├── .drevon/
│   ├── memory/                 # Cross-project memory (v2)
│   │   ├── INDEX.md            # Read eagerly at session start
│   │   ├── topics/            # Loaded on demand
│   │   │   ├── user.md
│   │   │   ├── projects.md
│   │   │   └── systems.md
│   │   ├── log/               # Monthly episodic segments
│   │   └── archive/           # Compacted / migrated originals
│   ├── skills/                 # Installed skills
│   │   └── find-skills/        # Auto-installed
│   └── prompts/                # Reusable workflows
│       └── _index.md
├── workspace/                  # Your project folders go here
├── .github/copilot-instructions.md
├── CLAUDE.md
├── AGENTS.md
└── .cursor/rules/
    ├── core.mdc
    ├── memory.mdc
    └── skills.mdc

my-app/
├── src/                        # Your code (untouched)
├── drevon.config.json          # Single source of truth
├── .drevon/
│   ├── memory/                 # Project-scoped memory (v2)
│   │   ├── INDEX.md            # Read eagerly at session start
│   │   ├── topics/            # Loaded on demand
│   │   │   ├── architecture.md
│   │   │   ├── patterns.md
│   │   │   └── decisions/     # One file per decision
│   │   ├── log/               # Monthly episodic segments
│   │   └── archive/           # Compacted / migrated originals
│   ├── skills/
│   │   └── find-skills/
│   └── prompts/
│       └── _index.md
├── .github/copilot-instructions.md
├── CLAUDE.md
└── AGENTS.md

Install a Skill

Add capabilities from the skills.sh marketplace:

drevon skill add browser-use/browser-use

Skills are automatically injected into every agent’s config on the next drevon sync.

Sync After Changes

Whenever you edit drevon.config.json, regenerate agent configs:

drevon sync

Verify Your Setup

Check that everything is healthy:

drevon status

This shows your mode, identity, enabled agents (with health checks), memory files, installed skills, and prompt count.

Next Steps

Modes

Understand Hub vs Project mode in depth.

Memory System

Learn how persistent memory works.

Skills

Browse and install agent skills.

Get Started

Core Concepts

Reference

Prerequisites

Create Your First Workspace

What Gets Created

Install a Skill

Sync After Changes

Verify Your Setup

Next Steps

Modes

Memory System

Skills

​Prerequisites

​Create Your First Workspace

​What Gets Created

​Install a Skill

​Sync After Changes

​Verify Your Setup

​Next Steps

Modes

Memory System

Skills

Prerequisites

Create Your First Workspace

What Gets Created

Install a Skill

Sync After Changes

Verify Your Setup

Next Steps