moai-adk 0.25.4__py3-none-any.whl → 0.41.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-tool-opencode/modules/core/config.md

@@ -0,0 +1,211 @@
+---
+source: https://opencode.ai/docs/config/
+fetched: 2026-01-08
+title: Configuration
+---
+
+# OpenCode Configuration Guide
+
+## Overview
+
+OpenCode uses JSON/JSONC config files to customize the tool's behavior across TUI, CLI, IDE, and other interfaces.
+
+## Configuration Locations (Merge Order)
+
+Configuration files are merged together, not replaced. Settings from the following config locations are combined:
+
+1. **Global**: `~/.config/opencode/opencode.json`
+2. **Per-project**: `opencode.json` in project root (merged with global)
+3. **Custom path**: Via `OPENCODE_CONFIG` environment variable
+4. **Custom directory**: Via `OPENCODE_CONFIG_DIR` environment variable
+
+## Core Configuration Options
+
+### Models & Providers
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "model": "anthropic/claude-sonnet-4-5",
+  "small_model": "anthropic/claude-haiku-3-5",
+  "provider": {
+    "anthropic": {
+      "timeout": 30000,
+      "setCacheKey": true,
+      "region": "us-east-1",
+      "profile": "default",
+      "endpoint": "https://api.anthropic.com"
+    }
+  }
+}
+```
+
+- `model`: Primary model (e.g., "anthropic/claude-sonnet-4-5")
+- `small_model`: Lightweight tasks like title generation
+- `provider`: Provider-specific settings (timeout, setCacheKey, region, profile, endpoint)
+
+### Interface Settings
+
+```json
+{
+  "theme": "dark",
+  "tui": {
+    "scroll_speed": 3,
+    "scroll_acceleration": 1.5,
+    "diff_style": "unified"
+  },
+  "server": {
+    "port": 3000,
+    "hostname": "localhost",
+    "mdns": true,
+    "cors": true
+  }
+}
+```
+
+- `theme`: Visual appearance configuration
+- `tui`: Terminal UI options (scroll_speed, scroll_acceleration, diff_style)
+- `server`: Server settings (port, hostname, mdns, cors)
+
+### Functionality
+
+```json
+{
+  "tools": {
+    "write": true,
+    "bash": true
+  },
+  "agent": {
+    "code-review": {
+      "description": "Code review specialist",
+      "model": "anthropic/claude-sonnet-4",
+      "prompt": "You are a code review expert..."
+    }
+  },
+  "default_agent": "code-review",
+  "command": {
+    "test": {
+      "description": "Run tests",
+      "command": "npm test"
+    }
+  },
+  "keybinds": {
+    "submit": "ctrl+enter"
+  },
+  "formatter": {
+    "typescript": "prettier"
+  },
+  "permission": {
+    "write": "ask",
+    "bash": "allow"
+  }
+}
+```
+
+- `tools`: Enable/disable tools like write, bash
+- `agent`: Define specialized agents for specific tasks
+- `default_agent`: Agent used when none specified
+- `command`: Custom commands for repetitive workflows
+- `keybinds`: Keyboard shortcuts customization
+- `formatter`: Code formatter configuration
+- `permission`: Tool approval requirements ("ask", "allow", etc.)
+
+### Features & Behavior
+
+```json
+{
+  "share": "manual",
+  "autoupdate": true,
+  "compaction": "auto",
+  "watcher": {
+    "ignore": ["node_modules", ".git"]
+  },
+  "mcp": {
+    "servers": {}
+  },
+  "plugin": [],
+  "instructions": ["AGENTS.md", ".opencode/*.md"],
+  "disabled_providers": [],
+  "enabled_providers": [],
+  "experimental": {}
+}
+```
+
+- `share`: Sharing mode ("manual", "auto", "disabled")
+- `autoupdate`: Auto-update behavior (true/false/"notify")
+- `compaction`: Context management (auto, prune)
+- `watcher`: File watching ignore patterns
+- `mcp`: Model Context Protocol server configuration
+- `plugin`: Load custom plugins from npm or local files
+- `instructions`: Array of instruction files/glob patterns
+- `disabled_providers`: Blocklist of providers
+- `enabled_providers`: Allowlist of providers
+- `experimental`: Unstable features under development
+
+## Variable Substitution
+
+### Environment Variables
+
+Use `{env:VARIABLE_NAME}` syntax:
+
+```json
+{
+  "model": "{env:OPENCODE_MODEL}"
+}
+```
+
+### File Contents
+
+Use `{file:path/to/file}` syntax:
+
+```json
+{
+  "apiKey": "{file:~/.secrets/openai-key}"
+}
+```
+
+File paths support relative (to config) and absolute paths (`/` or `~`).
+
+## Provider-Specific Options
+
+### Amazon Bedrock
+
+Amazon Bedrock supports the following options:
+
+- `region`: AWS region (defaults to AWS_REGION env or us-east-1)
+- `profile`: AWS named profile
+- `endpoint`: Custom VPC endpoint URL
+
+**Note:** Bearer tokens take precedence over profile-based authentication.
+
+```json
+{
+  "provider": {
+    "amazon-bedrock": {
+      "region": "us-west-2",
+      "profile": "production",
+      "endpoint": "https://bedrock.us-west-2.amazonaws.com"
+    }
+  }
+}
+```
+
+## Agent Configuration
+
+Agents can be defined inline in the config or via markdown files:
+
+- Global: `~/.config/opencode/agent/`
+- Project: `.opencode/agent/`
+
+Configuration includes:
+- `description`: What the agent does
+- `model`: Which model to use
+- `prompt`: System prompt for the agent
+- Tool restrictions
+
+## Important Notes
+
+- The schema is defined at `opencode.ai/config.json`
+- Experimental options are not stable. They may change or be removed without notice.
+- `disabled_providers` takes priority over `enabled_providers`
+- Sharing defaults to manual mode requiring explicit `/share` command

moai_adk/templates/.claude/skills/moai-tool-opencode/modules/core/enterprise.md

@@ -0,0 +1,68 @@
+---
+source: https://opencode.ai/docs/enterprise/
+fetched: 2026-01-08
+title: Enterprise
+---
+
+# OpenCode Enterprise
+
+## Overview
+
+OpenCode Enterprise enables organizations to keep code and data within their own infrastructure through centralized configuration, SSO integration, and internal AI gateway support.
+
+## Trial & Data Security
+
+**Key Statement:** "OpenCode does not store any of your code or context data."
+
+All processing occurs locally or via direct API calls to the provider. The only exception is the optional `/share` feature, which sends conversations to opencode.ai's CDN.
+
+### Recommended Trial Configuration
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "disabled"
+}
+```
+
+### Code Ownership
+
+Users retain all rights to code produced by OpenCode with no licensing restrictions.
+
+## Enterprise Features
+
+### Central Config
+
+Single organizational configuration managing SSO and AI gateway access.
+
+### SSO Integration
+
+Authentication through existing identity management systems to obtain gateway credentials.
+
+### Internal AI Gateway
+
+Route all requests exclusively through approved organizational infrastructure.
+
+### Self-Hosting
+
+Currently on roadmap; option to host share pages on internal infrastructure.
+
+## Pricing Model
+
+- Per-seat licensing
+- No token charges if organizations maintain their own LLM gateway
+- Custom quotes available upon contact
+
+## Private NPM Registry Support
+
+Organizations using private registries (JFrog Artifactory, Nexus, etc.) must authenticate developers before running OpenCode:
+
+```bash
+npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/
+```
+
+**Important Requirement:** "You must be logged into the private registry before running OpenCode."
+
+## Contact
+
+Organizations interested in implementation should email contact@anoma.ly for pricing and deployment discussions.

moai_adk/templates/.claude/skills/moai-tool-opencode/modules/core/intro.md

@@ -0,0 +1,127 @@
+---
+source: https://opencode.ai/docs/
+fetched: 2026-01-08
+title: Introduction to OpenCode
+---
+
+# Introduction to OpenCode
+
+## Overview
+
+OpenCode is an open source AI coding agent available in multiple formats: terminal interface, desktop application, and IDE extension.
+
+## Installation Methods
+
+### Quick Install
+
+```bash
+curl -fsSL https://opencode.ai/install | bash
+```
+
+### Package Managers
+
+**Node.js (npm, Bun, pnpm, Yarn)**
+
+```bash
+npm install -g opencode
+# or
+bun install -g opencode
+# or
+pnpm install -g opencode
+# or
+yarn global add opencode
+```
+
+**Homebrew (macOS/Linux)**
+
+```bash
+brew install opencode
+```
+
+**Paru (Arch Linux)**
+
+```bash
+paru -S opencode
+```
+
+**Chocolatey (Windows)**
+
+```bash
+choco install opencode
+```
+
+**Scoop (Windows)**
+
+```bash
+scoop install opencode
+```
+
+**Mise**
+
+```bash
+mise use -g opencode
+```
+
+**Docker**
+
+Docker support is available for containerized environments.
+
+## Core Setup Steps
+
+### 1. Prerequisites
+
+- Modern terminal emulator (WezTerm, Alacritty, Ghostty, Kitty)
+- LLM API keys
+
+### 2. Configuration
+
+Users connect via `/connect` command, authenticate at opencode.ai/auth, and input API credentials.
+
+### 3. Project Initialization
+
+Navigate to project directory and run `opencode`, then execute `/init` to analyze the codebase and generate `AGENTS.md`.
+
+## Primary Use Cases
+
+The documentation highlights four main workflows:
+
+### Question Asking
+
+Query codebase understanding using `@` syntax for file references.
+
+```
+@src/main.ts What does this file do?
+```
+
+### Feature Planning
+
+Toggle Plan mode (Tab key) to review implementation approaches before building.
+
+### Direct Changes
+
+Request specific modifications with detailed context.
+
+### Version Control
+
+Undo/redo changes via `/undo` and `/redo` commands.
+
+## Additional Features
+
+### Sharing
+
+`/share` command creates shareable conversation links.
+
+### Customization
+
+- Theme selection
+- Keybind configuration
+- Code formatter setup
+- Custom commands
+
+### Documentation
+
+References to config, providers, and troubleshooting resources.
+
+## Best Practices
+
+The page emphasizes providing detailed context and treating the AI agent like a junior developer for optimal results.

moai_adk/templates/.claude/skills/moai-tool-opencode/modules/core/migration-1.0.md

@@ -0,0 +1,82 @@
+---
+source: https://opencode.ai/docs/1-0/
+fetched: 2026-01-08
+title: Migrating to 1.0
+---
+
+# OpenCode 1.0 Migration Guide
+
+## Key Overview
+
+OpenCode 1.0 represents "a complete rewrite of the TUI," transitioning from a Go/Bubbletea framework to an in-house solution built with Zig and SolidJS. The new version maintains compatibility with the existing OpenCode server while improving performance and capabilities.
+
+## Upgrade Instructions
+
+### Manual Upgrade
+
+```bash
+opencode upgrade 1.0.0
+```
+
+### Revert to Previous Version
+
+```bash
+opencode upgrade 0.15.31
+```
+
+**Note:** Some older versions automatically fetch the latest release.
+
+## Notable UX Improvements
+
+### Command Bar
+
+The interface now includes "a command bar which almost everything flows through," accessible via `Ctrl+P`.
+
+### Session History
+
+Session history display has been simplified to focus on edit and bash tool details.
+
+### Session Sidebar
+
+A toggleable session sidebar provides additional context.
+
+## Breaking Changes
+
+### Renamed Keybinds
+
+Four keybinds were renamed:
+
+| Old Name | New Name |
+|----------|----------|
+| `messages_revert` | `messages_undo` |
+| `switch_agent` | `agent_cycle` |
+| `switch_agent_reverse` | `agent_cycle_reverse` |
+| `switch_mode` | `agent_cycle` |
+
+### Removed Keybinds
+
+Twelve keybinds were removed entirely, including functionality for:
+
+- Layout toggling
+- File operations
+- Help display
+- Thinking block management
+
+## Feedback
+
+The documentation encourages users to report missing features via GitHub issues.
+
+## Technical Details
+
+### Framework Changes
+
+- **Previous:** Go/Bubbletea
+- **Current:** Zig and SolidJS (in-house solution)
+
+### Compatibility
+
+The new version maintains compatibility with the existing OpenCode server.
+
+### Performance
+
+The rewrite focuses on improving performance and capabilities.

moai_adk/templates/.claude/skills/moai-tool-opencode/modules/core/network.md

@@ -0,0 +1,72 @@
+---
+source: https://opencode.ai/docs/network/
+fetched: 2026-01-08
+title: Network Configuration
+---
+
+# Network Configuration Guide
+
+OpenCode provides enterprise-grade networking support through proxy and certificate management.
+
+## Proxy Setup
+
+OpenCode recognizes standard proxy environment variables for routing traffic through corporate proxies:
+
+```bash
+export HTTPS_PROXY=https://proxy.example.com:8080
+export HTTP_PROXY=http://proxy.example.com:8080
+export NO_PROXY=localhost,127.0.0.1
+```
+
+**Critical requirement:** The `NO_PROXY` variable must exclude localhost addresses. The TUI relies on local HTTP server communication, and proxying this traffic creates routing loops.
+
+## Authentication
+
+For credential-protected proxies, embed credentials directly in the proxy URL:
+
+```bash
+export HTTPS_PROXY=http://username:password@proxy.example.com:8080
+```
+
+### Security Best Practices
+
+The documentation advises against hardcoding passwords, recommending:
+- Environment variables
+- Secure credential management systems
+
+### Advanced Authentication
+
+For advanced authentication schemes like NTLM or Kerberos, using an LLM Gateway with native support is suggested.
+
+## Custom Certificates
+
+Enterprise environments using custom certificate authorities can configure OpenCode to trust them:
+
+```bash
+export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
+```
+
+This setting applies to both proxy connections and direct API communications.
+
+## Server Configuration
+
+OpenCode supports configurable server ports and hostnames via CLI flags:
+
+```bash
+opencode --port 3000 --hostname localhost
+```
+
+## Complete Example
+
+```bash
+# Proxy configuration
+export HTTPS_PROXY=https://proxy.corporate.com:8080
+export HTTP_PROXY=http://proxy.corporate.com:8080
+export NO_PROXY=localhost,127.0.0.1,.internal.corp
+
+# Custom CA certificate
+export NODE_EXTRA_CA_CERTS=/etc/ssl/certs/corporate-ca.pem
+
+# Start OpenCode
+opencode
+```