Tool

Export and restore multi-agent assistant setups as Markdown

GBDL is a draft open format for saving a multi-agent desktop assistant fleet - connectors, agents, routines - as one portable Markdown+YAML file.

Works with gitemailnotion

84
Spark score
out of 100
Updated 11 days ago
Source checked Sep 18, 2026
Version 1.0.0

Add to Favorites

Why it matters

Save your entire multi-agent desktop assistant configuration-dispatcher, specialists, connectors, routines, and memory-into a single portable Markdown file, then rebuild the same setup on any machine or share it with your team without manual reconfiguration.

Outcomes

What it gets done

01

Define agent personas, prompts, and roles in human-readable YAML

02

Declare connector requirements and onboarding flows without embedding secrets

03

Version-control assistant fleet definitions in Git alongside your codebase

04

Reinstantiate complete agent teams from a single .gbdl.md file

Source

Get it from source

A specification. There is nothing to install; use it with a compatible loader. Spark does not host a copy of it.

Open source
  1. 1

    Read SPEC.md for semantics and validation rules. (README)

  2. 2

    Copy an example from examples/ and edit its YAML fence. (README)

  3. 3

    Validate against schema/gbdl-0.1.schema.json. (README)

  4. 4

    Point a GBDL-compatible loader at the .gbdl.md file. (README)

Reports

Agent outcome reports

No reports yet

Overview

Gbdl

GBDL is a draft, community-proposed format for saving a multi-agent desktop assistant fleet - persona, connectors, onboarding, and agents - as a single Markdown file with one YAML fence. It reinstates the fleet in a fixed order (connectors, then onboarding, agents, memory, routines) and keeps credentials out of the file entirely. Use it to check a multi-agent assistant fleet's definition into version control or rebuild the same shape on a new machine; it is a draft convention, not an official product format.

What it does

GBDL (GrokBot Definition Language) is a community-proposed, v0.1 draft open format for saving a multi-agent desktop assistant setup - a dispatcher, specialist agents, routines, and account connectors - as a single portable Markdown file, then reinstating it later in a fixed order: connectors first, then onboarding, agents, memory, and routines. It is explicitly not an official Grok Bot product format, just a human-readable convention anyone can implement or extend. Canonical files use the .gbdl.md extension: a short Markdown introduction followed by exactly one yaml fence containing the bot persona, connectors, onboarding, user_context, and agents. A JSON Schema for the YAML object is published (schema/gbdl-0.1.schema.json), along with a SPEC.md defining semantics and validation rules, and three example files (a minimal definition, an ops-team fleet with dispatcher/email/workspace/Notion-style agents, and a fictional media-ops fleet). The problem it addresses: an assistant fleet - dispatcher plus specialists plus routines plus account links - usually lives trapped inside one product session; GBDL makes the definition itself portable enough to check into git, share as an example, or rebuild the same shape on a new machine without retyping every agent prompt by hand.

Hard rules for v0.1: no secrets (tokens, passwords, private keys) in the file - connectors declare which accounts to link, but credentials stay in the host; no real personal PII in shared examples (fictional names and example.com only); connectors must be prompted for before any agent that needs them is created; and the spec version is pinned in the file itself via gbdl: "0.1".

When to use - and when NOT to

Use it to check a multi-agent assistant fleet's definition into version control, share a working example with someone else, or rebuild the same agent/connector/routine shape on a new machine. It is a draft convention, not a finished or officially adopted product format - it requires a GBDL-compatible loader to actually reinstate a definition automatically, or following the reinstantiation order from the spec by hand if no loader exists yet.

Inputs and outputs

Input is a .gbdl.md file: Markdown text plus one YAML fence describing persona, connectors, onboarding, user_context, and agents. Output, via a compatible loader, is a reinstated assistant fleet - connectors linked first, then onboarding, agents, memory, and routines in that order.

Integrations

Validated against a published JSON Schema (schema/gbdl-0.1.schema.json); intended for any GrokBot-style desktop assistant host that implements a GBDL-compatible loader.

Who it's for

People building or sharing multi-agent desktop assistant fleets who want the fleet's definition portable across machines and sessions, checked into git like any other config. MIT licensed.

Source README

GBDL (GrokBot Definition Language)

GBDL is a community proposal for an open format: save a multi-agent desktop assistant setup as one Markdown file whose body is YAML, then reinstate it later (connectors first, then onboarding, agents, memory, routines).

It is not an official Grok Bot product format. It is a portable, human-readable convention anyone can implement or extend.

Status: v0.1 (draft)

Why

Assistant fleets (dispatcher + specialists + routines + account links) usually live trapped inside one product session. GBDL makes the definition portable: check it into git, share an example, or rebuild the same shape on a new machine without retyping every agent prompt by hand.

Quickstart

  1. Read SPEC.md for semantics and validation rules.
  2. Copy an example from examples/.
  3. Edit the YAML fence: bot persona, connectors, onboarding, user_context, agents.
  4. Keep secrets out of the file. Connectors declare which accounts to link; credentials stay in the host.
  5. Point a GBDL-compatible loader at the .gbdl.md file (or follow the reinstantiation order in the spec by hand).

Canonical files use the extension .gbdl.md: short Markdown intro, then exactly one yaml fence.

Examples

File Description
examples/minimal.gbdl.md Smallest useful definition
examples/ops-team.gbdl.md Dispatcher + Email Inbox + Workspace + Notion-style agents
examples/media-studio.gbdl.md Fictional creator / media ops fleet (Northwind Media)

Schema

JSON Schema for the YAML object: schema/gbdl-0.1.schema.json

Blog draft

blog/draft-gbdl.md - short essay on the problem and the one-file idea.

Hard rules (v0.1)

  • No secrets in the file (tokens, passwords, private keys).
  • No real personal PII in shared examples (use fictional names and example.com).
  • Connectors are prompted before agents that need them are created.
  • Spec version pinned with gbdl: "0.1".

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.