agentuity-cli-cloud-deploy
Deploy project to the Agentuity Cloud. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
The agentuity-cli-cloud-deploy skill enables seamless project deployment to the Agentuity Cloud platform directly via the Agentuity CLI. It streamlines the release lifecycle by supporting automated cloud operations, requiring authentication and project context to ensure secure and accurate deployments. This tool is essential for developers looking to automate their deployment workflows with rich metadata support for tracking and logging.
Use Cases
- Automated CI/CD Pipelines: Integrate the deployment command into CI providers like GitHub Actions or GitLab CI to automatically push updates to Agentuity Cloud upon successful builds.
- Traceable Release Management: Use the skill to attach specific commit URLs, pull request numbers, and build logs to each deployment for better audit trails and debugging.
- Environment Tagging: Apply custom tags (e.g., 'production', 'staging', 'v1.0') during the deployment process to manage different versions and environments within the Agentuity ecosystem.
- Manual Cloud Updates: Allow developers to quickly deploy local project changes to a cloud environment for rapid testing and validation without leaving the terminal.
| name | agentuity-cli-cloud-deploy |
|---|---|
| description | Deploy project to the Agentuity Cloud. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.103" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| command | "agentuity cloud deploy" |
| tags | "mutating creates-resource slow api-intensive requires-auth requires-project" |
Cloud Deploy
Deploy project to the Agentuity Cloud
Prerequisites
- Authenticated with
agentuity auth login - Project context required (run from project directory or use
--project-id) - auth login
Usage
agentuity cloud deploy [options]
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--tag |
array | No | ["latest"] |
One or more tags to add to the deployment |
--logsUrl |
string | Yes | - | The url to the CI build logs |
--trigger |
string | No | "cli" |
The trigger that caused the build |
--commitUrl |
string | Yes | - | The url to the CI commit |
--message |
string | Yes | - | The message to associate with this deployment |
--provider |
string | Yes | - | The CI provider name (attempts to autodetect) |
--event |
string | No | "manual" |
The event that triggered the deployment |
--pullRequestNumber |
number | Yes | - | the pull request number |
--pullRequestCommentId |
string | Yes | - | the pull request comment id |
--pullRequestURL |
string | Yes | - | the pull request url |
Examples
Deploy current project:
bunx @agentuity/cli cloud deploy
Deploy with verbose output:
bunx @agentuity/cli cloud deploy --log-level=debug
Deploy with specific tags:
bunx @agentuity/cli cloud deploy --tag a --tag b
Output
Returns JSON object:
{
"success": "boolean",
"deploymentId": "string",
"projectId": "string",
"logs": "array",
"urls": "object"
}
| Field | Type | Description |
|---|---|---|
success |
boolean | Whether deployment succeeded |
deploymentId |
string | Deployment ID |
projectId |
string | Project ID |
logs |
array | The deployment startup logs |
urls |
object | Deployment URLs |