Quick Start Guide¶

Get up and running with Devo CLI in 5 minutes.

Step 1 — Install¶

Linux/macOSWindows (PowerShell)

curl -fsSL https://raw.githubusercontent.com/edu526/devo-cli/main/install.sh | bash

irm https://raw.githubusercontent.com/edu526/devo-cli/main/install.ps1 | iex

Step 2 — Configure AWS¶

Devo CLI uses AWS Bedrock for AI features. You need valid AWS credentials:

# Option A: AWS SSO (recommended) — configure once, then use devo aws-login daily
aws configure sso              # first-time profile setup
devo aws-login login           # login (opens browser)
devo aws-login refresh         # refresh expired credentials without browser

# Option B: Access keys
aws configure

→ See the AWS Setup Guide for detailed setup including Bedrock model access.

Step 3 — Verify¶

devo --version
devo --help

Step 4 — First Commands¶

Generate a Commit Message¶

# Stage your changes
git add .

# Generate AI-powered commit message
devo commit

Review Your Branch¶

# Review current branch vs main/master
devo code-reviewer

Check Configuration¶

devo config show

Enable Shell Completion (Optional)¶

Add to your shell configuration file:

Zsh (~/.zshrc)Bash (~/.bashrc)Fish (~/.config/fish/config.fish)

eval "$(_DEVO_COMPLETE=zsh_source devo)"

eval "$(_DEVO_COMPLETE=bash_source devo)"

_DEVO_COMPLETE=fish_source devo | source

Then restart your terminal or run source ~/.zshrc (or equivalent).

Daily Workflow¶

# 1. Work on your feature branch
git checkout -b feature/my-feature

# 2. Refresh AWS credentials if expired
devo aws-login refresh

# 3. Make changes, then stage
git add .

# 4. Review branch before committing (optional)
devo code-reviewer

# 5. Generate commit message
devo commit

# 6. Push
git push

Working with AWS Profiles¶

# Use specific AWS profile
devo --profile production commit

# Or set default for the session
export AWS_PROFILE=production
devo commit

Update Devo CLI¶

devo upgrade

Next Steps¶

AWS Setup - Enable Bedrock model access and IAM permissions
Commit Workflow - Learn how commit message generation works
Code Review Workflow - AI-powered code review
Commands Reference - All available commands
Configuration - Bedrock model, GitHub, CodeArtifact settings

Troubleshooting¶

Command Not Found¶

Restart your terminal or add to PATH:

export PATH="$HOME/.local/bin:$PATH"

AWS Credentials Error¶

See AWS Setup Guide or run:

aws sts get-caller-identity  # verify credentials

Need Help?¶

devo --help
devo commit --help

See Troubleshooting Guide for more help.