devvami 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Devvami Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,255 @@
+<p align="center">
+  <img src="docs/banner.jpg" alt="Devvami" width="100%" />
+</p>
+
+# 🧰 Devvami
+
+<p align="center">
+  <strong>DevEx CLI for developers and teams — manage repos, PRs, pipelines, and costs from the terminal.</strong><br/>
+  Built for teams that move fast.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/devvami"><img alt="npm" src="https://img.shields.io/npm/v/devvami?color=CB3837" /></a>
+  <a href="https://github.com/savez/devvami/actions"><img alt="ci" src="https://img.shields.io/github/actions/workflow/status/savez/devvami/release.yml?label=CI" /></a>
+  <a href="LICENSE"><img alt="license" src="https://img.shields.io/badge/license-MIT-lightgrey" /></a>
+  <a href="https://node.green/#ESMM"><img alt="node" src="https://img.shields.io/badge/node-%3E%3D24-green" /></a>
+</p>
+
+---
+
+## ✨ 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
+
+```bash
+npm install -g devvami
+```
+
+### First Time Setup
+
+```bash
+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
+
+```bash
+dvmi --version
+dvmi --help
+dvmi doctor
+```
+
+---
+
+## 📖 Commands
+
+### Organization
+
+```bash
+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
+
+```bash
+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
+
+```bash
+dvmi repo list     # List all repos in your org
+dvmi create repo   # Create a new repo from template
+```
+
+### CI/CD Pipelines
+
+```bash
+dvmi pipeline status   # Show workflow status
+dvmi pipeline logs     # View workflow logs
+dvmi pipeline rerun    # Rerun a failed workflow
+```
+
+### Tasks & Work
+
+```bash
+dvmi tasks list       # List all tasks
+dvmi tasks today      # Show today's tasks
+dvmi tasks assigned   # Show tasks assigned to you
+```
+
+### Costs
+
+```bash
+dvmi costs get     # Analyze AWS costs
+```
+
+### Documentation
+
+```bash
+dvmi docs list       # List docs in repositories
+dvmi docs read       # Read documentation
+dvmi docs search     # Search docs
+dvmi docs projects   # List documented projects
+```
+
+### Other
+
+```bash
+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`:
+
+```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](#-quick-start) above
+- **Commands**: Run `dvmi --help` or `dvmi <command> --help`
+- **Contributing**: See [CONTRIBUTING.md](CONTRIBUTING.md)
+- **Security**: See [SECURITY.md](SECURITY.md)
+- **Code of Conduct**: See [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for:
+
+- **Development setup**
+- **Code style** (JavaScript ESM + JSDoc)
+- **Testing & linting**
+- **Commit conventions**
+- **PR process**
+
+Quick start:
+
+```bash
+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](https://github.com/nvm-sh/nvm))
+- **pnpm >= 10** or npm/yarn
+- **Git**
+- **GitHub CLI** (`gh`) — recommended
+- **AWS CLI** — optional, for cost analysis
+
+---
+
+## 🐛 Found a Bug?
+
+Please open an [issue](https://github.com/savez/devvami/issues/new?template=bug_report.md) 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](SECURITY.md).
+
+---
+
+## 💡 Have an Idea?
+
+Open a [feature request](https://github.com/savez/devvami/issues/new?template=feature_request.md)
+
+---
+
+## 📄 License
+
+MIT License — See [LICENSE](LICENSE) for details.
+
+---
+
+## 🙏 Credits
+
+Built with:
+
+- [oclif](https://oclif.io/) — CLI framework
+- [octokit](https://github.com/octokit/rest.js) — GitHub API
+- [chalk](https://github.com/chalk/chalk) — Colored output
+- [ora](https://github.com/sindresorhus/ora) — Spinners
+- [keytar](https://github.com/atom/node-keytar) — Secure credentials
+- [@inquirer/prompts](https://github.com/SBoudrias/Inquirer.js) — Interactive prompts
+
+---
+
+**Made with ❤️ by [Devvami Contributors](https://github.com/savez/devvami/graphs/contributors)**

package/bin/dev.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node --loader ts-node/esm --no-warnings=ExperimentalWarning "%~dp0\dev" %*

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env -S node --loader ts-node/esm --disable-warning=ExperimentalWarning
+
+import {execute} from '@oclif/core'
+
+await execute({development: true, dir: import.meta.url})

package/bin/run.cmd

@@ -0,0 +1,3 @@
+@echo off
+
+node "%~dp0\run" %*

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})