Hive Hive
Sign in

docs(self-hosting): refine guide structure and references

GitHub issue · Closed

Metadata
Source
tuist/hive #95
Updated
Jul 5, 2026
Domains
Hive
Details

What changed

This keeps the blog addition from the original branch and refreshes the public docs around self-hosting and model configuration. The self-hosting guide now starts every page with a top-level title, links project and package references directly, and keeps VitePress layout defaults instead of overriding heading and sidebar spacing.

The old Agents and Inference relay split is now a single Model gateway page. It explains why Hive behaves like a gateway, covers client traffic, profiles, tokens, usage and cost, and folds the agentic workflows into the same model-provider story. The previous Agents page now points readers to the merged page.

A new Configuration reference lives under a References sidebar group and gives environment variables stable anchors. The guide pages link environment variable mentions back to that reference. The README also now warns that Hive is still work in progress.

Why

The guide had started to mix product concepts, deployment details, and implementation details in ways that made it harder to follow. Operators needed a clearer path for understanding what to configure, how authorization works, and how model-backed features are controlled.

Approach

The docs now keep narrative pages focused on behavior and workflows, while the reference page owns environment variable details. The existing /guide/self-hosting/inference route stays in place for the Model gateway page so existing links continue to work.

Impact

This is documentation-only. It changes navigation and wording on the docs site, adds a configuration reference, removes stale guidance from the old Agents page, and does not change application behavior.

Validation

  • git diff --check
  • ./node_modules/.bin/vitepress build from docs/
  • Headless Chrome screenshots:

Configuration reference

Authorization admin guidance

Model gateway guide

Agents redirect page

Flights

Investigate, reproduce, or fix this item in an isolated repository. Each Flight preserves its outcome and agent session.

New Flights are paused Configure model inference, GitHub, and a sandbox provider to start another Flight. Existing results remain available below.
No Flights yet

Start a Flight and preserve its objective, outcome, and session here.

Comments
GA
github-actions[bot] Jun 26, 2026

Blick review didn’t run

The blick review step failed before producing a manifest, so there’s no review to post on this PR. This usually means the agent (opencode) couldn’t start — common causes are an expired or suspended model API key, a missing secret, or the workflow timing out.

See the workflow run for details: https://github.com/tuist/hive/actions/runs/28232200516

Commit: 2799bc801614814d8e6547d8d68ae2cb91128de6

GA
github-actions[bot] Jun 29, 2026

Blick review didn’t run

The blick review step failed before producing a manifest, so there’s no review to post on this PR. This usually means the agent (opencode) couldn’t start — common causes are an expired or suspended model API key, a missing secret, or the workflow timing out.

See the workflow run for details: https://github.com/tuist/hive/actions/runs/28232200516

Commit: 2799bc801614814d8e6547d8d68ae2cb91128de6