mayros dag

The mayros dag command provides access to the Semantic DAG — the immutable, Ed25519-signed audit trail that records every action in Mayros.

Global Options

FlagDescriptionDefault
--cortex-host <host>Cortex host127.0.0.1 (or from config)
--cortex-port <port>Cortex port19090 (or from config)
--cortex-token <token>Cortex auth token (or CORTEX_AUTH_TOKEN env var)

Subcommands

dag tips

Show current DAG tip hashes (the frontier of the DAG — latest actions with no children).

bash
mayros dag tips

dag action <hash>

Inspect a specific DAG action by its content-addressable hash. Shows author, sequence number, timestamp, payload type, summary, parents, and signature status.

bash
mayros dag action abc123def456

dag history <subject>

Show the action history for a specific subject (e.g. a venture, mission, or agent).

bash
mayros dag history "venture:security-audit"
mayros dag history "venture:security-audit" --limit 50
FlagDescriptionDefault
--limit <n>Maximum actions to return20

dag chain <author>

Show the action chain for a specific author/node. Useful for auditing everything a particular node has done.

bash
mayros dag chain node-001
mayros dag chain node-001 --limit 50
FlagDescriptionDefault
--limit <n>Maximum actions to return20

dag stats

Show DAG statistics: total action count and tip count.

bash
mayros dag stats

dag prune

Prune old DAG actions with configurable retention policies. Prompts for confirmation unless --yes is passed.

bash
mayros dag prune --policy keep_last --value 1000 --checkpoint
mayros dag prune --policy keep_since --value 1710000000 --yes
FlagDescriptionRequired
--policy <policy>Retention policy: keep_all, keep_since, keep_last, keep_depthYes
--value <n>Policy value (timestamp, count, or depth)No
--checkpointCreate a checkpoint before pruningNo
--yesSkip confirmation promptNo

dag at <hash>

Time-travel to a specific action hash. Reconstructs the knowledge graph state as it existed at that point by replaying actions from genesis.

bash
mayros dag at abc123def456

dag diff <from> <to>

Show the diff between two DAG action hashes — lists all actions that occurred between the two points.

bash
mayros dag diff abc123 def456

dag export

Export the full DAG as a visual graph in DOT, Mermaid, or JSON format.

bash
mayros dag export
mayros dag export --format dot
mayros dag export --format json
FlagDescriptionDefault
--format <format>Export format: dot, mermaid, jsonmermaid

dag verify <hash>

Verify the Ed25519 signature of a specific DAG action. Confirms whether the action was signed by the claimed author.

bash
mayros dag verify abc123def456 --public-key <hex-or-base64>
FlagDescriptionRequired
--public-key <key>Ed25519 public key (hex or base64)Yes