CorvidLabs Agent 3md
An agent.3md is executable configuration: plane 0 is identity; other planes are skills
with triggers, typed inputs, optional tool= command templates, and dependency links.
Let can locate the file; this skill validates, routes, and optionally runs it.
Install
CorvidLabs/agent-3md is not a Fledge plugin (no fledge agent3md). Use the library
or CLI below.
TypeScript library (embed):
npm install @corvidlabs/agent3md
# or: bun add @corvidlabs/agent3md
CLI (select a supported release with the capabilities the task needs):
Inspect agent3md --help for manifest, skills, route, get, resolve,
validate, and run (--exec). Package-manager builds may lag the supported release;
check current upstream release guidance before choosing an install source.
# From a clone of CorvidLabs/agent-3md
cd /path/to/agent-3md
cargo install --path loaders/rust
# or without a global install:
bun run cli --help
Inside the agent-3md repo:
| Action | Command |
|---|---|
| Inspect / route / run | bun run cli <cmd> … |
| Validate | bun run validate <file> (not bun run cli validate) |
| Scaffold | bun run cli new … (TS-only) |
Inspect without executing
agent3md validate agent.3md
agent3md manifest agent.3md
agent3md skills agent.3md
agent3md route agent.3md "<request>"
agent3md get agent.3md <skill-name>
agent3md resolve agent.3md <skill-name>
If validate rejects a modern manifest after cargo install agent3md from crates.io, use
the compatible repo-local validator or a supported loader release. Do not add obsolete
manifest fields merely to satisfy an older validator.
Preview, then execute only when authorized
Confirm run exists in agent3md --help first:
# Route + fill tool template; print the command (does not run it)
agent3md run agent.3md "<request>" key=value
# Run the rendered command
agent3md run agent.3md "<request>" key=value --exec
Repo-local equivalent: bun run cli run agent.3md "<request>" key=value [--exec].
Inspect the matched skill, substituted values, quoting, working directory, and referenced
paths before --exec. --exec does not bypass Fledge workflows, repository policy, the
sandbox, or external-write approval. Prefer fledge run for repository-declared tasks.
Skills without a tool= attribute are playbook-only—follow them with the host's own tools.
Use the three-md skill for general .3md documents that are not agent manifests.