Registry / devops / aidevops

aidevops

JSON →
library3.8.74jsnpmunverified

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.

npm install aidevops
INSTALL
IMPORT
SIG · AIDEVOPS
A
aidevops
devopsjavascriptv3.8.74
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

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.

import { exec } from 'child_process'; import { promisify } from 'util'; const execPromise = promisify(exec); async function runAideVopsQuickstart() { console.log('--- AI DevOps Framework Quick Start ---'); // Ensure aidevops is installed globally (or install it) try { console.log('Checking aidevops installation...'); await execPromise('npm install -g aidevops'); console.log('aidevops installed or updated globally via npm.'); } catch (error) { console.error(`Failed to install aidevops: ${error.message}`); return; } // Update the framework and any registered projects try { console.log('\nUpdating framework and projects...'); const { stdout } = await execPromise('aidevops update'); console.log(stdout); } catch (error) { console.error(`Failed to update aidevops: ${error.message}`); } // Check the status of the aidevops installation try { console.log('\nChecking aidevops status...'); const { stdout } = await execPromise('aidevops status'); console.log(stdout); } catch (error) { console.error(`Failed to get aidevops status: ${error.message}`); } // Initialize aidevops in a new or existing project directory // This would typically be run within a specific project's root. // For demonstration, we'll just show the command. console.log('\nTo initialize aidevops in a project, navigate to your project directory and run:'); console.log(' aidevops init'); console.log('\nTo list registered projects:'); console.log(' aidevops list projects'); console.log('\n--- Quick Start Complete ---'); } runAideVopsQuickstart().catch(console.error);
aidevops --version
Debug
Known issues
gotchaThe 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.
fix
Interact with aidevops through your terminal using `aidevops <command>`, or programmatically via Node.js `child_process` (as shown in the quickstart).
affects: >=1.0.0
breakingThe `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.
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.
affects: >=3.0.0
gotchaThe 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.
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.
affects: >=1.0.0
gotchaThe `aidevops` CLI requires Node.js >=18.0.0. Running with older Node.js versions may lead to unexpected errors or installation failures.
fix
Upgrade your Node.js environment to version 18 or higher using tools like `nvm` or your system's package manager.
affects: <18.0.0
gotchaThe `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.
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.
affects: >=1.0.0
Errors
Common errors & fixes
aidevops: command not found
The aidevops CLI was not installed globally, or the installation directory is not in your system's PATH.
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.
Error: Node.js version x.y.z is not supported. Please use Node.js >=18.0.0.
Your current Node.js version does not meet the minimum requirement specified by the package.
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`.
API Key not found or invalid for AI provider: Anthropic
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.
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.
Git command failed: fatal: working tree 'path/to/worktree' is missing or not a working tree
A Git worktree managed by aidevops has been corrupted or manually removed, causing the framework to lose track of a project's state.
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.
Upgrade
Version history
3.8.74latest on npm
Audit
Dependencies
typescriptrequiredPeer dependency for TypeScript projects leveraging the framework. Node.js runtime is also a hard requirement.
Agent activity
73 hits · last 30 days
node
64
Perplexity
1
OpenAI (training)
1
Resources
aidevops — npm install aidevops · libregistry