opencode-agent-modes 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 j4rviscmd
+
+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,153 @@
+# opencode-agent-modes
+
+[![npm license](https://img.shields.io/npm/l/opencode-agent-modes?logo=npm&logoColor=fff)](https://www.npmjs.com/package/opencode-agent-modes)
+[![npm downloads](https://img.shields.io/npm/dt/opencode-agent-modes?logo=npm&logoColor=fff)](https://www.npmjs.com/package/opencode-agent-modes)
+[![npm version](https://img.shields.io/npm/v/opencode-agent-modes?logo=npm&logoColor=fff)](https://www.npmjs.com/package/opencode-agent-modes)
+![OpenCode Plugin](https://img.shields.io/badge/OpenCode-Plugin-4c8bf5)
+![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=fff)
+
+OpenCode plugin to switch agent models between performance and economy modes.
+
+> [!NOTE]
+> **Primary Use Case**: When approaching your token limit, switch to
+> pre-defined economy models to extend your session until your quota resets.
+> Changes take effect after restarting opencode.
+
+<p align="center">
+  <img src="assets/image/sample.png" width="700" alt="Change mode example" />
+</p>
+
+## Features
+
+- Switch between different model presets (performance, economy, or custom)
+- Configurable presets with user-defined models
+- Toast notifications for mode changes
+
+### Supported Agents
+
+| Agent Type            | Description                                                                                     |
+| --------------------- | ----------------------------------------------------------------------------------------------- |
+| opencode agents       | Standard agents (`build`, `plan`, etc.)                                                         |
+| oh-my-opencode agents | Optional - applies if [oh-my-opencode](https://github.com/pekepeke/oh-my-opencode) is installed |
+
+## Installation
+
+Add the plugin to your `opencode.json`:
+
+```json
+{
+  "plugin": ["opencode-agent-modes@latest"]
+}
+```
+
+The following command files are automatically copied to
+`~/.config/opencode/command/` on installation:
+
+- `mode-performance.md`
+- `mode-economy.md`
+- `mode-status.md`
+- `mode-list.md`
+
+## Usage
+
+### Available Commands
+
+- `/mode-performance` - Switch to high-performance models
+- `/mode-economy` - Switch to cost-efficient free models
+- `/mode-status` - Show current mode and configuration
+- `/mode-list` - List all available mode presets
+
+### Available Tools
+
+- `mode_switch` - Switch to a specified mode preset
+- `mode_status` - Display current mode settings
+- `mode_list` - List all available presets
+
+## Configuration
+
+The plugin configuration is stored at `~/.config/opencode/agent-mode-switcher.json`.
+
+On first run, the plugin automatically generates this file by:
+
+1. Reading current models from `opencode.json` for the "performance" preset
+2. Setting `opencode/glm-4.7-free` for the "economy" preset
+
+### Example Configuration
+
+> [!TIP]
+> The `oh-my-opencode` section is optional. Omit it if you don't use oh-my-opencode.
+
+```json
+{
+  "currentMode": "performance",
+  "showToastOnStartup": true,
+  "presets": {
+    "performance": {
+      "description": "High-performance models for complex tasks",
+      "opencode": {
+        "build": { "model": "github-copilot/gpt-5.2" },
+        "plan": { "model": "github-copilot/gpt-5.2" }
+      },
+      "oh-my-opencode": {
+        "Sisyphus": { "model": "anthropic/claude-opus-4-5-20251101" }
+      }
+    },
+    "economy": {
+      "description": "Cost-efficient free model for routine tasks",
+      "opencode": {
+        "build": { "model": "opencode/glm-4.7-free" }
+      },
+      "oh-my-opencode": {
+        "Sisyphus": { "model": "opencode/glm-4.7-free" }
+      }
+    }
+  }
+}
+```
+
+### Model Priority
+
+When both global `model` and agent-specific `opencode` settings are configured,
+the priority is:
+
+```text
+agent.<name>.model > model (global)
+```
+
+Agent-specific settings override the global model setting.
+
+## Custom Presets
+
+To add a custom preset (e.g., "premium"):
+
+1. Add the preset to `~/.config/opencode/agent-mode-switcher.json`:
+
+   ```json
+   {
+     "presets": {
+       "premium": {
+         "description": "High-end models for critical tasks",
+         "opencode": {
+           "build": { "model": "anthropic/claude-opus-4-5-20251101" }
+         }
+       }
+     }
+   }
+   ```
+
+2. Create a command file at `~/.config/opencode/command/mode-premium.md`:
+
+   ```md
+   ---
+   description: "Switch to premium mode (high-end models)"
+   ---
+
+   Use mode_switch tool to switch agent mode to "premium".
+   ```
+
+3. Restart opencode to apply changes.
+
+## Notes
+
+- Changes require an opencode restart to take effect
+- Custom mode presets can be added by editing the configuration file

package/commands/mode-economy.md

@@ -0,0 +1,5 @@
+---
+description: "Switch to economy mode (cost-efficient models)"
+---
+
+Use mode_switch tool to switch agent mode to "economy".

package/commands/mode-list.md

@@ -0,0 +1,5 @@
+---
+description: "List all available agent modes"
+---
+
+Use mode_list tool to show all defined mode presets.

package/commands/mode-performance.md

@@ -0,0 +1,5 @@
+---
+description: "Switch to performance mode (high-performance models)"
+---
+
+Use mode_switch tool to switch agent mode to "performance".

package/commands/mode-status.md

@@ -0,0 +1,5 @@
+---
+description: "Show current agent mode and configuration"
+---
+
+Use mode_status tool to display current mode settings.

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.ts';
+export * from './loader.ts';
+export * from './initializer.ts';

package/dist/config/initializer.d.ts

@@ -0,0 +1,10 @@
+import type { ModeSwitcherConfig } from './types.ts';
+/**
+ * Initialize the plugin configuration if it doesn't exist
+ * @returns The configuration (existing or newly created)
+ */
+export declare function initializeConfig(): Promise<ModeSwitcherConfig>;
+/**
+ * Ensure configuration is valid and has required presets
+ */
+export declare function validateConfig(config: ModeSwitcherConfig): boolean;

package/dist/config/loader.d.ts

@@ -0,0 +1,83 @@
+import type { ModeSwitcherConfig, OpencodeConfig, OhMyOpencodeConfig } from './types.ts';
+/**
+ * Expands tilde (~) notation to the user's home directory path.
+ *
+ * @param path - File path that may contain ~ prefix
+ * @returns Expanded absolute path with ~ replaced by home directory
+ * @example
+ * ```typescript
+ * expandPath('~/config/settings.json')
+ * // Returns: '/Users/username/config/settings.json'
+ * ```
+ */
+export declare function expandPath(path: string): string;
+/**
+ * Get the absolute path to the plugin configuration file.
+ *
+ * @returns Absolute path to agent-mode-switcher.json
+ */
+export declare function getPluginConfigPath(): string;
+/**
+ * Get the absolute path to the opencode configuration file.
+ *
+ * @returns Absolute path to opencode.json
+ */
+export declare function getOpencodeConfigPath(): string;
+/**
+ * Get the absolute path to the oh-my-opencode configuration file.
+ *
+ * @returns Absolute path to oh-my-opencode.json
+ */
+export declare function getOhMyOpencodeConfigPath(): string;
+/**
+ * Load the agent-mode-switcher plugin configuration.
+ *
+ * @returns Plugin configuration object, or null if file doesn't exist
+ */
+export declare function loadPluginConfig(): Promise<ModeSwitcherConfig | null>;
+/**
+ * Save the agent-mode-switcher plugin configuration.
+ *
+ * @param config - Plugin configuration object to save
+ */
+export declare function savePluginConfig(config: ModeSwitcherConfig): Promise<void>;
+/**
+ * Load the opencode configuration file.
+ *
+ * @returns Opencode configuration object, or null if file doesn't exist
+ */
+export declare function loadOpencodeConfig(): Promise<OpencodeConfig | null>;
+/**
+ * Save the opencode configuration file.
+ *
+ * @param config - Opencode configuration object to save
+ */
+export declare function saveOpencodeConfig(config: OpencodeConfig): Promise<void>;
+/**
+ * Load the oh-my-opencode configuration file.
+ *
+ * @returns Oh-my-opencode configuration object, or null if file doesn't exist
+ */
+export declare function loadOhMyOpencodeConfig(): Promise<OhMyOpencodeConfig | null>;
+/**
+ * Save the oh-my-opencode configuration file.
+ *
+ * @param config - Oh-my-opencode configuration object to save
+ */
+export declare function saveOhMyOpencodeConfig(config: OhMyOpencodeConfig): Promise<void>;
+/**
+ * Check if the plugin configuration file exists.
+ *
+ * @returns True if agent-mode-switcher.json exists, false otherwise
+ */
+export declare function pluginConfigExists(): Promise<boolean>;
+/**
+ * Clear the content cache for a specific file.
+ * Exported for testing purposes.
+ */
+export declare function clearContentCache(filePath?: string): void;
+/**
+ * Set cached content for a file.
+ * Exported for testing purposes.
+ */
+export declare function setContentCache(filePath: string, content: string): void;

package/dist/config/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Agent preset configuration for a single agent
+ */
+export interface AgentPreset {
+    model: string;
+}
+/**
+ * Mode preset containing configurations for both opencode and oh-my-opencode agents
+ */
+export interface ModePreset {
+    description: string;
+    model?: string;
+    opencode: Record<string, AgentPreset>;
+    'oh-my-opencode': Record<string, AgentPreset>;
+}
+/**
+ * Main configuration for the mode switcher plugin
+ */
+export interface ModeSwitcherConfig {
+    currentMode: string;
+    showToastOnStartup: boolean;
+    presets: Record<string, ModePreset>;
+}
+/**
+ * OpenCode agent configuration structure in opencode.json
+ */
+export interface OpencodeAgentConfig {
+    model?: string;
+    mode?: string;
+    [key: string]: unknown;
+}
+/**
+ * OpenCode configuration file structure
+ */
+export interface OpencodeConfig {
+    model?: string;
+    agent?: Record<string, OpencodeAgentConfig>;
+    [key: string]: unknown;
+}
+/**
+ * Oh-my-opencode configuration file structure
+ */
+export interface OhMyOpencodeConfig {
+    agents?: Record<string, AgentPreset>;
+    [key: string]: unknown;
+}
+/**
+ * Default economy model for cost-efficient operations
+ */
+export declare const DEFAULT_ECONOMY_MODEL = "opencode/glm-4.7-free";
+/**
+ * Configuration file paths
+ */
+export declare const CONFIG_PATHS: {
+    readonly pluginConfig: "~/.config/opencode/agent-mode-switcher.json";
+    readonly opencodeConfig: "~/.config/opencode/opencode.json";
+    readonly ohMyOpencodeConfig: "~/.config/opencode/oh-my-opencode.json";
+};

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import type { Plugin } from "@opencode-ai/plugin";
+/**
+ * OpenCode Agent Mode Switcher Plugin
+ *
+ * Allows switching between different agent mode presets (e.g., performance vs economy)
+ * that configure which AI models are used for each agent type.
+ */
+declare const modeSwitcherPlugin: Plugin;
+export default modeSwitcherPlugin;