{"id":14416,"library":"aidevops","title":"AI DevOps Framework","description":"AI DevOps Framework (aidevops) is an advanced AI operations platform and OpenCode plugin designed to automate and manage development, business, marketing, and creative projects. Currently at version 3.8.74, the framework is under active development with frequent minor releases, typically on a daily or near-daily cadence as evidenced by the release history (v3.8.74, v3.8.73, etc.). Key differentiators include autonomous orchestration by an AI supervisor, a suite of 13 multi-domain specialist AI agents (with over 900 subagents), multi-model safety verification for high-stakes operations, and cost-aware model routing for resource efficiency. It emphasizes a Git-first workflow, parallel agent execution using Git worktrees, and self-healing/self-improving capabilities. The framework is optimized for OpenCode and Claude models, providing enterprise-level security and quality control for autonomous project delivery.","status":"active","version":"3.8.74","language":"javascript","source_language":"en","source_url":"https://github.com/marcusquinn/aidevops","tags":["javascript","ai","devops","cli","automation","code-quality","git-workflow","mcp","llm"],"install":[{"cmd":"npm install aidevops","lang":"bash","label":"npm"},{"cmd":"yarn add aidevops","lang":"bash","label":"yarn"},{"cmd":"pnpm add aidevops","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency for TypeScript projects leveraging the framework. Node.js runtime is also a hard requirement.","package":"typescript","optional":false}],"imports":[],"quickstart":{"code":"import { exec } from 'child_process';\nimport { promisify } from 'util';\n\nconst execPromise = promisify(exec);\n\nasync function runAideVopsQuickstart() {\n  console.log('--- AI DevOps Framework Quick Start ---');\n\n  // Ensure aidevops is installed globally (or install it)\n  try {\n    console.log('Checking aidevops installation...');\n    await execPromise('npm install -g aidevops');\n    console.log('aidevops installed or updated globally via npm.');\n  } catch (error) {\n    console.error(`Failed to install aidevops: ${error.message}`);\n    return;\n  }\n\n  // Update the framework and any registered projects\n  try {\n    console.log('\\nUpdating framework and projects...');\n    const { stdout } = await execPromise('aidevops update');\n    console.log(stdout);\n  } catch (error) {\n    console.error(`Failed to update aidevops: ${error.message}`);\n  }\n\n  // Check the status of the aidevops installation\n  try {\n    console.log('\\nChecking aidevops status...');\n    const { stdout } = await execPromise('aidevops status');\n    console.log(stdout);\n  } catch (error) {\n    console.error(`Failed to get aidevops status: ${error.message}`);\n  }\n\n  // Initialize aidevops in a new or existing project directory\n  // This would typically be run within a specific project's root.\n  // For demonstration, we'll just show the command.\n  console.log('\\nTo initialize aidevops in a project, navigate to your project directory and run:');\n  console.log('  aidevops init');\n  console.log('\\nTo list registered projects:');\n  console.log('  aidevops list projects');\n\n  console.log('\\n--- Quick Start Complete ---');\n}\n\nrunAideVopsQuickstart().catch(console.error);\n","lang":"javascript","description":"This quickstart demonstrates how to install, update, and check the status of the AI DevOps Framework (aidevops) using its command-line interface, executed programmatically via Node.js's child_process.exec."},"warnings":[{"fix":"Interact with aidevops through your terminal using `aidevops <command>`, or programmatically via Node.js `child_process` (as shown in the quickstart).","message":"The framework is primarily a CLI tool (`aidevops`) designed for global installation and direct command execution. It is not intended for direct programmatic import into JavaScript/TypeScript applications as a library. Interaction is exclusively via shell commands.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Regularly run `aidevops update` to ensure you are on the latest stable version. Review the `CHANGELOG.md` (e.g., via `aidevops docs changelog`) before major deployments or critical AI tasks to understand recent changes.","message":"The `aidevops` framework, as an AI-driven system, is under continuous development. While semantic versioning is used, frequent minor releases (e.g., v3.8.x) may introduce behavioral changes to AI agents or workflows that, while not strictly API-breaking, might alter expected outcomes or require adjustments in prompts/configurations. Users should regularly review the `CHANGELOG.md` for detailed updates.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Ensure all necessary API keys for AI providers and OpenCode are correctly set in your environment or `aidevops` configuration. Monitor API usage and consult provider documentation for rate limits.","message":"The framework relies heavily on external AI models (e.g., Claude, via OpenCode) and requires proper configuration of API keys and access. Misconfigured credentials or exceeding rate limits will lead to operational failures for AI agents.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Upgrade your Node.js environment to version 18 or higher using tools like `nvm` or your system's package manager.","message":"The `aidevops` CLI requires Node.js >=18.0.0. Running with older Node.js versions may lead to unexpected errors or installation failures.","severity":"gotcha","affected_versions":"<18.0.0"},{"fix":"Always use `aidevops` commands for managing project workflows, branches, and worktrees. If manual Git intervention is necessary, proceed with caution and ensure you understand the framework's Git-first workflow implications.","message":"The `aidevops` framework creates and manages Git worktrees and branches for parallel agent execution. Incorrect manual manipulation of these Git structures outside of `aidevops` commands can lead to project inconsistencies or data loss.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-19T00:00:00.000Z","next_check":"2026-07-18T00:00:00.000Z","problems":[{"fix":"Run `npm install -g aidevops` (or `brew install marcusquinn/tap/aidevops`) and ensure your shell's PATH includes the npm global bin directory. Restart your terminal if necessary.","cause":"The aidevops CLI was not installed globally, or the installation directory is not in your system's PATH.","error":"aidevops: command not found"},{"fix":"Upgrade your Node.js environment to version 18 or higher. Consider using `nvm` (Node Version Manager) to easily switch between Node.js versions: `nvm install 18 && nvm use 18`.","cause":"Your current Node.js version does not meet the minimum requirement specified by the package.","error":"Error: Node.js version x.y.z is not supported. Please use Node.js >=18.0.0."},{"fix":"Set the appropriate environment variable (e.g., `ANTHROPIC_API_KEY`) with a valid key, or configure it via `aidevops config set <key> <value>` if supported.","cause":"The necessary API key for an underlying AI service (e.g., Claude via Anthropic) has not been set or is incorrect, preventing agents from making requests.","error":"API Key not found or invalid for AI provider: Anthropic"},{"fix":"Attempt to repair or re-initialize the worktree using `aidevops git repair` (if available) or manually recreate the project's state. In severe cases, you may need to re-initialize the project (`aidevops init`) and re-fetch changes.","cause":"A Git worktree managed by aidevops has been corrupted or manually removed, causing the framework to lose track of a project's state.","error":"Git command failed: fatal: working tree 'path/to/worktree' is missing or not a working tree"}],"ecosystem":"npm"}