Deployment Visibility Commands
Monitor and inspect deployment history and logs
Two top-level commands surface deployment information. They mirror Vercel’s vercel list and vercel logs, but the current implementation is still a work in progress. Expect behavior to evolve as the Control Plane endpoints mature.
Work in Progress
Both commands are currently under development. They return placeholder errors today but will provide full deployment visibility once the Control Plane endpoints are stabilized.
agnt5 list
Displays a list of deployments for the current project. The command accepts filters that will be wired to the Control Plane once the backing API stabilizes.
Syntax
agnt5 list [options]
agnt5 ls [options]Options
| Flag | Description |
|---|---|
--environment | Environment to inspect (default: development) |
--limit | Maximum number of deployments to show (default: 10) |
--status | Filter by deployment status |
--all | Include deployments from every environment |
Current Status: Returns a placeholder error today (list functionality not yet implemented). Use the Control Plane UI or APIs directly for detailed history until the CLI integration ships.
agnt5 logs
Streams logs for a specific deployment. When an ID is omitted the command will eventually default to the latest deployment for the current project.
Syntax
agnt5 logs [deployment-id] [options]Options
| Flag | Description |
|---|---|
--follow, -f | Follow log output |
--tail | Number of lines to show from the end of the logs (default: 100) |
--since | Timestamp or duration filter (e.g., 2h, 30m) |
Current Status: Returns a placeholder error until log streaming is implemented. The CLI currently surfaces a message reminding you that a deployment ID is required.
Planned Integration
Once these commands are complete they will work hand-in-hand with agnt5 deploy to provide an end-to-end workflow:
Example Future Workflow
# 1. Deploy your project
agnt5 deploy --prod
# 2. List deployments to see the new one
agnt5 list --environment production
# 3. Monitor logs for the deployment
agnt5 logs deploy-abc123 --follow
# 4. Check deployment status
agnt5 list --status runningIntegration with Deployment Pipeline
The visibility commands will integrate seamlessly with the deployment workflow:
- Post-deployment monitoring: After
agnt5 deploycompletes, useagnt5 logsto monitor the new deployment - Historical analysis: Use
agnt5 listto compare deployment performance over time - Debugging: Filter logs by time ranges to troubleshoot specific deployment issues
- Multi-environment visibility: Compare deployments across development, staging, and production
Expected Features
When implementation is complete, expect:
- Rich filtering: Filter deployments by status, environment, time range, and more
- Real-time updates: Live log streaming with automatic reconnection
- Deployment details: Full metadata about each deployment including build info, resource usage, and health status
- Integration hooks: Commands will automatically detect the current project context and default to relevant deployments
Until these commands are implemented, you can monitor deployments through the Control Plane UI or use the direct APIs for programmatic access.