Linten: llms.txt Validator & Scaffolder for Obsidian

The definitive validator, link auditor, context budgeter, and scaffolding companion for llms.txt and llms-full.txt in Obsidian. Engineered by Loopstates.

---

Overview

Modern Large Language Models (LLMs) and autonomous research agents (ChatGPT Search, Perplexity AI, Claude Artifacts, Antigravity, Cursor, Copilot) prioritize structured, machine-readable markdown manifests over bloated HTML bundles.

Whether you maintain a public digital garden, corporate knowledge base, or private vault of technical notes, Linten provides in-vault AST validation, broken link detection, frontier AI token capacity gauges, and companion file synthesis directly inside Obsidian.

---

Key Capabilities

• Spec v2 AST Validation: Instant compliance checks verifying single H1 titles, required blockquote summaries, and standard markdown list hierarchies.
• 100-Link Live Health Probe: Concurrently verifies up to 100 links per document, flagging broken endpoints (404), redirect chains (301/302), and connection timeouts.
• Frontier AI Model Context Budgeting: Real-time token load multi-gauge comparing note footprints against Google Gemini 2.0 (1M), Claude 3.5 Sonnet (200k), OpenAI GPT-4o (128k), and DeepSeek-V3 (64k).
• 30 Spec-Compliant Industry Starter Presets: Fuzzy search and load industry-tested templates for SaaS, Developer APIs, E-Commerce, Healthcare, Corporate Law, AI Infrastructure, Shopify, Notion, and more.
• Companion Synthesis (llms-full.txt): Automatically crawls referenced documentation links to bundle un-truncated reference archives into your vault.
• Canonical AST Auto-Formatter: Normalizes inconsistent markdown to strict canonical llms.txt AST structure with a single click.
• Remote Website / Domain Auditing: Audit external documentation sites (e.g. acme.com) directly from Obsidian without needing a local file.
• Dynamic Note Compliance Badge: Generates live tamper-proof SVG badges verifying your domain's live llms.txt compliance score.
• Vault Compliance Report Exporter: Exports detailed audit findings, link health summaries, and token metrics into structured Markdown (.md) reports.
• Cross-Platform Mobile Ready: Built using Web Crypto (crypto.subtle) and native Obsidian requestUrl, ensuring identical performance across Desktop (macOS, Windows, Linux) and Mobile (iOS, iPadOS, Android).

---

Available Commands

Access these actions via the Obsidian Command Palette (Ctrl/Cmd + P), ribbon icon, or note context menu:

Command	Description
Linten: Validate current note as llms.txt	Audits the open note and displays the interactive audit modal with scores, findings, and quick actions.
Linten: View last audit report	Re-opens the most recent audit results without triggering a new network request.
Linten: Audit remote website or URL	Validates any remote website's /llms.txt manifest over the web.
Linten: Insert industry starter template	Fuzzy picker to search and apply 30 industry-specific starter templates.
Linten: Audit live link health	Concurrently probes up to 100 links in the note and displays latency, status codes, and redirect targets.
Linten: Estimate frontier AI context budget	Computes token footprint and context window utilization across frontier LLMs.
Linten: Generate starter llms.txt from website	Scaffolds a complete starter manifest from any live website URL.
Linten: Synthesize companion llms-full.txt	Aggregates all documentation links into a companion full-text file.
Linten: Format note to canonical llms.txt AST conventions	Cleans and normalizes headings, summaries, and bullet lists.
Linten: Generate README / Note compliance badge	Generates dynamic verification badge markdown or inserts it into the note.
Linten: Export compliance audit report	Saves a structured markdown report into your vault.

---

Editor Context Menu

Right-click anywhere inside an active markdown note or llms.txt file to quickly access:

• Linten: Validate llms.txt
• Linten: Audit Link Health
• Linten: AI Context Budget
• Linten: Format to AST Spec

---

Privacy & Cloud Architecture

Linten uses a hybrid architecture designed for performance and privacy:

• Local In-Vault Execution: Template insertion (all 30 presets), document formatting, and frontier token metrics execute 100% locally inside Obsidian.
• Linten Cloud API (https://linten.apps.loopstates.com/api/v1): Powers deep Spec v2 validation audits, the concurrent 100-link reachability probe, website scaffolding, and companion file synthesis.
• HMAC-SHA256 Security: All communication with Linten Cloud is authenticated using time-windowed HMAC-SHA256 signatures via standard W3C Web Crypto (crypto.subtle).
• Stateless Zero Data Retention: Linten Cloud operates entirely statelessly. Content sent for validation or link checking is analyzed strictly in-memory and is never logged, indexed, or stored on databases.

---

Settings & Configuration

Configure settings under Community Plugins → Linten:

Setting	Default	Description
API Endpoint	https://linten.apps.loopstates.com/api/v1	Enterprise endpoint for link checking and remote audits
Live Link Probing	true	Concurrently probes HTTP endpoints for reachability
Validate on Save	true	Automatically audits notes when saving with debounce

---

Enterprise Support & Ecosystem

Linten is part of the Loopstates AI Retrieval Infrastructure Suite:

• Loopstates Official Website: https://loopstates.com
• Linten Web Audit Platform: https://linten.apps.loopstates.com
• Visual Studio Code Extension: Available on VS Code Marketplace
• GitHub Repository: https://github.com/loopstates/linten-obsidian
• Official llms.txt Specification: https://llmstxt.org

For inquiries, custom domain validation servers, or support, contact hello@loopstates.com.

---

License

Proprietary © 2026 Loopstates. All rights reserved.
Source-available for personal evaluation and security auditing under the Loopstates Client License. Commercial copying, rebranding, or competitive redistribution is strictly prohibited.