opencode-magi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hirotomo Yamada
+
+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,159 @@
+# OpenCode Magi
+
+Multi-agent GitHub pull request review and merge orchestration for OpenCode.
+
+## Why Magi?
+
+Magi is inspired by the three wise men: independent perspectives that reach a decision together.
+
+One AI model is still not enough to trust blindly. OpenCode Magi improves confidence by asking multiple models to inspect the same pull request from different perspectives, then requiring an odd-number majority before approving, requesting changes, or closing.
+
+The goal is not to treat a single AI answer as final, but to make AI review behave more like a real team: diverse viewpoints, explicit disagreement, and a final decision backed by consensus.
+
+## Features
+
+OpenCode Magi recreates the review cycle humans already run on GitHub: multiple reviewers inspect a pull request, request changes, verify fixes, resolve threads, and approve when the work is ready.
+
+- Multi-agent reviews with an odd-number majority of 3 or more reviewers.
+- Optional unanimous approval policy for merge automation when every reviewer must approve before a PR is merged.
+- Finding-level voting before posting change requests, so only findings accepted by reviewer majority are submitted.
+- Each reviewer acts through its configured GitHub account, posting real reviews, approvals, change requests, and follow-up comments.
+- Re-review support for edited PRs: fixed threads are resolved, satisfied reviewers approve, and remaining issues are posted as additional comments.
+- Optional merge and close automation where an editor agent responds on behalf of the author, fixes changes it agrees with, pushes commits when needed, and repeats the reviewer/editor cycle until the PR can be approved, queued, merged, or closed.
+- Per-agent OpenCode permissions for reviewer, CI classifier, and editor child sessions.
+- Prompt customization that adds repository-specific guidance without replacing the fixed output contracts.
+
+## Quick Start
+
+### Install
+
+Add the plugin to `opencode.json`.
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-magi"]
+}
+```
+
+### Configure
+
+Configure global defaults in `~/.config/opencode/magi.json` and project overrides in `<project>/.opencode/magi.json`.
+
+Magi config files are merged by OpenCode Magi, not by OpenCode. Priority, lowest to highest.
+
+1. `~/.config/opencode/magi.json`
+2. `<project>/.opencode/magi.json`
+
+#### Set global config
+
+You do not need to set global config values if the settings exist in your project config. However, using the global config is useful when you want to apply shared values across multiple projects.
+
+```bash
+mkdir -p ~/.config/opencode
+touch ~/.config/opencode/magi.json
+```
+
+Add the following content to the configuration file.
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/hirotomoyamada/opencode-magi/main/schema.json",
+  "agents": {
+    "reviewers": [
+      {
+        "account": "your-account-1",
+        "model": "openai/gpt-5.5"
+      },
+      {
+        "account": "your-account-2",
+        "model": "anthropic/claude-opus-4-7"
+      },
+      {
+        "account": "your-account-3",
+        "model": "opencode/kimi-k2-6"
+      }
+    ]
+  }
+}
+```
+
+`agents.reviewers[].account` is the GitHub account used to post reviews and approvals. Must be authenticated with `gh auth token --user <account>` and must be unique.
+
+#### Set project config
+
+Global config is optional, but project config is required.
+
+```bash
+cd <project>
+mkdir -p .opencode
+touch .opencode/magi.json
+```
+
+Add the following content to the configuration file.
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/hirotomoyamada/opencode-magi/main/schema.json",
+  "github": {
+    "owner": "your-owner",
+    "repo": "your-repo"
+  },
+  "agents": {
+    "reviewers": [
+      {
+        "account": "your-account-1",
+        "model": "openai/gpt-5.5"
+      },
+      {
+        "account": "your-account-2",
+        "model": "anthropic/claude-opus-4-7"
+      },
+      {
+        "account": "your-account-3",
+        "model": "opencode/kimi-k2-6"
+      }
+    ],
+    "editor": {
+      "account": "your-editor-account",
+      "model": "openai/gpt-5.5",
+      "author": {
+        "name": "your-account",
+        "email": "your-email@example.com"
+      }
+    }
+  }
+}
+```
+
+`agents.reviewers[].account` is the GitHub account used to post reviews and approvals. Must be authenticated with `gh auth token --user <account>` and must be unique.
+
+#### Validate config
+
+After creating or updating your global or project configuration, validate it.
+
+```txt
+/magi:validate
+```
+
+### Commands
+
+Run commands from OpenCode.
+
+```txt
+/magi:review 123 124
+/magi:review --dry-run 123
+/magi:merge 123
+/magi:merge --dry-run 123
+/magi:clear
+```
+
+## Docs
+
+- [Commands](docs/commands/index.md)
+- [Config](docs/config.md)
+- [Prompts](docs/prompts.md)
+
+## Contributing
+
+Wouldn't you like to contribute? That's amazing! We have prepared a [contribution guide](CONTRIBUTING.md) to assist you.

package/dist/commands.js

@@ -0,0 +1,18 @@
+export const MAGI_COMMANDS = {
+    "magi:clear": {
+        description: "Clear inactive Magi runs, sessions, worktrees, and outputs",
+        template: "Call the `magi_clear` tool.",
+    },
+    "magi:merge": {
+        description: "Review and merge pull requests with Magi",
+        template: [`Call the \`magi_merge\` tool.`, "PR: $ARGUMENTS"].join("\n"),
+    },
+    "magi:review": {
+        description: "Review pull requests with Magi",
+        template: [`Call the \`magi_review\` tool.`, "PR: $ARGUMENTS"].join("\n"),
+    },
+    "magi:validate": {
+        description: "Validate Magi config",
+        template: "Call the `magi_validate` tool.",
+    },
+};

package/dist/config/load.js

@@ -0,0 +1,62 @@
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { isAbsolute, join } from "node:path";
+const GLOBAL_CONFIG = join(homedir(), ".config", "opencode", "magi.json");
+const PROJECT_CONFIG = join(".opencode", "magi.json");
+function isPlainObject(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        !Array.isArray(value) &&
+        Object.getPrototypeOf(value) === Object.prototype);
+}
+export function mergeMagiConfig(base, override) {
+    const merged = { ...base };
+    for (const [key, value] of Object.entries(override)) {
+        const existing = merged[key];
+        merged[key] =
+            isPlainObject(existing) && isPlainObject(value)
+                ? mergeMagiConfig(existing, value)
+                : value;
+    }
+    return merged;
+}
+async function readConfig(path) {
+    try {
+        return JSON.parse(await readFile(path, "utf8"));
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT")
+            return null;
+        throw error;
+    }
+}
+export async function loadConfig(directory, configPath) {
+    if (configPath) {
+        const path = isAbsolute(configPath)
+            ? configPath
+            : join(directory, configPath);
+        const config = await readConfig(path);
+        if (!config)
+            throw new Error(`Magi config not found: ${path}`);
+        return { config: config, path };
+    }
+    const projectPath = join(directory, PROJECT_CONFIG);
+    const configs = await Promise.all([
+        readConfig(GLOBAL_CONFIG),
+        readConfig(projectPath),
+    ]);
+    const loaded = configs
+        .map((config, index) => ({
+        config,
+        path: index === 0 ? GLOBAL_CONFIG : projectPath,
+    }))
+        .filter((item) => Boolean(item.config));
+    if (!loaded.length)
+        throw new Error(`Magi config not found. Tried: ${GLOBAL_CONFIG}, ${projectPath}`);
+    const config = loaded.reduce((merged, item) => mergeMagiConfig(merged, item.config), {});
+    return {
+        config: config,
+        path: loaded.map((item) => item.path).join(", "),
+    };
+}

package/dist/config/output.js

@@ -0,0 +1,16 @@
+import { isAbsolute, join } from "node:path";
+const DEFAULT_OUTPUT_DIRS = {
+    pr: ".magi/runs/pr",
+};
+function resolvePath(directory, path) {
+    return isAbsolute(path) ? path : join(directory, path);
+}
+export function outputBaseDir(directory, config, kind) {
+    return resolvePath(directory, config.output?.dirs?.[kind] ?? DEFAULT_OUTPUT_DIRS[kind]);
+}
+export function outputBaseDirs(directory, config) {
+    return [outputBaseDir(directory, config, "pr")];
+}
+export function prRunOutputDir(input) {
+    return join(outputBaseDir(input.directory, input.config, "pr"), String(input.pr), ...(input.runId ? [input.runId] : []));
+}

package/dist/config/resolve.js

@@ -0,0 +1,113 @@
+import editorPermission from "../permissions/editor.json" with { type: "json" };
+import commonPermission from "../permissions/common.json" with { type: "json" };
+const ID_PATTERN = /^[A-Za-z0-9_-]+$/;
+const DEFAULT_COMMON_PERMISSION = commonPermission;
+const DEFAULT_REVIEWER_PERMISSION = DEFAULT_COMMON_PERMISSION;
+const DEFAULT_EDITOR_PERMISSION = mergePermissions(DEFAULT_COMMON_PERMISSION, editorPermission);
+export function reviewerKey(reviewer, index) {
+    return reviewer.id ?? `reviewer-${index + 1}`;
+}
+export function validateReviewerId(id) {
+    return ID_PATTERN.test(id);
+}
+function clonePermissionValue(value) {
+    return typeof value === "string" ? value : { ...value };
+}
+export function mergePermissions(base, override) {
+    if (!override) {
+        return typeof base === "string"
+            ? base
+            : Object.fromEntries(Object.entries(base).map(([key, value]) => [
+                key,
+                clonePermissionValue(value),
+            ]));
+    }
+    if (typeof override === "string")
+        return override;
+    if (typeof base === "string") {
+        return Object.fromEntries(Object.entries(override).map(([key, value]) => [
+            key,
+            clonePermissionValue(value),
+        ]));
+    }
+    const merged = Object.fromEntries(Object.entries(base).map(([key, value]) => [
+        key,
+        clonePermissionValue(value),
+    ]));
+    for (const [permission, value] of Object.entries(override)) {
+        const existing = merged[permission];
+        merged[permission] =
+            existing && typeof existing !== "string" && typeof value !== "string"
+                ? { ...existing, ...value }
+                : clonePermissionValue(value);
+    }
+    return merged;
+}
+export function resolveReviewerPermission(agents, reviewer) {
+    return mergePermissions(mergePermissions(DEFAULT_REVIEWER_PERMISSION, agents.permissions), reviewer.permission);
+}
+export function resolveEditorPermission(agents, editor) {
+    return mergePermissions(mergePermissions(DEFAULT_EDITOR_PERMISSION, agents.permissions), editor.permission);
+}
+export function resolveAgents(agents) {
+    return {
+        editor: agents.editor
+            ? {
+                ...agents.editor,
+                permission: resolveEditorPermission(agents, agents.editor),
+            }
+            : undefined,
+        reviewers: (agents.reviewers ?? []).map((reviewer, index) => ({
+            ...reviewer,
+            key: reviewerKey(reviewer, index),
+            index,
+            permission: resolveReviewerPermission(agents, reviewer),
+        })),
+    };
+}
+export function resolveRepository(config) {
+    if (!config.github?.owner)
+        throw new Error("github.owner is required");
+    if (!config.github?.repo)
+        throw new Error("github.repo is required");
+    return {
+        alias: config.github.repo,
+        agents: resolveAgents(config.agents),
+        automation: {
+            close: config.automation?.close ?? true,
+            merge: config.automation?.merge ?? true,
+        },
+        checks: {
+            exclude: config.checks?.exclude ?? [],
+            waitAfterEdit: config.checks?.waitAfterEdit ?? true,
+            waitBeforeReview: config.checks?.waitBeforeReview ?? true,
+            retryFailedJobs: config.checks?.retryFailedJobs ?? 3,
+        },
+        concurrency: {
+            runs: config.concurrency?.runs ?? 3,
+            reviewers: config.concurrency?.reviewers ?? 3,
+        },
+        github: {
+            apiRetryAttempts: config.github.apiRetryAttempts ?? 3,
+            host: config.github.host ?? "github.com",
+            owner: config.github.owner,
+            repo: config.github.repo,
+        },
+        language: config.language,
+        merge: {
+            approvalPolicy: config.merge?.approvalPolicy ?? "majority",
+            method: config.merge?.method ?? "squash",
+            auto: config.merge?.auto ?? true,
+            deleteBranch: config.merge?.deleteBranch ?? true,
+            mergeQueue: config.merge?.mergeQueue ?? false,
+            maxThreadResolutionCycles: config.merge?.maxThreadResolutionCycles ?? 5,
+        },
+        prompts: config.prompts ?? {},
+        safety: {
+            allowAuthors: config.safety?.allowAuthors ?? [],
+            blockedPaths: config.safety?.blockedPaths ?? [],
+            maxChangedFiles: config.safety?.maxChangedFiles,
+            requiredLabels: config.safety?.requiredLabels ?? [],
+        },
+    };
+}