Skip to content

Commands Overview

Devo CLI provides several commands to enhance your development workflow.

Core Commands

devo commit

Generate conventional commit messages from staged changes using AWS Bedrock.

devo commit [OPTIONS]

Options:

  • -p, --push - Push the commit to the remote origin
  • -pr, --pull-request - Open a pull request on GitHub
  • -a, --add - Add all changes to the staging area before committing
  • -A, --all - Perform add, commit, push, and open pull request

Use when: You have staged changes and want a properly formatted commit message.

(see also: Commit Workflow)

devo code-reviewer

Perform AI-driven code review with security and quality analysis.

devo code-reviewer [OPTIONS]

Options:

  • -b, --base-branch TEXT - Base branch to compare against (default: auto-detect main/master)
  • -r, --repo-path TEXT - Path to the Git repository (default: current directory)
  • -o, --output [json|table] - Output format (table: rich tables, json: raw JSON)
  • -m, --show-metrics - Include detailed execution metrics in the output
  • -f, --full-prompt - Use full detailed prompt (default: optimized short prompt)

Use when: You want to review code changes before committing or merging.

(see also: Code Review Workflow)

devo config

Manage Devo CLI configuration.

devo config <subcommand> [OPTIONS]

Subcommands:

  • show - Show current configuration
  • set - Set a configuration value
  • export - Export configuration (full or partial)
  • import - Import configuration from file
  • reset - Reset configuration to defaults
  • sections - List all configuration sections
  • path - Show configuration file path
  • migrate - Migrate legacy config files to consolidated format

Use when: You need to view or modify configuration settings.

AWS Integration

devo aws-login

Automate AWS SSO authentication and credential caching.

devo aws-login [COMMAND] [OPTIONS]

Commands:

  • login - Login to AWS using SSO with a specific profile
  • list - List all AWS profiles with detailed status
  • configure - Configure a new SSO profile interactively
  • refresh - Refresh expired or expiring credentials
  • set-default - Set a profile as the default

Use when: You need to login to AWS using SSO without manually copying credentials.

devo codeartifact-login

Authenticate with AWS CodeArtifact for private package management.

devo codeartifact-login [OPTIONS]

Alias: ca-login

Use when: You need to access private packages from CodeArtifact.

devo ssm

AWS Systems Manager Session Manager commands for database and instance connections.

devo ssm <subcommand> [OPTIONS]

Commands:

  • connect - Shortcut for 'devo ssm database connect'
  • shell - Shortcut for 'devo ssm instance shell'
  • forward - Manual port forwarding (without using config)
  • database - Manage database connections
  • connect - Connect to a configured database (uses hostname forwarding)
  • list - List configured databases
  • add - Add a database configuration
  • remove - Remove a database configuration
  • instance - Manage EC2 instance connections
  • shell - Connect to a configured instance via interactive shell
  • list - List configured instances
  • add - Add an instance configuration
  • remove - Remove an instance configuration
  • hosts - Manage /etc/hosts entries for hostname forwarding
  • setup - Setup /etc/hosts entries for all configured databases
  • list - List all /etc/hosts entries managed by Devo CLI
  • add - Add a single database hostname to /etc/hosts
  • remove - Remove a database hostname from /etc/hosts
  • clear - Remove all Devo CLI managed entries from /etc/hosts

Use when: You need to connect to RDS, ElastiCache, or other AWS resources through a bastion instance.

(see also: SSM Port Forwarding Guide)

devo dynamodb

DynamoDB table management and data export utilities.

devo dynamodb <subcommand> [OPTIONS]

Commands:

  • list - List all DynamoDB tables in the region
  • describe - Show detailed information about a table
  • export - Export DynamoDB table to CSV, JSON, or JSONL format
  • list-templates - List all saved export templates

Use when: You need to list, describe, or export DynamoDB tables.

(see also: DynamoDB Export Guide)

devo eventbridge

Check EventBridge scheduled rules status by environment.

devo eventbridge [OPTIONS]

Options:

  • -e, --env TEXT - Filter by environment (e.g., dev, staging, prod)
  • -r, --region TEXT - AWS region (default: us-east-1)
  • -s, --status [enabled|disabled|all] - Filter by rule status
  • -o, --output [table|json] - Output format (default: table)

Use when: You need to monitor EventBridge scheduled rules and their status.

Utility Commands

devo upgrade

Update Devo CLI to the latest version.

devo upgrade [OPTIONS]

Options:

  • -f, --force - Force upgrade without confirmation
  • -c, --check - Check for updates without upgrading

Use when: You want to get the latest features and bug fixes.

devo autocomplete

Setup shell autocomplete for Devo CLI.

devo autocomplete [OPTIONS]

Options:

  • -i, --install - Automatically install autocomplete to shell config
  • -y, --yes - Skip confirmation prompt when installing

Use when: You want to enable tab completion for your shell.

Command Categories

Automation Features

  • commit - Generate commit messages
  • code-reviewer - Automated code review

AWS Integration

  • aws-login - AWS SSO authentication
  • codeartifact-login - CodeArtifact authentication
  • ssm - Session Manager port forwarding with hostname support
  • dynamodb - DynamoDB table management (list, describe, export)
  • eventbridge - EventBridge scheduled rules monitoring

Utility Commands

  • upgrade - Self-update
  • config - Configuration management
  • autocomplete - Shell completion

Global Options

All commands support these global options:

--profile TEXT    AWS profile to use (must come before command)
-v, --version     Show the version and exit
--help           Show help message

Examples

Basic Workflow

# 1. Make changes
git add .

# 2. Generate commit message
devo commit

# 3. Review code
devo code-reviewer

# 4. Push changes
git push

Commit with Options

# Add all changes, commit, and push
devo commit -A

# Commit and push
devo commit -p

# Commit, push, and open PR
devo commit -pr

With AWS Profile

# Use specific AWS profile (must come before command)
devo --profile production aws-login
devo --profile staging dynamodb list
devo --profile dev ssm database connect mydb

SSM Database Connection

# List databases
devo ssm database list

# Add a database
devo ssm database add

# Connect to database (with hostname forwarding)
devo ssm database connect mydb

# Setup /etc/hosts for all databases
devo ssm hosts setup

# Connect using shortcut
devo ssm connect mydb

DynamoDB Operations

# List all tables
devo dynamodb list

# Describe a table
devo dynamodb describe my-table

# Export table to CSV
devo dynamodb export my-table --format csv --output data.csv

# Export with filter
devo dynamodb export my-table --filter "status = 'active'" --format json

Configuration

# View current configuration
devo config show

# Set Bedrock model
devo config set bedrock.model_id us.anthropic.claude-sonnet-4-20250514-v1:0

# Export configuration
devo config export backup.json

# Import configuration
devo config import backup.json

Getting Help

Get help for any command:

# General help
devo --help

# Command-specific help
devo commit --help
devo code-reviewer --help
devo ssm database --help
devo ssm database connect --help

Next Steps