Merge pull request #4243 from vakrahul/feat/opencode-integration

feat: Add Opencode integration as a Coding Agent

.opencode/agents/hive.md

@@ -0,0 +1,20 @@
+---
+name: hive
+description: Hive Agent Builder & Manager
+mode: primary
+tools:
+  agent-builder: true
+  tools: true
+---
+
+# Hive Agent
+You are the Hive Agent Builder. Your goal is to help the user construct, configure, and deploy AI agents using the Hive framework.
+
+## Capabilities
+1. **Scaffold Agents:** Create new agent directories/configs.
+2. **Manage Tools:** Add/remove tools via MCP.
+3. **Debug:** Analyze agent workflows.
+
+## Context
+- You are an expert in the Hive framework architecture.
+- Always use the `agent-builder` MCP server for filesystem operations.

.opencode/mcp.json

@@ -0,0 +1,30 @@
+{
+  "mcpServers": {
+    "agent-builder": {
+      "command": "uv",
+      "args": [
+        "run",
+        "python",
+        "-m",
+        "framework.mcp.agent_builder_server"
+      ],
+      "cwd": "core",
+      "env": {
+        "PYTHONPATH": "../tools/src"
+      }
+    },
+    "tools": {
+      "command": "uv",
+      "args": [
+        "run",
+        "python",
+        "mcp_server.py",
+        "--stdio"
+      ],
+      "cwd": "tools",
+      "env": {
+        "PYTHONPATH": "src"
+      }
+    }
+  }
+}

README.md

@@ -120,6 +120,16 @@ hive tui
 # Or run directly
 hive run exports/your_agent_name --input '{"key": "value"}'
 ```
+##  Coding Agent Support
+### Opencode 
+Hive includes native support for [Opencode](https://github.com/opencode-ai/opencode).
+
+1. **Setup:** Run the quickstart script 
+2. **Launch:** Open Opencode in the project root.
+3. **Activate:** Type `/hive` in the chat to switch to the Hive Agent.
+4. **Verify:** Ask the agent *"List your tools"* to confirm the connection.
+
+The agent has access to all Hive skills and can scaffold agents, add tools, and debug workflows directly from the chat.
 
 **[📖 Complete Setup Guide](docs/environment-setup.md)** - Detailed instructions for agent development
 

docs/developer-guide.md

@@ -116,6 +116,16 @@ Skills are also available in Cursor. To enable:
 3. Restart Cursor to load the MCP servers from `.cursor/mcp.json`
 4. Type `/` in Agent chat and search for skills (e.g., `/hive-create`)
 
+
+### Opencode Support
+To enable Opencode integration:
+
+1. Create/Ensure `.opencode/` directory exists
+2. Configure MCP servers in `.opencode/mcp.json`
+3. Restart Opencode to load the MCP servers
+4. Switch to the Hive agent
+* **Tools:** Accesses `agent-builder` and standard `tools` via standard MCP protocols over stdio.
+
 ### Verify Setup
 
 ```bash

docs/environment-setup.md

@@ -521,7 +521,15 @@ export ADEN_CREDENTIALS_PATH="/custom/path"
 # Agent storage location (default: /tmp)
 export AGENT_STORAGE_PATH="/custom/storage"
 ```
+## Opencode Setup
 
+[Opencode](https://github.com/opencode-ai/opencode) is fully supported as a coding agent.
+
+### Automatic Setup
+Run the quickstart script in the root directorys:
+```bash
+./quickstart.sh
+```
 ## Additional Resources
 
 - **Framework Documentation:** [core/README.md](../core/README.md)

quickstart.sh

@@ -1051,4 +1051,4 @@ if [ -n "$SELECTED_PROVIDER_ID" ] || [ -n "$HIVE_CREDENTIAL_KEY" ]; then
 fi
 
 echo -e "${DIM}Run ./quickstart.sh again to reconfigure.${NC}"
-echo ""
+echo ""