AGS Geotech Toolkit

A Chrome extension for viewing, validating, comparing, and editing AGS4 geotechnical data files directly in the browser.

Features

Viewer

• Tabbed data viewer with colour-coded headers, units, and type rows
• Column filters for quick data search
• Group search bar
• Syntax-highlighted raw view
• Identifies custom (DICT-defined), non-standard, and AGS 4.2 groups

Validation

• Real-time validation against the complete AGS 4.2 specification
• Structure checks, required field validation, column count verification
• Foreign key reference validation
• DICT-aware: recognises and validates custom groups defined in the file
• Built from the official AGS 4.1.1 data dictionary and AGS 4.2 specification

Gmail Integration

• Inline preview of AGS attachments in Gmail's preview overlay
• No download required to view the data

Field Dictionary

• Right-click any AGS field name to look up its definition, type, and description
• Hover hints mode: see field descriptions on mouse hover (toggle via context menu)
• Covers all standard AGS 4.1.1 and 4.2 groups and headings

Download Interception

• Automatically opens the viewer when an AGS file is downloaded
• File still saves to disk normally

Install

From Chrome Web Store

Coming soon.

From Source

1. Clone this repository
2. npm install
3. npm run build - compiles Tailwind CSS for the viewer + popup, and bundles CodeMirror into lib/codemirror-bundle.js (the bundle is gitignored, you have to build it once before loading the extension)
4. Open chrome://extensions and enable Developer Mode
5. Click "Load unpacked" and select this folder

Schema Sources

The AGS4 field dictionary is built from two authoritative sources:

• AGS 4.1.1: Official AGS data dictionary JSON
• AGS 4.2: Official AGS 4.2 Groups and Headings CSV export

Privacy

This extension runs entirely in your browser. No data is collected, transmitted, or stored externally.

Related

• AGS Geotech Toolkit - VS Code extension by the same author with syntax highlighting, real-time validation, hover docs, sticky HEADING/UNIT/TYPE rows, an aligned column view, and an editable table view.

About AGS Format

The AGS format is the UK industry standard for electronic transfer of geotechnical and geoenvironmental data, maintained by the Association of Geotechnical and Geoenvironmental Specialists. This extension is an independent tool and is not affiliated with the AGS.

Disclaimer

This extension is provided as-is, without warranty of any kind. The parser, validator, and diff engine are best-effort implementations and may not catch every edge case. Malformed files, non-standard groups, unusual encodings, or ambiguous rows may be parsed or validated incorrectly. A clean validation result does not certify that a file is standards-compliant.

Do not rely on this tool's output for safety-critical, contractual, or regulatory decisions without independent verification against the authoritative AGS specification and the file's source data.

License

MIT, see LICENSE.