From c9fe9782c13c44ae54b5ca42d05327be129546db Mon Sep 17 00:00:00 2001 From: Andrew Anderson Date: Thu, 24 Sep 2026 13:39:46 -0400 Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20Add=20Hive=20integrations=20docs?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Signed-off-by: Andrew Anderson --- docs/content/hive/integrations.md | 154 ++++++++++++++++++++++++++++++ public/llms.txt | 11 +++ src/app/docs/[...slug]/page.tsx | 78 +++++++++++++++ src/app/docs/page-map.ts | 1 + 4 files changed, 244 insertions(+) create mode 100644 docs/content/hive/integrations.md create mode 100644 public/llms.txt diff --git a/docs/content/hive/integrations.md b/docs/content/hive/integrations.md new file mode 100644 index 0000000..92c85f5 --- /dev/null +++ b/docs/content/hive/integrations.md @@ -0,0 +1,154 @@ +# Supported agents & inference engines + +Hive supports agent CLIs, inference engines, and OpenAI-compatible model gateways by backend ID. These are supported software integrations; inclusion does not imply endorsement or a partnership. + +## Claude Code + +- **Owner:** Anthropic +- **What Hive does:** launches Claude Code as an agentic CLI, applies Hive's prompt, permissions, audit, and queue controls, and records the configured model with the agent. +- **Hive config:** `backend: claude` +- **Official link:** [Claude Code](https://www.anthropic.com/claude-code) + +## GitHub Copilot CLI + +- **Owner:** GitHub +- **What Hive does:** launches Copilot CLI for unattended agent work with Hive-managed repository scope, permissions, and audit trails. +- **Hive config:** `backend: copilot` +- **Official link:** [GitHub Copilot CLI reference](https://docs.github.com/copilot/reference/copilot-cli-reference) + +## Goose + +- **Owner:** Block +- **What Hive does:** launches Goose as an agent CLI and delivers Hive prompts and kicks through the Goose runtime. +- **Hive config:** `backend: goose` +- **Official link:** [Goose](https://block.github.io/goose/) + +## OpenAI Codex CLI + +- **Owner:** OpenAI +- **What Hive does:** launches Codex CLI for agent tasks and passes Hive's selected model and reasoning-effort settings where supported. +- **Hive config:** `backend: codex` +- **Official link:** [OpenAI Codex CLI](https://github.com/openai/codex) + +## Pi + +- **Owner:** Earendil Works +- **What Hive does:** launches the Pi coding-agent CLI as a long-running interactive backend and sends Hive kicks when the CLI is ready. +- **Hive config:** `backend: pi` +- **Official link:** [Pi](https://pi.dev/) + +## IBM Bob + +- **Owner:** IBM +- **What Hive does:** launches the IBM Bob / bobshell CLI with Hive-managed headless authentication, approval, and workspace trust settings. +- **Hive config:** `backend: bob` +- **Official link:** [IBM watsonx Code Assistant](https://www.ibm.com/products/watsonx-code-assistant) + +## Aider + +- **Owner:** Aider open source project +- **What Hive does:** launches Aider as an agent CLI and can apply Hive's per-agent prompts, repository context, and audit controls. +- **Hive config:** `backend: aider` +- **Official link:** [Aider](https://aider.chat/) + +## Gemini CLI + +- **Owner:** Google +- **What Hive does:** launches Gemini CLI for operators whose Google access still supports that CLI and treats it as an agentic backend. +- **Hive config:** `backend: gemini` +- **Official link:** [Gemini CLI](https://github.com/google-gemini/gemini-cli) + +## Google Antigravity CLI + +- **Owner:** Google +- **What Hive does:** launches the Antigravity CLI (`agy`) as Google's current Hive-supported agent CLI, with Hive managing unattended mode and reasoning effort. +- **Hive config:** `backend: agy` +- **Official link:** [Google Antigravity CLI](https://github.com/google-antigravity/antigravity-cli) + +## OpenCode + +- **Owner:** OpenCode project +- **What Hive does:** launches OpenCode as a supported terminal coding-agent backend and routes Hive prompts to it. +- **Hive config:** `backend: opencode` +- **Official link:** [OpenCode docs](https://opencode.ai/docs/) + +## Kilo Code + +- **Owner:** Kilo +- **What Hive does:** launches Kilo Code as a supported agentic CLI backend for Hive-managed work. +- **Hive config:** `backend: kilo` +- **Official link:** [Kilo CLI](https://kilo.ai/cli) + +## Muse Code + +- **Owner:** Meta +- **What Hive does:** launches Muse Code as a supported CLI backend when installed by the operator. +- **Hive config:** `backend: muse` +- **Official link:** [Muse Code docs](https://musecodes.io/docs/) + +## Oh My Pi + +- **Owner:** can1357 +- **What Hive does:** launches Oh My Pi through the `omp` backend and passes Hive's selected model and approval behavior. +- **Hive config:** `backend: omp` +- **Official link:** [Oh My Pi](https://github.com/can1357/oh-my-pi) + +## vLLM + +- **Owner:** vLLM project +- **What Hive does:** routes inference through a vLLM-compatible OpenAI API endpoint while Hive drives agent turns and audit metadata. +- **Hive config:** `backend: vllm` +- **Official link:** [vLLM](https://www.vllm.ai/) + +## llm-d + +- **Owner:** llm-d project +- **What Hive does:** routes inference through an llm-d OpenAI-compatible endpoint for self-hosted model serving. +- **Hive config:** `backend: llm-d` +- **Official link:** [llm-d](https://llm-d.ai/) + +## LiteLLM + +- **Owner:** BerriAI +- **What Hive does:** routes model calls through LiteLLM as an OpenAI-compatible proxy for centrally managed models and keys. +- **Hive config:** `backend: litellm` +- **Official link:** [LiteLLM](https://www.litellm.ai/) + +## IBM watsonx.ai + +- **Owner:** IBM +- **What Hive does:** routes model calls through watsonx.ai's OpenAI-compatible gateway and handles the IBM project and token settings required by Hive configuration. +- **Hive config:** `backend: watsonx` +- **Official link:** [IBM watsonx.ai](https://www.ibm.com/products/watsonx-ai) + +## OpenRouter + +- **Owner:** OpenRouter +- **What Hive does:** uses OpenRouter as a named model gateway for OpenAI-compatible routing when configured by an operator. +- **Hive config:** `backend: openrouter` +- **Official link:** [OpenRouter](https://openrouter.ai/) + +## Anthropic + +- **Owner:** Anthropic +- **What Hive does:** records and routes Anthropic-backed models through the configured CLI or gateway while preserving Hive audit metadata. +- **Hive config:** `backend: anthropic` +- **Official link:** [Anthropic](https://www.anthropic.com/) + +## OpenAI + +- **Owner:** OpenAI +- **What Hive does:** records and routes OpenAI-backed models through the configured CLI or gateway while preserving Hive audit metadata. +- **Hive config:** `backend: openai` +- **Official link:** [OpenAI](https://openai.com/) + +## DeepSeek + +- **Owner:** DeepSeek +- **What Hive does:** routes DeepSeek-backed models through a configured OpenAI-compatible gateway such as LiteLLM. +- **Hive config:** `backend: deepseek` +- **Official link:** [DeepSeek](https://www.deepseek.com/) + +## Infrastructure thanks + +Hive Commons thanks [Akamai (Linode)](https://www.linode.com/) and [Oracle Cloud (OKE)](https://www.oracle.com/cloud/cloud-native/kubernetes-engine/) for Kubernetes infrastructure donated through the CNCF, [Cloudflare](https://www.cloudflare.com/) for DNS, edge and tunnels, [GitHub Copilot](https://github.com/features/copilot) for AI inference donated to CNCF projects through the CNCF, and [Bluehost](https://www.bluehost.com/) for domain hosting. diff --git a/public/llms.txt b/public/llms.txt new file mode 100644 index 0000000..ec3baf6 --- /dev/null +++ b/public/llms.txt @@ -0,0 +1,11 @@ +# Hive Commons Docs + +## Supported agents and inference engines + +Canonical integrations page: https://docs.hivecommons.dev/docs/hive/integrations + +Hive supports Claude Code, GitHub Copilot CLI, Goose, OpenAI Codex CLI, Pi, IBM Bob, Aider, Gemini CLI, Google Antigravity CLI, OpenCode, Kilo Code, Muse Code, Oh My Pi, vLLM, llm-d, LiteLLM, IBM watsonx.ai, OpenRouter, Anthropic, OpenAI and DeepSeek. + +## Infrastructure thanks + +Hive Commons thanks Akamai (Linode), Oracle Cloud (OKE), Cloudflare, GitHub Copilot and Bluehost. diff --git a/src/app/docs/[...slug]/page.tsx b/src/app/docs/[...slug]/page.tsx index 56c3c9e..97c05a8 100644 --- a/src/app/docs/[...slug]/page.tsx +++ b/src/app/docs/[...slug]/page.tsx @@ -11,10 +11,55 @@ import { MeetingsPage } from '@/components/community/MeetingsPage' import fs from 'fs' import path from 'path' import { notFound } from 'next/navigation' +import type { Metadata } from 'next' const HIVE_DOCS_PATH = process.env.HIVE_DOCS_PATH const STATIC_PROJECTS: ProjectId[] = ['hive', 'hotshot', 'pluk', 'rationguard', 'promptargs', 'dibs', 'spektacular'] +const INTEGRATIONS_DESCRIPTION = + 'Supported Hive integrations: Claude Code, GitHub Copilot CLI, Codex, Gemini, vLLM, LiteLLM, llm-d, watsonx.ai and more.' + +const INTEGRATION_NAMES = [ + 'Claude Code', + 'GitHub Copilot CLI', + 'Goose', + 'OpenAI Codex CLI', + 'Pi', + 'IBM Bob', + 'Aider', + 'Gemini CLI', + 'Google Antigravity CLI', + 'OpenCode', + 'Kilo Code', + 'Muse Code', + 'Oh My Pi', + 'vLLM', + 'llm-d', + 'LiteLLM', + 'IBM watsonx.ai', + 'OpenRouter', + 'Anthropic', + 'OpenAI', + 'DeepSeek', +] + +function integrationsJsonLd() { + return { + '@context': 'https://schema.org', + '@type': 'TechArticle', + headline: 'Supported agents & inference engines', + description: INTEGRATIONS_DESCRIPTION, + url: 'https://docs.hivecommons.dev/docs/hive/integrations', + about: INTEGRATION_NAMES.map((name) => ({ '@type': 'SoftwareApplication', name })), + keywords: INTEGRATION_NAMES.join(', '), + publisher: { + '@type': 'Organization', + name: 'Hive Commons', + url: 'https://hivecommons.dev/', + }, + } +} + export const dynamic = 'force-static' export const dynamicParams = false @@ -185,6 +230,31 @@ function getProjectFromSlug(slug: string[]): { projectId: ProjectId | undefined; return { projectId: undefined, docSlug: slug } } + +export async function generateMetadata({ params }: Props): Promise { + const { slug } = await params + if (slug.join('/') === 'hive/integrations') { + return { + title: 'Supported agents & inference engines', + description: INTEGRATIONS_DESCRIPTION, + alternates: { canonical: '/docs/hive/integrations' }, + openGraph: { + type: 'article', + url: 'https://docs.hivecommons.dev/docs/hive/integrations', + title: 'Supported agents & inference engines', + description: INTEGRATIONS_DESCRIPTION, + }, + twitter: { + card: 'summary_large_image', + title: 'Supported agents & inference engines', + description: INTEGRATIONS_DESCRIPTION, + }, + robots: { index: true, follow: true }, + } + } + return {} +} + export default async function DocPage({ params }: Props) { const { slug } = await params const { projectId, docSlug } = getProjectFromSlug(slug) @@ -240,6 +310,8 @@ export default async function DocPage({ params }: Props) { const MDXContent = evaluated?.default + const isIntegrationsPage = projectId === 'hive' && filePath === 'integrations.md' + return ( + {isIntegrationsPage ? ( +