Skip to content

microagent profiles

Last updated: 2026-06-11

microagent profiles

profiles prints the built-in workspace resource profiles. Profiles are named shortcuts for memory, CPU count, and rootfs disk size; create, run, and start accept --profile <name>. Use it when you want the exact numbers behind a profile name.

List the profiles, then size a workspace with one:

Terminal window
microagent profiles
microagent create research --image docker.io/library/ubuntu:24.04 --profile medium
ProfileMemory MiBCPUsDisk MiB
tiny2561512
small51221024
medium204828192
large4096416384

profiles takes no flags of its own.

See global flags for --json/--text/--output/--mode.

profiles exits 0 on success. In AX mode a failure is written as a structured error envelope.

  • create - size a persistent workspace with --profile
  • run - size a one-shot run with --profile
  • start - resize on start with --profile