🧰 Devvami

DevEx CLI for developers and teams — manage repos, PRs, pipelines, and costs from the terminal.
Built for teams that move fast.

---

✨ What It Does

Devvami gives you a unified CLI to manage your entire development workflow:

Feature	What You Can Do
🔀 Pull Requests	Create, review, and track PRs with presets
🚀 Pipelines	Monitor CI/CD runs, view logs, rerun failures
📁 Repositories	List and manage GitHub repos
💸 Costs	Analyze AWS costs by service
✅ Tasks	View and manage tasks without leaving the terminal
📖 Docs	Search and read repository documentation
🔍 Search	Search code across repositories
🩺 Health Check	Diagnose your development environment

All from your terminal. No context switching.

---

🚀 Quick Start

Installation

npm install -g devvami

First Time Setup

dvmi init

This wizard will:

• Check your development prerequisites
• Ask about GitHub organization (optional)
• Configure AWS profile and region
• Set up integrations (GitHub, AWS, task management)

Verify Installation

dvmi --version
dvmi --help
dvmi doctor

---

📖 Commands

Organization

dvmi init          # Setup: configure auth, org, AWS, integrations
dvmi doctor        # Health check: verify your environment
dvmi upgrade       # Update to latest version
dvmi whoami        # Show current identity (GitHub, AWS, etc.)

Pull Requests

dvmi pr create     # Create a PR with presets
dvmi pr status     # Show PR status for current branch
dvmi pr detail     # View detailed PR information
dvmi pr review     # Review a PR

Repositories

dvmi repo list     # List all repos in your org
dvmi create repo   # Create a new repo from template

CI/CD Pipelines

dvmi pipeline status   # Show workflow status
dvmi pipeline logs     # View workflow logs
dvmi pipeline rerun    # Rerun a failed workflow

Tasks & Work

dvmi tasks list       # List all tasks
dvmi tasks today      # Show today's tasks
dvmi tasks assigned   # Show tasks assigned to you

Costs

dvmi costs get     # Analyze AWS costs

Documentation

dvmi docs list       # List docs in repositories
dvmi docs read       # Read documentation
dvmi docs search     # Search docs
dvmi docs projects   # List documented projects

Other

dvmi auth login      # Login to GitHub/AWS
dvmi search          # Search code across repos
dvmi changelog       # Generate changelog from commits
dvmi open            # Open resources in browser

---

⚙️ Configuration

Devvami stores config at ~/.config/dvmi/config.json:

{
  "org": "myorg",
  "awsProfile": "default",
  "awsRegion": "eu-west-1",
  "shell": "osxkeychain",
  "clickup": {
    "teamId": "...",
    "teamName": "My Team",
    "authMethod": "personal_token"
  }
}

Run dvmi init to update settings anytime.

---

🔐 Credentials

Devvami uses your system's secure credential storage:

• macOS: Keychain
• Linux: Secret Service / pass
• Windows: Credential Manager

Tokens are never stored in plain text. They're stored securely via @keytar/keytar.

---

📚 Documentation

• Setup: See Quick Start above
• Commands: Run dvmi --help or dvmi <command> --help
• Contributing: See CONTRIBUTING.md
• Security: See SECURITY.md
• Code of Conduct: See CODE_OF_CONDUCT.md

---

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for:

• Development setup
• Code style (JavaScript ESM + JSDoc)
• Testing & linting
• Commit conventions
• PR process

Quick start:

git clone https://github.com/savez/devvami
cd devvami
nvm use
pnpm install
pnpm test
pnpm lint
pnpm commit  # Use interactive commit

---

📋 Requirements

• Node.js >= 24 (managed with nvm)
• pnpm >= 10 or npm/yarn
• Git
• GitHub CLI (gh) — recommended
• AWS CLI — optional, for cost analysis

---

🐛 Found a Bug?

Please open an issue with:

• Clear description of the problem
• Steps to reproduce
• Your environment (OS, Node.js version, etc.)
• Expected vs. actual behavior

For security issues, see SECURITY.md.

---

💡 Have an Idea?

Open a feature request

---

📄 License

MIT License — See LICENSE for details.

---

🙏 Credits

Built with:

• oclif — CLI framework
• octokit — GitHub API
• chalk — Colored output
• ora — Spinners
• keytar — Secure credentials
• @inquirer/prompts — Interactive prompts

---

Made with ❤️ by Devvami Contributors