@devlitusp/opencode-agent 0.0.4 → 0.0.5

package/README.md

@@ -1,17 +1,45 @@
 # @devlitusp/opencode-agent
 
-Multi-agent development team for [OpenCode CLI](https://opencode.ai). One command sets up a full team of AI agents in your project — orchestrator, investigator, planner, builder, QA, security, and docs writer.
+Multi-agent development team for [OpenCode CLI](https://opencode.ai). One command sets up a full team of AI agents in your project — orchestrator, investigator, planner, builder, QA, security, docs, debugger, performance, devops, and refactorer.
 
-## Quick start
+## Installation
+
+### pnpm (recommended)
 
 ```bash
 pnpm dlx @devlitusp/opencode-agent init
 ```
 
-This single command:
-1. Adds `@devlitusp/opencode-agent` to your `devDependencies`
-2. Configures pnpm to allow the postinstall script
-3. Installs the package and runs the setup automatically
+This is the only command needed. It handles the pnpm security restriction that blocks postinstall scripts by default, adds the package to `devDependencies`, and injects all agents automatically.
+
+> **Why `dlx init` and not `pnpm add`?**
+> pnpm v8+ blocks postinstall scripts from dependencies unless explicitly allowed. Running `pnpm add --save-dev @devlitusp/opencode-agent` installs the package but **nothing gets injected**. The `init` command adds `@devlitusp/opencode-agent` to `pnpm.onlyBuiltDependencies` in your `package.json` before installing, which allows the postinstall to run.
+
+### npm
+
+```bash
+npm install --save-dev @devlitusp/opencode-agent
+```
+
+npm runs postinstall scripts automatically — agents are injected immediately after install.
+
+### yarn
+
+```bash
+yarn add --dev @devlitusp/opencode-agent
+```
+
+yarn runs postinstall scripts automatically — agents are injected immediately after install.
+
+### bun
+
+```bash
+bun add --dev @devlitusp/opencode-agent
+```
+
+bun runs postinstall scripts automatically — agents are injected immediately after install.
+
+---
 
 Then set your API key and open OpenCode:
 
@@ -26,12 +54,16 @@ export GITHUB_TOKEN=your_token_here    # GitHub Copilot
 ```
 .opencode/agents/
   orchestrator.md   ← primary agent, coordinates the team
-  investigator.md   ← analyzes codebase and requirements
+  investigator.md   ← researches libraries and external APIs
   planner.md        ← creates implementation plans
   builder.md        ← writes the code
   qa.md             ← quality assurance and tests
   security.md       ← vulnerability scanning (OWASP Top 10)
   docs-writer.md    ← JSDoc, README, documentation
+  debugger.md       ← diagnoses errors and stack traces
+  performance.md    ← profiles bottlenecks and optimizations
+  devops.md         ← CI/CD, Docker, infrastructure-as-code
+  refactorer.md     ← improves code structure without changing behavior
 
 opencode.json       ← provider config + default_agent
 ```
@@ -41,25 +73,40 @@ opencode.json       ← provider config + default_agent
 | Agent | Mode | Role |
 |-------|------|------|
 | `orchestrator` | primary | Coordinates the full dev workflow |
-| `investigator` | subagent | Analyzes codebase, researches requirements |
+| `investigator` | subagent | Researches libraries, frameworks, and external APIs |
 | `planner` | subagent | Creates detailed implementation plans |
 | `builder` | subagent | Implements code following the plan |
 | `qa` | subagent | Reviews quality, writes tests |
 | `security` | subagent | Scans for vulnerabilities (pre and post build) |
 | `docs-writer` | subagent | Writes JSDoc, README sections, examples |
+| `debugger` | subagent | Diagnoses errors, analyzes stack traces |
+| `performance` | subagent | Profiles bottlenecks, recommends optimizations |
+| `devops` | subagent | Handles CI/CD, Docker, deployment configs |
+| `refactorer` | subagent | Improves code structure without changing behavior |
 
-## Development workflow
+## Development workflows
 
-The orchestrator follows this sequence automatically:
+The orchestrator selects the right workflow based on the task:
 
 ```
+# Standard feature
 investigate → plan → security (pre) → build → QA → security (post) → docs
+
+# Bug report
+debugger (diagnose) → builder (fix) → qa (verify)
+
+# Performance issue
+performance (profile) → builder (optimize) → qa (benchmark)
+
+# Cleanup / refactor
+refactorer (plan) → builder (apply) → qa (verify)
+
+# Deployment task
+devops (design) → security (review) → builder (implement)
 ```
 
 ## Providers
 
-Two providers are supported out of the box:
-
 | Provider | Flag | Model | Env var |
 |----------|------|-------|---------|
 | [MiniMax](https://platform.minimax.io) | `minimax` *(default)* | `MiniMax-M2.7` | `MINIMAX_API_KEY` |
@@ -77,34 +124,13 @@ GitHub Copilot also exposes `gpt-4o-mini`, `o3-mini`, `claude-sonnet-4-5`, and `
 ## CLI
 
 ```bash
-opencode-agent init                              # full project setup
+opencode-agent init                              # full project setup (pnpm-safe)
 opencode-agent inject                            # inject with MiniMax (default)
 opencode-agent inject --provider github-copilot # inject with GitHub Copilot
 opencode-agent inject -f                         # overwrite existing agent files
 opencode-agent list                              # list available agents
 ```
 
-## Manual install (npm / yarn / bun)
-
-```bash
-# npm
-npm install --save-dev @devlitusp/opencode-agent
-
-# yarn
-yarn add --dev @devlitusp/opencode-agent
-
-# bun
-bun add --dev @devlitusp/opencode-agent
-```
-
-Then run:
-
-```bash
-opencode-agent inject
-# or with GitHub Copilot:
-opencode-agent inject --provider github-copilot
-```
-
 ## License
 
 MIT

package/dist/bin/dev-agents.js

@@ -687,7 +687,7 @@ var MINIMAX_PROVIDER = {
   npm: "@ai-sdk/openai-compatible",
   name: "MiniMax",
   options: {
-    baseURL: "https://api.minimax.chat/v1",
+    baseURL: "https://api.minimax.io/v1",
     apiKey: "{env:MINIMAX_API_KEY}"
   },
   models: {
@@ -827,7 +827,7 @@ function inject(options = {}) {
       pkg["scripts"] = scripts;
       writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + `
 `, "utf-8");
-      log(`Added "prepare": "dev-agents inject" to package.json`);
+      log(`Added "prepare": "opencode-agent inject" to package.json`);
     } else {
       log(`Skipped package.json prepare script (already exists)`);
     }
@@ -883,6 +883,7 @@ Install failed. Try running manually:
   ${installCmd}`);
     process.exit(1);
   }
+  inject({ cwd, verbose: true });
 }
 function detectPackageManager(cwd) {
   const agent = process.env["npm_config_user_agent"] ?? "";

package/dist/bin/postinstall.js

@@ -686,7 +686,7 @@ var MINIMAX_PROVIDER = {
   npm: "@ai-sdk/openai-compatible",
   name: "MiniMax",
   options: {
-    baseURL: "https://api.minimax.chat/v1",
+    baseURL: "https://api.minimax.io/v1",
     apiKey: "{env:MINIMAX_API_KEY}"
   },
   models: {
@@ -826,7 +826,7 @@ function inject(options = {}) {
       pkg["scripts"] = scripts;
       writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + `
 `, "utf-8");
-      log(`Added "prepare": "dev-agents inject" to package.json`);
+      log(`Added "prepare": "opencode-agent inject" to package.json`);
     } else {
       log(`Skipped package.json prepare script (already exists)`);
     }
@@ -858,14 +858,14 @@ try {
 } catch {}
 try {
   console.log(`
-[dev-agents] Injecting OpenCode agent config...
+[opencode-agent] Injecting OpenCode agent config...
 `);
   inject({ cwd: projectRoot, verbose: true });
   console.log(`
-[dev-agents] Done! Set MINIMAX_API_KEY in your environment and open OpenCode.
-` + `[dev-agents] Use the orchestrator agent to start the full development workflow.
+[opencode-agent] Done! Set MINIMAX_API_KEY in your environment and open OpenCode.
+` + `[opencode-agent] Use the orchestrator agent to start the full development workflow.
 `);
 } catch (err) {
   console.warn(`
-[dev-agents] Warning: could not inject config:`, err instanceof Error ? err.message : err, "\nRun `dev-agents inject` manually to retry.\n");
+[opencode-agent] Warning: could not inject config:`, err instanceof Error ? err.message : err, "\nRun `opencode-agent inject` manually to retry.\n");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devlitusp/opencode-agent",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Multi-agent development team for OpenCode CLI — orchestrator, investigator, planner, builder, QA, security & docs",
   "type": "module",
   "bin": {

package/src/init.ts

@@ -1,6 +1,7 @@
 import { execSync } from "child_process";
 import { existsSync, readFileSync, writeFileSync } from "fs";
 import { join } from "path";
+import { inject } from "./inject.js";
 
 const PACKAGE_NAME = "@devlitusp/opencode-agent";
 
@@ -44,6 +45,11 @@ export function init(cwd: string = process.cwd()): void {
     console.error(`\nInstall failed. Try running manually:\n  ${installCmd}`);
     process.exit(1);
   }
+
+  // pnpm rewrites package.json after the install, which can overwrite changes
+  // made by postinstall (e.g. the prepare script). Run inject() explicitly here
+  // so it always runs after pnpm has finished modifying package.json.
+  inject({ cwd, verbose: true });
 }
 
 function detectPackageManager(cwd: string): string {

package/src/inject.ts

@@ -10,7 +10,7 @@ const MINIMAX_PROVIDER: OpenCodeProvider = {
   npm: "@ai-sdk/openai-compatible",
   name: "MiniMax",
   options: {
-    baseURL: "https://api.minimax.chat/v1",
+    baseURL: "https://api.minimax.io/v1",
     apiKey: "{env:MINIMAX_API_KEY}",
   },
   models: {
@@ -183,7 +183,7 @@ export function inject(options: InjectOptions = {}): void {
       scripts["prepare"] = "opencode-agent inject";
       pkg["scripts"] = scripts;
       writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
-      log(`Added "prepare": "dev-agents inject" to package.json`);
+      log(`Added "prepare": "opencode-agent inject" to package.json`);
     } else {
       log(`Skipped package.json prepare script (already exists)`);
     }