Running BlackHoles as a service, AI Code Tools

BlackHoles Agency Implementation, Multi-Repo Project Delivery

Learn how to structure multi-repository projects for client delivery, delegate coding tasks to AI agents with full repository context, and build productized services around parallel task workflows. This course teaches agencies how to compress project timelines by isolating work across repositories and automating code reviews without context-switching.

Open the decision record for BlackHoles

What does running BlackHoles for clients commit you to?

Published figures for this service. Blank fields are not published.

Monthly tool cost
BlackHoles is open-source (no published vendor license price). Agency cost is model-provider API usage under the agency's or client's own API keys, plus setup and oversight labor. Not modeled until the agency supplies provider rates and billable hours.
Time to first value
Not published
Payback
Not modeled
Guided implementation
8 hours

Is BlackHoles worth running as a client service?

Evidence supports BlackHoles as a local-first, multi-repo agent IDE with isolated Git worktrees and MCP tooling that a development agency can operate as a managed service. What remains unknown is its maturity, support, and real delivery economics, since no vendor pricing or market rates are published and all client price, labor, usage, and volume inputs must come from the agency.

An agency-fit judgement for reselling this service. It is separate from the tool description on the decision record.

Before you start

What has to be in place before the first client engagement.

Tools and subscriptions

  • BlackHoles desktop IDE (open-source, local-first)
  • API keys or subscriptions for Claude, Codex, Gemini, or OpenCode
  • GitHub access and existing Git repositories for the client project
  • Local Git and terminal environment
  • Local BlackHoles MCP endpoint for MCP clients such as Codex and Claude Code

People and inputs

  • Multi-repo project grouping setup (repos joined without merging)
  • Isolated task worktree conventions per repository
  • Integrated code review workflow for per-repository side-by-side diffs
  • Agent delegation templates with persistent task conversations and task notes

Included with the course

7 working documents for delivering this service.

  • Multi-Repo Project Setup Checklistchecklist
  • AI Agent Task Delegation SOPsop
  • Client Worktree Isolation Worksheetworksheet
  • Parallel Task Coordination Templatetemplate
  • Code Review and Diff Management Guideguide
  • GitHub Integration and Branch Strategysop
  • Retainer Pricing Model for Multi-Repo Servicestemplate

Listed by name. These documents are not yet published as individual downloads.