Meet the Geocluster Research Harness

Mon, 27 Jul 2026 00:00:00 +0800

TL;DR

Open-sources the Geocluster Research Harness under Apache-2.0: a browser-based, VS Code-style IDE with a geology-specialised AI agent and a toolbox of more than fifty geoscience analysis tools, addressing a gap general-purpose coding assistants have - they don’t know the domain, and will happily treat a value like “<0.005” as junk rather than a detection limit.
Runs with a single Docker command and comes pre-loaded with a synthetic exploration project, so a first query works before any user data is uploaded.
Built from three pieces: the Geology Agent (a heavily adapted fork of the open-source Cline coding agent), geocluster-mcp (a Python MCP server exposing the tools, with every file operation confined to the workspace), and the Docker harness that wires the two together locally.
The core engineering choice is a four-layer agent architecture with enforced separation of duties - a read-only chat agent, a zero-tool orchestrator that only plans, isolated specialist sub-agents restricted to filtered tool subsets, and a single wildcard layer that alone can install packages and must log every install - with each restriction tied to a specific measured failure it was introduced to fix, such as prompt bloat, runaway context, dependency conflicts, or agents bypassing the plan.
The agent is designed to keep answers checkable: it inspects large datasets via tools that return schema, statistics, and samples rather than loading raw files into its own context, and produces plots and derived artifacts as ordinary files with source citations for reported figures.
It is local-first (no accounts, no telemetry, bring-your-own model key) and built openly on top of Cline and code-server, with the fork’s lineage and licensing kept explicit and no claim of affiliation with either upstream project.

Key Takeaways

Open Source on Eigenform Articles

Meet the Geocluster Research Harness