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.

Community-supported open source

Keep geotechCLI open, reliable, and accessible.

geotechCLI is an Apache-2.0 open-source toolkit for geotechnical engineering. The deterministic engines remain free for everyone. Sponsorship helps cover hosted AI usage, cross-platform testing, documentation, security maintenance, and the time required to review contributions and ship dependable releases.

Sponsor monthly

Community Backer
$10 / month

Hosting, CI and shared API costs

  • Help cover hosting, CI, and shared API costs
  • Optional recognition in SUPPORTERS.md
Sponsor on Patreon — $10/mo
Recommended
Project Sustainer
$50 / month

Testing, documentation, security and releases

  • Support documentation, testing, maintenance, and regular releases
  • Optional recognition in SUPPORTERS.md
  • Periodic public project updates
Sponsor on Patreon — $50/mo
Organization Sponsor
$100 / month

Firms, labs and universities

  • For engineering firms, research groups, and universities using geotechCLI
  • Optional name or logo recognition on the sponsor page and README
Sponsor on Patreon — $100/mo

How sponsorship works

Sponsorship runs through Patreon and is billed monthly. You can change tier or cancel at any time from your Patreon account, and cancelling keeps the month you have already paid for. There is no minimum commitment and no contract.

Trust note: Sponsorship is optional and never changes access to the project. It does not purchase engineering approval, an SLA, roadmap control, or a guaranteed feature. Priorities remain based on safety, community value, and maintainer capacity.

Prefer to contribute time?

Report an issue, improve the documentation, propose a test case, or open a pull request. Apache-2.0 licensed — issues and pull requests are open to everyone, and you never need to be a sponsor to contribute.

View on GitHub →

What is free, and what your support funds

Every deterministic geotechnical calculation is free for everyone, forever — no signup, works offline. The agentic LLM features are what sponsorship keeps running.

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 & AgenticSponsor-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.

Deterministic engines stay free whether or not anyone sponsors — they run offline with no key and no account.

Get Started

Install geotechCLI.
Support the build.

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

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