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.
1.0.0Add 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
Define agent personas, prompts, and roles in human-readable YAML
Declare connector requirements and onboarding flows without embedding secrets
Version-control assistant fleet definitions in Git alongside your codebase
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 sourceReports
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
- Read SPEC.md for semantics and validation rules.
- Copy an example from
examples/. - Edit the YAML fence: bot persona, connectors, onboarding,
user_context, agents. - Keep secrets out of the file. Connectors declare which accounts to link; credentials stay in the host.
- Point a GBDL-compatible loader at the
.gbdl.mdfile (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.