microagent artifact
Last updated: 2026-06-14
microagent artifact <name> [--state-dir <dir>] List declared artifactsmicroagent artifact get <name> <artifact> <target> [--state-dir <dir>] [--debugfs <path>] Retrieve one output artifactartifact reports the input bundles and output paths declared in the
workspace manifest. artifact get retrieves a declared output artifact by
name without entering the workspace - the host reads it straight off the
workspace disk. Only declared outputs are retrievable by artifact name; for
arbitrary file copying, use cp.
Examples
Section titled “Examples”List declared artifacts, then fetch one by name:
microagent --json artifact researchmicroagent artifact get research report ./out/If an output path sits under an attached disk mountpoint, artifact get
reads from that disk. Otherwise it reads from the rootfs image.
You’ll rarely need flags here - --debugfs only when the debugfs binary
lives somewhere unusual.
| Flag | Description |
|---|---|
--state-dir <dir> | State directory (default ~/.microagent/) |
--debugfs <path> | debugfs binary path for artifact get |
See global flags for --json/--text/--output/--mode.
Exit status
Section titled “Exit status”artifact exits 0 when the workspace manifest is found and read; nonzero
when the workspace cannot be found, the named artifact is not declared, or the
read from the workspace disk fails. In AX mode a failure is written as a
structured error envelope.