Linten

by Loopstates
5
4
3
2
1
Score: 50/100

Description

Official Obsidian plugin to validate, audit, and scaffold Spec v2 llms.txt & companion llms-full.txt files with live link health checks and frontier AI context budgeting. Powered by Loopstates.

Reviews

No reviews yet.

Stats

0
stars
13
downloads
0
forks
3
days
3
days
3
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
11
commits

Latest Version

3 days ago

Changelog

What's New in v1.0.4

🔍 Spec v2 AST Syntax & Structure Audit

  • Real-time linting for llms.txt and llms-full.txt files directly in Obsidian notes.
  • Validates headings hierarchy, section structure, and markdown link formatting according to LLMs.txt Spec v2.
  • Live multi-threaded probing of declared documentation URLs.
  • Identifies broken endpoints (HTTP 404), redirects (301/302), and latency metrics directly in the sidebar.

🤖 Frontier AI Context Window Budgeting

  • Instant token count estimations across frontier models: Gemini 2.0, Claude 3.5, GPT-4o, and DeepSeek-V3.
  • Know precisely how much context your llms.txt consumes before dispatching to agents.

⚡ Companion Archive Synthesis

  • One-click synthesis of companion llms-full.txt files via Linten Cloud.
  • Automatic canonical formatting (Format to Spec v2) and dynamic README SVG badge generation.

📦 Installation & Verification

For manual verification, download and place main.js, manifest.json, and styles.css into your vault's .obsidian/plugins/linten/ folder.

Engineered by Loopstates

README file from

Github

Linten: llms.txt Validator & Scaffolder for Obsidian

Version VS Code Extension Spec Standard Backend Privacy Engineered By

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:

For inquiries, custom domain validation servers, or support, contact [email protected].


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.