@devlitusp/opencode-agent 0.0.4 → 0.0.6

package/README.md

@@ -1,19 +1,96 @@
 # @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). 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
+
+### npm
+
+```bash
+npm install --save-dev @devlitusp/opencode-agent
+```
+
+npm runs postinstall scripts automatically. Agents are injected immediately — no extra steps needed.
+
+---
+
+### yarn
+
+```bash
+yarn add --dev @devlitusp/opencode-agent
+```
+
+yarn runs postinstall scripts automatically. Agents are injected immediately — no extra steps needed.
+
+---
+
+### bun
+
+```bash
+bun add --dev @devlitusp/opencode-agent
+```
+
+bun runs postinstall scripts automatically. Agents are injected immediately — no extra steps needed.
+
+---
+
+### pnpm
+
+pnpm v10+ **blocks all postinstall scripts by default** for security. You must explicitly allow this package to run its script before installing.
+
+**Option A — use `init` (recommended, handles everything automatically):**
 
 ```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 adds the package to the allowlist, installs it, and injects the agents in one step.
+
+**Option B — `pnpm-workspace.yaml` (pnpm v10.26.0+):**
 
-Then set your API key and open OpenCode:
+Add to your `pnpm-workspace.yaml`:
+
+```yaml
+allowBuilds:
+  - "@devlitusp/opencode-agent"
+```
+
+Then install:
+
+```bash
+pnpm add --save-dev @devlitusp/opencode-agent
+```
+
+**Option C — `package.json`:**
+
+Add to your `package.json`:
+
+```json
+{
+  "pnpm": {
+    "onlyBuiltDependencies": ["@devlitusp/opencode-agent"]
+  }
+}
+```
+
+Then install:
+
+```bash
+pnpm add --save-dev @devlitusp/opencode-agent
+```
+
+**Option D — allow all builds (not recommended):**
+
+```bash
+pnpm config set dangerouslyAllowAllBuilds true --global
+pnpm add --save-dev @devlitusp/opencode-agent
+```
+
+> If you skip the allowlist and install directly with `pnpm add`, the package is added to `devDependencies` but the postinstall is silently skipped — no agents are created. Run `opencode-agent inject` manually afterwards to fix this.
+
+---
+
+After installation, set your API key and open OpenCode:
 
 ```bash
 export MINIMAX_API_KEY=your_key_here   # MiniMax (default)
@@ -26,12 +103,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 +122,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 +173,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

@@ -7,7 +7,7 @@ import { join } from "path";
 var orchestrator = {
   name: "orchestrator",
   frontmatter: {
-    model: "minimax/MiniMax-M2.7",
+    model: "MiniMax-M2.7",
     description: "Lead coordinator that orchestrates the full development workflow",
     mode: "primary",
     temperature: 0.2,
@@ -685,10 +685,9 @@ var ALL_AGENTS = [
 var MINIMAX_PROVIDER_KEY = "minimax";
 var MINIMAX_PROVIDER = {
   npm: "@ai-sdk/openai-compatible",
-  name: "MiniMax",
+  name: "minimax",
   options: {
-    baseURL: "https://api.minimax.chat/v1",
-    apiKey: "{env:MINIMAX_API_KEY}"
+    baseURL: "https://minimax.io"
   },
   models: {
     "MiniMax-M2.7": { name: "MiniMax-M2.7" }
@@ -827,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)`);
     }
@@ -883,6 +882,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

@@ -6,7 +6,7 @@ import { join } from "path";
 var orchestrator = {
   name: "orchestrator",
   frontmatter: {
-    model: "minimax/MiniMax-M2.7",
+    model: "MiniMax-M2.7",
     description: "Lead coordinator that orchestrates the full development workflow",
     mode: "primary",
     temperature: 0.2,
@@ -684,10 +684,9 @@ var ALL_AGENTS = [
 var MINIMAX_PROVIDER_KEY = "minimax";
 var MINIMAX_PROVIDER = {
   npm: "@ai-sdk/openai-compatible",
-  name: "MiniMax",
+  name: "minimax",
   options: {
-    baseURL: "https://api.minimax.chat/v1",
-    apiKey: "{env:MINIMAX_API_KEY}"
+    baseURL: "https://minimax.io"
   },
   models: {
     "MiniMax-M2.7": { name: "MiniMax-M2.7" }
@@ -826,7 +825,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 +857,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.6",
   "description": "Multi-agent development team for OpenCode CLI — orchestrator, investigator, planner, builder, QA, security & docs",
   "type": "module",
   "bin": {

package/src/agents/orchestrator.ts

@@ -3,7 +3,7 @@ import type { AgentDefinition } from "../types.js";
 export const orchestrator: AgentDefinition = {
   name: "orchestrator",
   frontmatter: {
-    model: "minimax/MiniMax-M2.7",
+    model: "MiniMax-M2.7",
     description: "Lead coordinator that orchestrates the full development workflow",
     mode: "primary",
     temperature: 0.2,

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

@@ -8,10 +8,9 @@ import type { AgentDefinition, AgentFrontmatter, InjectOptions, OpenCodeConfig,
 const MINIMAX_PROVIDER_KEY = "minimax";
 const MINIMAX_PROVIDER: OpenCodeProvider = {
   npm: "@ai-sdk/openai-compatible",
-  name: "MiniMax",
+  name: "minimax",
   options: {
-    baseURL: "https://api.minimax.chat/v1",
-    apiKey: "{env:MINIMAX_API_KEY}",
+    baseURL: "https://minimax.io",
   },
   models: {
     "MiniMax-M2.7": { name: "MiniMax-M2.7" },
@@ -183,7 +182,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)`);
     }

package/src/types.ts

@@ -27,8 +27,8 @@ export interface AgentDefinition {
 }
 
 export interface ProviderApiOptions {
-  baseURL: string;
-  apiKey: string;
+  baseURL?: string;
+  apiKey?: string;
 }
 
 export interface OpenCodeProvider {