Skip to content
memex

Guide

Hand-off and messages

A sub-agent logs its full report and returns one line, a ref. Messages are logs with --to.

When to use it

When an orchestrator runs sub-agents and should not carry every report in its context, or when one agent leaves word for another.

Steps

  1. The sub-agent logs its full report: memex log <stream> --agent <id> --to <recipient>.
  2. It returns one line, report: <ref>.
  3. The orchestrator runs memex show <ref> only when it needs the detail.
  4. Recipients find their messages with memex search to:<id>; memex info --agent <id> counts what is waiting.

A hand-off by reference

$ memex log impl --agent worker-2 --to orchestrator <<'EOF'
show walks hub READMEs
`show <file>` now lists "cited by", through crates/README.md.
EOF
impl:20261013-214107-show-walks-hub-readmes

$ memex search to:orchestrator
logs  (showing 1 of 1)
  impl:20261013-214107-show-walks-hub-readmes  2m · worker-2 · feat/show  show walks hub READMEs

Live back-and-forth stays in the harness’s own messaging.

← All guides