Skip to content

microagent profiles

Last updated: 2026-07-25

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
Profile Memory MiB CPUs Disk MiB
tiny 256 1 512
small 512 2 1024
medium 2048 2 8192
large 4096 4 16384

profiles takes no flags of its own.

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

profiles exits 0 on success.

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