World's first agentic AI CLI for geotechnical engineering

Agentic AI meets
the subsurface.

Local GroundModels, vision workflows, and AI reasoning powered by GLM 5.2 - combined with deterministic geotechnical engines. No provider key. No signup. One command.

$ geotech analyze . --branch foundation
INFO  Scanning local project workspace...
OK    18 files discovered, 9 supported datasets
OK    CSV/XLSX schemas: SPT, lab, coordinates
OK    GroundModel: 4 boreholes, 52 evidence refs
WARN  Verifier: review, groundwater assumption required
OK Branches: foundation, mapping, site-investigation
INFO Open browser dossier: geotech analyze . --format html

$ 

geotechCLI is the world's first agentic AI CLI purpose-built for geotechnical engineering — combining deterministic calculation engines with GLM 5.2 multi-agent orchestration, vision workflows, and AI-drafted reports in a single terminal interface.

Capabilities

Built for the subsurface.

Deterministic engines first, hosted AI where it helps, and now a visible bundled skill library for repeatable geotechnical workflows.

Workspace Analysis

Scan a local project folder, infer CSV/XLSX schemas, build an evidence-bound GroundModel, and open a browser dossier before spending hosted-beta GPU time.

Local

Vision AI Workflows

Point a photo at a tunnel face, core box, or borehole log and extract RQD, fracture spacing, weathering, and classification signals automatically.

GLM 5.2

AI Chat and GBR Q&A

Run an interactive AI session with project memory, or interrogate a Geotechnical Baseline Report through terminal-first document Q&A.

Agentic AI

Deterministic Engines

USCS, RMR89, Q-system, bearing capacity, pile, slope, liquefaction, TBM, retaining, and engineering plots stay available as fast deterministic building blocks.

Live

TBM and Tunnel Analysis

Penetration rate, thrust, torque, cutter wear prediction, and TBM type selection can hand off directly into tunnel reasoning workflows.

Live + AI

Bundled Skill Library

49 bundled strong-beta skills ship with the CLI for repeatable screening, review, excavation, groundwater, tunnel, and foundation workflows through geotech skill or agent and chat with --skills.

49 Bundled
Bundled Skills

Strong-beta skills are now visible, bundled, and ready.

Use the local skill catalog directly from the CLI, or let agent and chat sessions opt into the approved skill toolset when you want repeatable workflows inside AI analysis.

Bundled with the strong-beta install and bootstrapped on first use
Direct CLI workflow for list, show, validate, and run
Optional agent and chat access with the per-session --skills flag
skill workflow
# See the bundled catalog
$ geotech skill list
49 bundled strong-beta skills detected

# Inspect one installed workflow
$ geotech skill show shallow-foundation-option-screening
approval: approved
runtime: python-script

# Let agent use skills for one session
$ geotech agent "screen shallow foundation options for this site" --skills
Workflow

Three commands. Full pipeline.

From raw site parameters to engineering deliverables — no boilerplate, no setup friction.

1

Install

One npm command. No runtime dependencies, no provider key, no account required. Node.js LTS is all you need.

$ npm install -g geotechcli
2

Analyze

Run deterministic calculations or send AI commands against the hosted GLM beta. Results in seconds, not spreadsheets.

$ geotech bearing --depth 5 --phi 30 --cohesion 25
3

Deliver

Export to JSON, GeoJSON, DXF, or generate an AI-drafted report. Pipe output to scripts or CI pipelines.

$ geotech report --json > site-analysis.json
1st
Agentic AI CLI in Geotechnical Engineering
0
Bundled Skills Shipped in Beta
0+
Deterministic Commands
0
API Keys Required
Workflow

From raw data to insight.

Local GroundModels, deterministic checks, and hosted-beta workflows without boilerplate.

input
# Bearing capacity analysis
geotech bearing --depth 5 --phi 30 \
  --cohesion 25 --width 2.5

# RMR from tunnel face photo
geotech vision rmr face.jpg

# TBM performance prediction
geotech tunnel tbm-predict \
  --diameter 6.5 --ucs 80 --rqd 65

# Local GroundModel dossier
geotech analyze . --format html
output
OK Bearing Capacity - Meyerhof
  Ultimate:   4,184 kPa
  Allowable:  1,395 kPa (FS=3)

OK Hybrid RMR Classification
  Vision:     UCS approx 85 MPa, RQD approx 72%
  RMR = 65 -> Class II: Good Rock
  Support: spot bolts + 50mm shotcrete

OK TBM Performance
  Penetration: 8.4 mm/rev
  Daily advance: 14.2 m/day
  Cutter life: 380 m/cutter

OK Workspace dossier saved to .geotech/workspace-dossier.html
  GroundModel: 4 boreholes, 52 evidence refs
  Verifier: review (0 blocking, 2 review)
Privacy First

Engineering data deserves a hard boundary.

The strong beta trust model is intentionally simple: no signup, no data resale, no training on user project data, and no prompt or file storage on geotechCLI servers as part of the intended hosted beta path.

Requests still have to reach the model provider needed to answer them. In hosted beta, geotechCLI forwards requests only for completion and keeps minimal hashed abuse-protection counters instead of raw prompt history.

Read privacy details
No signup

No account wall for beta evaluation

Strong beta does not require account creation, billing setup, or profile completion before users can evaluate the CLI.

No prompt storage

geotechCLI does not keep your prompt or file content

Hosted beta requests are intended to be forwarded only for real-time completion, not stored on geotechCLI servers as reusable prompt or file history.

No training

Your project data is not used to train geotechCLI

We do not build training datasets from user prompts, uploaded engineering files, or generated outputs.

Minimal metadata

Only lightweight abuse-protection counters remain

For hosted beta safety, the design keeps short-lived hashed rate-limit data and service health metadata, not raw prompt logs or reusable engineering content.

Support & Membership

Deterministic tools are free. LLM features run on your support.

Every deterministic geotechnical calculation in the CLI is free for everyone, forever — no signup, works offline. The agentic LLM (Tier-1) features are donation-supported so we can keep building.

Deterministic CLIFree forever

No signup · works offline · no API key

  • -Bearing capacityTerzaghi / Meyerhof / Hansen / Vesic.
  • -LiquefactionBoulanger & Idriss / NCEER triggering.
  • -ClassificationUSCS, RMR89, Q-system.
  • -Pile capacityAlpha / beta / SPT methods.
  • -Slope stabilityBishop simplified.
  • -Retaining / earth pressureRankine / Coulomb.
  • -SeepageDeterministic groundwater routing.
  • -SettlementElastic / consolidation / Schmertmann.
  • -Tunnel / TBMPenetration, thrust, torque, cutter wear, TBM selection.
  • -Workspace analysisEvidence-bound GroundModel + verifier, fully offline.
  • -Monitoring analysisSettlement, piezometer, inclinometer, vibration, load-test trends.
  • -VisualizationInteractive engineering plots.
  • -ExportCSV, DXF, GeoJSON, AGSi, DIGGS interchange.
  • -Bundled skillsRepeatable deterministic screening workflows.
Tier-1 LLM & AgenticDonation-supported

Hosted GLM defaults: glm-5.2 (text) / glm-5v-turbo (vision) — or bring your own key.

  • -Agentic chatInteractive ReAct agent with memory; auto-loads your project dataset.
  • -Project agentReasons over the GroundModel and routes work into deterministic tools.
  • -Document ingestEvidence-bound extraction from borehole logs and reports (PDF/image).
  • -Vision workflowsCore box, tunnel-face RMR, sensor charts, borehole-log photos.
  • -GBR Q&AInterrogate a Geotechnical Baseline Report in the terminal.
  • -AI report synthesisDraft evidence-first geotechnical reports.
  • -NL classificationSoil description to USCS + properties.

Bring your own key: OpenAI · Anthropic · Zhipu / Z.ai · OpenAI-compatible / OpenRouter · Hugging Face.

Support Tier-1 with a donation

Donations start at $10 or more through Patreon. Your support keeps the LLM and agentic features alive and improving.

Before you donate — please read

Patreon has no one-time payment option; memberships renew automatically every month. Our goal is a donation, not a subscription. To keep it a one-time gift and avoid automatic withdrawals in the following months, cancel your Patreon membership immediately after your payment clears. Your support for this month is what matters — thank you.

Get Started

Install geotechCLI.
Support the build.

Deterministic tools are free for everyone, no key required. The agentic LLM features are donation-supported — your support keeps them growing.

Deterministic tools free forever · LLM features donation-supported · Privacy-first