Skip to content

Latest commit

 

History

History
118 lines (95 loc) · 11.5 KB

integrations.md

File metadata and controls

118 lines (95 loc) · 11.5 KB

Integrations

What Hive works with today, and what is planned. One row per integration. Each row links the doc that explains it. Planned and In progress rows link the tracking issue, or the page that leads to it.

Status key:

Status Meaning
Supported Wired into a running code path and covered by tests.
Opt-in Works, but an operator must turn it on, or it needs a per-backend escape hatch.
Planned Not usable today. The linked issue tracks the work.
In progress Started, not finished. The linked tracker lists what is left.

Agent backends

Tiers (T1 core, T2 confined, T3 experimental) come from backend-support-tiers.md. The source list is KNOWN_BACKENDS in config/backends.conf. Setup for each CLI is in backend-setup.md. T3 backends run in container mode by default; local mode needs an explicit opt-in.

LogoIntegrationStatusTierDocs
Claude logoClaude CodeSupportedT1 / T2backend-setup.md
GitHub Copilot logoGitHub Copilot CLISupportedT1 / T2backend-setup.md
CodexCodex CLI (OpenAI)SupportedT1 / T2backend-setup.md
GooseGoose (AAIF)SupportedT1 pod / T3 localgoose-at-scale.md
AntigravityGoogle Antigravity (agy)Opt-inT3backend-setup.md
GeminiGemini CLI (hub-managed only)SupportedGo-only, no local tierbackend-support-tiers.md
OpenAI-compatibleOpenAI-compatible gateways: vLLM, llm-d, LiteLLM, watsonx, OpenRouterSupportedGateway pathinference-backends.md, gateway-path tier
MuseMuse CodeSupportedT2backend-support-tiers.md
OpenCodeOpenCodeSupportedT2 (deny-list)backend-setup.md
BobIBM BobOpt-inT3backend-setup.md
PiPiOpt-inT3backend-setup.md
AiderAiderOpt-inT3backend-setup.md
KiloKilo CodeOpt-inT3backend-setup.md
OMPOh My Pi (OMP)Opt-inT3agent-configuration.md
OpenHandsOpenHands (legacy CLI)Opt-inT3backend-support-tiers.md
Claude logoClaude Managed AgentsExperimentalHosted execution; private self_hosted spoke, report-only, USD 25/day ledger capagent-configuration.md, backend-support-tiers.md
OpenAI AgentsOpenAI Agents APIPlanned—#14093
OmnigentOmnigentOpt-inT3backend-support-tiers.md

Local contributor inference

Integration Status Execution and limitations Docs
Apple MLX / MLX-LM through Pi Opt-in ClankeR on Apple Silicon macOS 14+, native Python 3.10+, Pi 1.4.0+; user-managed tool-capable models. MLX-LM runs on the Mac; Pi executes tools inside the contributor container with Docker Desktop host networking. No cloud fallback. Live Apple GPU inference remains unverified. Install and use with just

Apple MLX is a first-class inference-engine choice on /contribute, mapped to the actual pi coding backend and mlx/<model> provider selection. It is not a standalone coding CLI, hosted gateway, identity provider, or Apple endorsement. KNOWN_BACKENDS correctly continues to list coding executors, not inference frameworks.

Work sources and trackers

The governor reads work through one provider contract. The adapters live in src/pkg/worksource/ and are selected by governor.work_source.type.

LogoIntegrationStatusDocs
GitHub logoGitHub IssuesSupportedwork-sources.md
GitHub logoGitHub Projects (v2)Supportedwork-sources.md
Linear logoLinearSupportedwork-sources.md
Jira logoJira Cloud and Data CenterSupportedwork-sources.md

Forges

GitHub is the only forge agents can work against today. The GitLab and Gitea/Forgejo adapters in src/pkg/forge/ cover reads and core writes (comment, label, hold), and GitLab's can merge. Two governor writes use them, but the GitHub-only enumeration that feeds those writes means they never fire on a non-GitHub hive. See Forges.

LogoIntegrationStatusDocs
GitHub logoGitHub.com and GitHub EnterpriseSupportedgithub-app-setup.md
GitLab logoGitLab (SaaS or self-managed)Plannedforge-app-setup.md, #14096
Gitea logoGiteaPlannedforge-app-setup.md, #14096
Forgejo logoForgejoPlannedforge-app-setup.md, #14096

Isolation

The hub-side agent sandbox is off by default. See sandbox-isolation.md for the two launchers and the per-backend confinement matrix.

LogoIntegrationStatusDocs
Podman logoRootless Podman agent sandboxOpt-insandbox-isolation.md
Kubernetes logoKubernetes Job sandbox runtimeOpt-insandbox-isolation.md
NVIDIA logoNVIDIA OpenShell sandbox runtimeIn progress (opt-in, phase 1)sandbox-isolation.md · #17642
CNCF logoAgent Substrate sandbox runtime (CNCF Sandbox)In progress (opt-in, phase 2)sandbox-isolation.md · #17695
OpenSandboxAAIF OpenSandbox (evaluation)Planned#14092

Ecosystem and upstream

LogoIntegrationStatusDocs
CNCF logoCNCF sandbox onboardingIn progresscncf-sandbox-onboarding.md, #9846
gh-awGitHub Agentic Workflows (gh-aw) report-only sampleSupported (sample)deploy/gh-aw, tiers note
GooseGoose-at-scale guide upstreamed to AAIFPlannedgoose-at-scale.md, #14095

See also

Logos are trademarks of their respective owners. They are used here for identification only and do not imply endorsement.