From 8cfb533fefb5d7f3752e7a01d4a4d878fbe086e4 Mon Sep 17 00:00:00 2001 From: vakrahul Date: Tue, 10 Feb 2026 09:10:47 +0530 Subject: [PATCH] Fix docs: remove recommended tag, fix rendering, remove duplicate setup --- README.md | 2 +- docs/developer-guide.md | 12 +- docs/environment-setup.md | 6 +- setup_opencode.py | 82 --------- tools/requirements.txt | 368 -------------------------------------- 5 files changed, 8 insertions(+), 462 deletions(-) delete mode 100644 setup_opencode.py delete mode 100644 tools/requirements.txt diff --git a/README.md b/README.md index 0f875b62..6a4463fc 100644 --- a/README.md +++ b/README.md @@ -122,7 +122,7 @@ hive run exports/your_agent_name --input '{"key": "value"}' ``` ## Coding Agent Support -### Opencode (Recommended) +### Opencode Hive includes native support for [Opencode](https://github.com/opencode-ai/opencode). 1. **Setup:** Run the quickstart script or `python setup_opencode.py`. diff --git a/docs/developer-guide.md b/docs/developer-guide.md index 0307ff20..f54afdfb 100644 --- a/docs/developer-guide.md +++ b/docs/developer-guide.md @@ -117,13 +117,13 @@ Skills are also available in Cursor. To enable: 4. Type `/` in Agent chat and search for skills (e.g., `/hive-create`) ```markdown -### Opencode Integration +### Opencode Support +To enable Opencode integration: -The Opencode integration leverages the same MCP servers used by Cursor and Claude Code. - -* **Configuration:** Located in `.opencode/mcp.json`. -* **Agent Definition:** The Hive agent is defined in `.opencode/agents/hive.md`. -* **Skills:** The integration reuses existing skills from `.claude/skills/`. The Hive agent is configured to access these patterns directly, ensuring consistency across all coding agents. +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 diff --git a/docs/environment-setup.md b/docs/environment-setup.md index bc3071de..32191135 100644 --- a/docs/environment-setup.md +++ b/docs/environment-setup.md @@ -538,13 +538,9 @@ python setup_opencode.py - **Example Agents:** [exports/](../exports/) - **Agent Building Guide:** [.claude/skills/hive-create/SKILL.md](../.claude/skills/hive-create/SKILL.md) - **Testing Guide:** [.claude/skills/hive-test/SKILL.md](../.claude/skills/hive-test/SKILL.md) -## Opencode Setup -[Opencode](https://github.com/opencode-ai/opencode) is fully supported as a coding agent. -### Automatic Setup -Run the setup script in the root directory: -```bash + ## Contributing diff --git a/setup_opencode.py b/setup_opencode.py deleted file mode 100644 index 8748dae6..00000000 --- a/setup_opencode.py +++ /dev/null @@ -1,82 +0,0 @@ -import os -import sys -import json - -def setup_opencode(): - print("✨ Setting up Opencode integration...") - - # 1. Define paths - base_dir = os.getcwd() - opencode_dir = os.path.join(base_dir, ".opencode") - agents_dir = os.path.join(opencode_dir, "agents") - - # Create directories - if not os.path.exists(agents_dir): - os.makedirs(agents_dir) - print(f" Created directory: {agents_dir}") - - # 2. Determine Path Separator (Windows uses ';' others use ':') - # We force ';' if on Windows to be safe - path_sep = ";" if os.name == 'nt' else ":" - print(f" Detected OS: {os.name} (using separator '{path_sep}')") - - # 3. Create mcp.json - mcp_config = { - "mcpServers": { - "agent-builder": { - "command": "python", - "args": ["-m", "framework.mcp.agent_builder_server"], - "cwd": "core", - "env": { - "PYTHONPATH": f"../tools/src{path_sep}." - } - }, - "tools": { - "command": "python", - "args": ["mcp_server.py", "--stdio"], - "cwd": "tools", - "env": { - "PYTHONPATH": f"src{path_sep}../core" - } - } - } - } - - mcp_path = os.path.join(opencode_dir, "mcp.json") - with open(mcp_path, "w") as f: - json.dump(mcp_config, f, indent=2) - print(f"āœ… Created {mcp_path}") - - # 4. Create Hive Agent - agent_content = """--- -name: hive -description: Hive Agent Builder & Manager -mode: primary -model: anthropic/claude-3-5-sonnet-20241022 -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 & Skills -- You have access to all skills in `.claude/skills/`. -- Always use the `agent-builder` MCP server for filesystem operations. -""" - - agent_path = os.path.join(agents_dir, "hive.md") - with open(agent_path, "w", encoding="utf-8") as f: - f.write(agent_content) - - print(f"āœ… Created {agent_path}") - print("\nšŸŽ‰ Setup Complete! Restart Opencode and type '/hive' to begin.") - -if __name__ == "__main__": - setup_opencode() \ No newline at end of file diff --git a/tools/requirements.txt b/tools/requirements.txt deleted file mode 100644 index 8dfd136f..00000000 --- a/tools/requirements.txt +++ /dev/null @@ -1,368 +0,0 @@ -absl-py==2.3.1 -aiofiles==25.1.0 -aiohappyeyeballs==2.6.1 -aiohttp==3.13.3 -aiohttp-retry==2.8.3 -aiosignal==1.4.0 -altair==6.0.0 -annotated-doc==0.0.4 -annotated-types==0.7.0 -ansicon==1.89.0 -anthropic==0.76.0 -anyio==4.12.1 -asgiref==3.8.1 -astunparse==1.6.3 -attrs==25.4.0 -Authlib==1.6.6 -av==16.1.0 -backoff==2.2.1 -bcrypt==4.3.0 -beartype==0.22.9 -beautifulsoup4==4.14.3 -blessed==1.25.0 -blinker==1.9.0 -build==1.3.0 -CacheControl==0.14.3 -cachetools==5.5.2 -certifi==2026.1.4 -cffi==2.0.0 -charset-normalizer==3.4.4 -chromadb==1.3.6 -click==8.3.1 -cloudpickle==3.1.2 -colorama==0.4.6 -coloredlogs==15.0.1 -comtypes==1.4.10 -contourpy==1.3.2 -cosdata-fastembed==0.7.1 -cosdata-sdk==0.2.5 -croniter==6.0.0 -cryptography==46.0.1 -cycler==0.12.1 -cyclopts==4.5.1 -dataclasses-json==0.6.7 -datasets==4.4.1 -deprecation==2.1.0 -diff-match-patch==20241021 -dill==0.4.0 -diskcache==5.6.3 -distlib==0.3.9 -distro==1.9.0 -Django==5.2.1 -djangorestframework==3.16.0 -dlib @ file:///C:/Users/RAHUL/Downloads/dlib-19.24.99-cp312-cp312-win_amd64.whl#sha256=20c62e606ca4c9961305f7be3d03990380d3e6c17f8d27798996e97a73271862 -dnspython==2.8.0 -docstring_parser==0.17.0 -docutils==0.22.4 -dotenv==0.9.9 -durationpy==0.10 -easyocr==1.7.2 -editor==1.6.6 -email-validator==2.3.0 -eval_type_backport==0.3.1 -exceptiongroup==1.3.1 -execnet==2.1.2 -face-recognition==1.3.0 -face_recognition_models==0.3.0 -fakeredis==2.33.0 -fastapi==0.121.3 -fastmcp==2.14.5 -fastuuid==0.14.0 -filelock==3.16.1 -filetype==1.2.0 -firebase_admin==7.1.0 -Flask==3.1.2 -Flask-Bcrypt==1.0.1 -flask-cors==6.0.2 -Flask-Login==0.6.3 -Flask-SQLAlchemy==3.1.1 -flatbuffers==25.12.19 -fonttools==4.59.0 -frozenlist==1.8.0 -fsspec==2025.9.0 -gast==0.6.0 -gitdb==4.0.12 -GitPython==3.1.45 -google-ai-generativelanguage==0.6.15 -google-api-core==2.25.1 -google-api-python-client==2.187.0 -google-auth==2.48.0 -google-auth-httplib2==0.2.1 -google-cloud-core==2.4.3 -google-cloud-firestore==2.21.0 -google-cloud-storage==3.4.0 -google-crc32c==1.7.1 -google-genai==1.60.0 -google-generativeai==0.8.5 -google-pasta==0.2.0 -google-resumable-media==2.7.2 -googleapis-common-protos==1.72.0 -greenlet==3.1.1 -grpcio==1.76.0 -grpcio-status==1.71.2 -h11==0.16.0 -h2==4.3.0 -h5py==3.14.0 -hpack==4.1.0 -httpcore==1.0.9 -httplib2==0.31.0 -httptools==0.7.1 -httpx==0.28.1 -httpx-sse==0.4.3 -huggingface-hub==0.36.0 -humanfriendly==10.0 -hyperframe==6.1.0 -idna==3.11 -imageio==2.37.0 -importlib_metadata==8.7.1 -importlib_resources==6.5.2 -iniconfig==2.3.0 -inquirer==3.4.1 -itsdangerous==2.2.0 -jaraco.classes==3.4.0 -jaraco.context==6.1.0 -jaraco.functools==4.4.0 -Jinja2==3.1.4 -jinxed==1.3.0 -jiter==0.12.0 -joblib==1.5.1 -jsonpatch==1.33 -jsonpath-ng==1.7.0 -jsonpointer==3.0.0 -jsonref==1.1.0 -jsonschema==4.25.1 -jsonschema-path==0.3.4 -jsonschema-specifications==2025.9.1 -keras==3.10.0 -keyring==25.7.0 -kiwisolver==1.4.8 -kubernetes==34.1.0 -langchain==1.2.7 -langchain-anthropic==1.3.1 -langchain-classic==1.0.1 -langchain-community==0.4.1 -langchain-core==1.2.7 -langchain-google-genai==4.2.0 -langchain-huggingface==1.2.0 -langchain-openai==1.1.7 -langchain-text-splitters==1.1.0 -langdetect==1.0.9 -langgraph==1.0.7 -langgraph-checkpoint==4.0.0 -langgraph-prebuilt==1.0.7 -langgraph-sdk==0.3.3 -langsmith==0.6.6 -lazy_loader==0.4 -libclang==18.1.1 -livekit==1.0.23 -livekit-agents==1.3.12 -livekit-api==1.1.0 -livekit-blingfire==1.1.0 -livekit-plugins-elevenlabs==1.3.12 -livekit-plugins-openai==1.3.12 -livekit-plugins-silero==1.3.12 -livekit-protocol==1.1.2 -loguru==0.7.3 -lupa==2.6 -lxml==6.0.1 -Markdown==3.8.2 -markdown-it-py==4.0.0 -MarkupSafe==3.0.2 -marshmallow==3.26.2 -matplotlib==3.10.3 -mcp==1.26.0 -mdurl==0.1.2 -Mesa==3.1.2 -ml_dtypes==0.5.1 -mmh3==5.2.0 -more-itertools==10.8.0 -mpmath==1.3.0 -msgpack==1.1.1 -multidict==6.7.0 -multiprocess==0.70.18 -mypy_extensions==1.1.0 -mysqlclient==2.2.7 -namex==0.1.0 -narwhals==2.14.0 -nest-asyncio==1.6.0 -networkx==3.5 -ninja==1.13.0 -numpy==2.4.1 -oauthlib==3.3.1 -onnxruntime==1.23.1 -openai==2.15.0 -openapi-pydantic==0.5.1 -opencv-contrib-python==4.11.0.86 -opencv-python==4.10.0.84 -opencv-python-headless==4.12.0.88 -opentelemetry-api==1.39.1 -opentelemetry-exporter-otlp==1.39.1 -opentelemetry-exporter-otlp-proto-common==1.39.1 -opentelemetry-exporter-otlp-proto-grpc==1.39.1 -opentelemetry-exporter-otlp-proto-http==1.39.1 -opentelemetry-proto==1.39.1 -opentelemetry-sdk==1.39.1 -opentelemetry-semantic-conventions==0.60b1 -opt_einsum==3.4.0 -optree==0.17.0 -orjson==3.11.5 -ormsgpack==1.12.2 -overrides==7.7.0 -packaging==25.0 -pandas==2.2.3 -pathable==0.4.4 -pathspec==0.12.1 -pathvalidate==3.3.1 -patsy==1.0.1 -pdf2image==1.17.0 -pdfminer.six==20251107 -pdfplumber==0.11.8 -pillow==12.1.0 -platformdirs==4.3.6 -playwright==1.58.0 -playwright-stealth==2.0.1 -pluggy==1.6.0 -ply==3.11 -postgrest==2.27.3 -posthog==5.4.0 -prometheus_client==0.24.1 -propcache==0.4.1 -proto-plus==1.26.1 -protobuf==5.29.5 -psutil==7.2.1 -py-key-value-aio==0.3.0 -py-key-value-shared==0.3.0 -py_rust_stemmers==0.1.5 -pyarrow==22.0.0 -pyasn1==0.6.1 -pyasn1_modules==0.4.2 -pybase64==1.4.3 -pyclipper==1.3.0.post6 -pycparser==3.0 -pydantic==2.12.5 -pydantic-settings==2.12.0 -pydantic_core==2.41.5 -pydeck==0.9.1 -pydocket==0.17.5 -pyee==13.0.0 -PyGithub==2.8.1 -Pygments==2.19.2 -pyiceberg==0.10.0 -PyJWT==2.10.1 -PyNaCl==1.6.2 -pyparsing==3.2.3 -pypdf==6.6.2 -pypdfium2==5.1.0 -pyperclip==1.11.0 -PyPika==0.48.9 -pypiwin32==223 -pyproject_hooks==1.2.0 -pyreadline3==3.5.4 -pyroaring==1.0.3 -pytesseract==0.3.13 -pytest==9.0.2 -pytest-asyncio==1.3.0 -python-bidi==0.6.6 -python-dateutil==2.9.0.post0 -python-docx==1.2.0 -python-dotenv==1.2.1 -python-json-logger==4.0.0 -python-magic-bin==0.4.14 -python-multipart==0.0.20 -pytrends==4.9.2 -pyttsx3==2.98 -pytz==2024.2 -pywin32==310 -pywin32-ctypes==0.2.3 -PyYAML==6.0.2 -readchar==4.2.1 -realtime==2.27.3 -redis==7.1.0 -referencing==0.36.2 -regex==2025.11.3 -reportlab==4.4.5 -requests==2.32.5 -requests-oauthlib==2.0.0 -requests-toolbelt==1.0.0 -resend==2.21.0 -rich==14.3.1 -rich-rst==1.3.2 -rpds-py==0.30.0 -rsa==4.9.1 -ruff==0.14.14 -runs==1.2.2 -safetensors==0.7.0 -scikit-image==0.25.2 -scikit-learn==1.7.1 -scipy==1.16.0 -seaborn==0.13.2 -sentence-transformers==5.1.2 -setuptools==80.9.0 -shapely==2.1.1 -shellingham==1.5.4 -six==1.17.0 -smmap==5.0.2 -sniffio==1.3.1 -sortedcontainers==2.4.0 -sounddevice==0.5.5 -soupsieve==2.8.3 -SpeechRecognition==3.14.2 -SQLAlchemy==2.0.38 -sqlparse==0.5.3 -sse-starlette==3.2.0 -starlette==0.50.0 -statsmodels==0.14.5 -storage3==2.27.3 -streamlit==1.52.2 -StrEnum==0.4.15 -strictyaml==1.7.3 -stripe==14.3.0 -supabase==2.27.3 -supabase-auth==2.27.3 -supabase-functions==2.27.3 -sympy==1.14.0 -tenacity==9.1.2 -tensorboard==2.19.0 -tensorboard-data-server==0.7.2 -tensorflow==2.19.0 -termcolor==3.1.0 -tf_keras==2.19.0 -threadpoolctl==3.6.0 -tifffile==2025.9.9 -tiktoken==0.12.0 -tokenizers==0.22.1 -toml==0.10.2 --e git+https://github.com/vakrahul/hive_work.git@ee42ceee00258707624bbb9b1c47341a3ce58cbd#egg=tools&subdirectory=tools -torch==2.8.0 -torchaudio==2.8.0 -torchvision==0.23.0 -tornado==6.5.4 -tqdm==4.67.1 -transformers==4.57.1 -twilio==9.4.3 -typer==0.21.1 -types-protobuf==6.32.1.20251210 -typing-inspect==0.9.0 -typing-inspection==0.4.2 -typing_extensions==4.15.0 -tzdata==2024.2 -uritemplate==4.2.0 -urllib3==2.6.3 -uuid_utils==0.14.0 -uv==0.10.0 -uvicorn==0.38.0 -virtualenv==20.28.0 -watchdog==6.0.0 -watchfiles==1.1.1 -wcwidth==0.2.14 -websocket-client==1.9.0 -websockets==15.0.1 -Werkzeug==3.1.3 -wheel==0.45.1 -win32_setctime==1.2.0 -wrapt==1.17.2 -xmod==1.8.1 -xxhash==3.6.0 -yarl==1.22.0 -zipp==3.23.0 -zstandard==0.25.0