Skip to main content

Prerequisites

  • Node.js ≥ 18.0.0
  • Any supported AI coding agent installed

Create Your First Workspace

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:
  1. Mode — automatically detected as Hub (empty directory)
  2. Name — your workspace name
  3. Identity — choose a preset (founder, developer, team, researcher)
  4. Agents — select which agents to configure
  5. Memory — enable persistent cross-session memory
  6. Prompts — optionally install starter workflow templates

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
│   │   ├── user.md
│   │   ├── projects.md
│   │   ├── systems.md
│   │   └── log.md
│   ├── 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

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.