Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
154 changes: 154 additions & 0 deletions docs/content/hive/integrations.md
Original file line number Diff line number Diff line change
@@ -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.
11 changes: 11 additions & 0 deletions public/llms.txt
Original file line number Diff line number Diff line change
@@ -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.
78 changes: 78 additions & 0 deletions src/app/docs/[...slug]/page.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -185,6 +230,31 @@ function getProjectFromSlug(slug: string[]): { projectId: ProjectId | undefined;
return { projectId: undefined, docSlug: slug }
}


export async function generateMetadata({ params }: Props): Promise<Metadata> {
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)
Expand Down Expand Up @@ -240,6 +310,8 @@ export default async function DocPage({ params }: Props) {

const MDXContent = evaluated?.default

const isIntegrationsPage = projectId === 'hive' && filePath === 'integrations.md'

return (
<Wrapper
toc={evaluated?.toc ?? []}
Expand All @@ -248,6 +320,12 @@ export default async function DocPage({ params }: Props) {
projectId={projectId ?? 'hive'}
sourceUrl={sourceUrl}
>
{isIntegrationsPage ? (
<script
type="application/ld+json"
dangerouslySetInnerHTML={{ __html: JSON.stringify(integrationsJsonLd()) }}
/>
) : null}
{compilationFailed || !MDXContent ? <pre>{content}</pre> : <MDXContent />}
</Wrapper>
)
Expand Down
1 change: 1 addition & 0 deletions src/app/docs/page-map.ts
Original file line number Diff line number Diff line change
Expand Up @@ -96,6 +96,7 @@ const NAV_STRUCTURE_HIVE: Array<{ title: string; items: NavItem[] }> = [
{ 'Introduction': 'readme.md' },
{ 'Getting Started': 'getting-started.md' },
{ 'Documentation Map': 'documentation-map.md' },
{ 'Supported agents & inference engines': 'integrations.md' },
{ 'Architecture': 'architecture.md' },
{ 'Roadmap': 'roadmap.md' },
{ 'Landscape': 'landscape.md' },
Expand Down
Loading