# Agent Run > Create and start an aide agent instance from an image. Use when the user wants to spin up, deploy, or create a new agent. Use when this capability is needed. - Skill: `tomevault-io/agent-run` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/agent-run` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/agent-run/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: DevOps & Infra - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/agent-run --- # Run an Agent The user wants to create and start a new aide agent instance. Use the Bash tool to run: ``` aide run $ARGUMENTS ``` If no image name is provided, first list available images with `aide images` and suggest one. After running, confirm the instance was created by running `aide ps`. --- > Source: [yiidtw/aide](https://github.com/yiidtw/aide) — distributed by [TomeVault](https://tomevault.io).