Context
Project-aware startup
A compact brief carries repository rules, current branch/worktree facts and relevant knowledge without asking the model to rediscover them.
hive-pi
A coding-agent harness built to finish the work.
hive-pi turns Pi into an operating environment for real repositories: project context, reviewed tools, visible plans, delegated research, quality gates and native Hive telemetry around every session.
Private-beta surface: delegation and cross-lane parity are still evolving. Interactive workstation Pi and the Factory’s pinned Pi runtime share integration contracts, not an unrestricted extension bundle.
Session contract · active
The harness turns intent into a visible execution loop.
The model still writes code. hive-pi supplies the surrounding mechanics that keep it oriented, bounded, reviewable and connected to delivery.
FRAME
PLAN
EXEC
VERIFY
- Context
- Repository-aware from turn one
- Control
- Plan, tasks, gates and budgets
- Visibility
- Session state inside Hive
The session loop
Frame, plan, execute, verify—without hiding the transitions.
A conductor advances the lifecycle from signals the session already emits. It does not make a second model guess what the first one is doing.
- 01 · Frame
Load the right world
Repository rules, current worktrees, project context and prior knowledge arrive before the first implementation choice.
- 02 · Plan
Make intent inspectable
Complex work produces a reviewable plan and a verifiable finish condition before mutating the repository.
- 03 · Execute
Use the cheapest useful worker
In the private-beta interactive harness, read-heavy searches and reviews can fan out to bounded subagents while one parent keeps synthesis and delivery ownership.
- 04 · Verify
Close against evidence
Repository gates, held-out checks and PR status—not a confident final sentence—decide whether the work is complete.
Harness capabilities
The mechanics around the model are the product.
Each capability makes a real session easier to understand or harder to fake.
Tools
Typed calls with visible results
Local tools, MCP integrations and project-specific skills show up as explicit capabilities rather than undocumented shell folklore.
Workflow
Plans and execution stay separate
A stable plan records intent; a live workflow records what actually happened, including delegated workers and CI delivery state.
Delegation · beta
Read wide, write through one owner
Bounded interactive workers can explore independent questions cheaply. The primary session reconciles claims and owns edits, verification and delivery.
Guardrails
Policy outside the model
Worktree protection, sandbox paths, credential requests, spend limits and gate checks do not depend on the model remembering a sentence.
Hive native
Telemetry and steering built in
Phase, transcript, plan, workflow, usage and commands flow into the Agents workspace under the session owner’s identity.
One vocabulary, separate runtimes
Parity where it helps. Separation where trust demands it.
The workstation and Factory use Pi for different jobs, so Hive shares the integration contract while keeping execution authority narrow.
Workstation
The full interactive harness
The public hive-pi foundation and tenant overlay provide the daily-driver extensions, agents, skills, themes and workstation setup around Pi.
Cloud session
Interactive Pi in an ephemeral lane
A headless RPC session reports through the same Hive remote and telemetry surfaces, with cloud-specific lifecycle and delivery.
Factory runtime
Pinned, reviewed and intentionally smaller
The Factory image loads only its reviewed extensions. Checkout skills and prompt templates are disabled; the wrapper owns policy and delivery.
Native integration
Hive is the system of record around the session.
The harness does not need to invent a second build, ticket or agent platform. It publishes into the one already operating the repository.
Plan + workflowIntent and live progress render beside the transcript.
Tasks + teamsWork can split, report, reconcile and surface overlap.
CI + deliveryBranch, pull request and Hive checks remain visible to the session.
Knowledge + toolsSearches and product APIs are called through bounded interfaces.
Usage + budgetsTokens, cost and context pressure stay measurable per session.
The surrounding system
hive-pi connects human-directed work to the same platform that runs CI.
Private beta
Bring one repository. See the whole system work.
Start on your own runner, keep your existing CI beside it, and watch Hive turn the next eligible red check into a reviewable fix.