Basic Usage

Interactive session

min-agent                       # Start an interactive session
min-agent "your message"        # Start a session and send a message immediately

One-shot question

min-agent exec "your message"   # Ask a single question, then exit

Works with npx too:

npx -y min-agent exec "your message"

One-shot runs accept the other session flags as well:

min-agent exec -i photo.png "what's in this image?"   # Attach an image
min-agent exec --resume <id> "continue this task"     # Continue a saved exec session
echo "piped message" | min-agent exec -               # Read the message from stdin

Session management

min-agent --resume <id>         # Resume a previous session
min-agent history                # List saved sessions

Other common commands

min-agent models                 # List available models
min-agent update                 # Upgrade to the latest version

Attach an image or pick a model for one message

min-agent -i photo.png "what's in this image?"
min-agent -m gpt-5.5 "your message"
min-agent --provider anthropic "your message"

• -i, --image <path>: attach a local image
• -m, --model <model>: use a specific model for this run only
• --provider <name>: use a specific provider for this run only