Operations Skills

Hub

Community skill registry with versioning, dependency resolution, integrity verification, and semantic search.

agent-apps hub-search --query "csv"        # Scored keyword + semantic search
agent-apps hub-add --name echo@^1.0.0      # Install with version range
agent-apps hub-add --name echo --dryRun true  # Preview without installing
agent-apps hub-list                               # List installed + available updates + dep tree
agent-apps hub-info --name echo             # Full package details
agent-apps hub-update --name echo           # Update with dep re-resolution
agent-apps hub-remove --name echo           # Remove with reverse-dep warnings
agent-apps hub-publish --path ./my-skill    # Publish to registry

Installed packages live in .agent-apps/packages/ and are discovered automatically via the external search path in default.skill.md. Hub packages have isolated authority — --local overrides don't apply, --global overrides do.

All hub skills return structured objects with a text field for backward compatibility. See The Hub for the full user guide, and the specification for the registry format, scoring algorithm, and federation config.

Init

Scaffold a new Agent Apps project in the current directory. Creates main.skill.md, a hello skill, README, .gitignore, and installs the runtime as a local dependency.

agent-apps init

Update

Update the agent-apps CLI to the latest release (clone-based installs only).

agent-apps update

Sandbox

Run projects inside Docker containers for isolation and pre-deploy testing.

agent-apps sandbox-build                    # Build Docker image
agent-apps sandbox-app --args '[]'          # Run main skill in container
agent-apps sandbox-list                     # List running containers
agent-apps sandbox-stop --name my-app       # Stop a container

The base image (agent-apps-sandbox) is auto-built from dist/ if missing. Project images layer your files on top. Configure constraints (filesystem, network, env, resources) via metadata.sandbox.profiles.<name>.constraints.

See Sandbox for the full guide.

Deploy

Build, push, and deploy projects to cloud infrastructure.

agent-apps deploy-app                       # Build image, push to ECR, deploy to App Runner
agent-apps deploy-status                    # Check deployment status
agent-apps deploy-logs                      # Fetch recent logs
agent-apps deploy-list                      # List all deployments
agent-apps deploy-remove                    # Delete deployment and clean up

Configure via metadata.deploy.profiles.<name> with provider, region, port, instance role, and resource limits. For agent-powered apps, use an IAM instance role with Bedrock permissions rather than environment variable credentials.

See Deploy for the full guide.