Complete Product Capability Showcase

ODS Product Features

Discover how Open Document Spec adds simple labels to your text files (.md) and connects them together so AI assistants can find what they need instantly.

Featured Capability

Smart AI Reading Lists

Gives your AI assistant only the exact documents linked to your files, avoiding massive folder dumps. This speeds up answers and cuts AI usage costs by up to 94.97%.

~94% Lower AI Cost
4,100 Exact Words Sent
< 5ms Document Scan
$ ods context docs/guide/01-introduction.md
Linked Document Reading List
Smart Reading List for [01-introduction.md]:
├── docs/guide/01-introduction.md (Main page)
├── specs/SPEC.md (linked page)
├── docs/guide/05-profiles.md (related page)
└── src/crates/ods-core/src/graph.rs (connected code)

✓ Total Context: 4,120 words (saves 94.97% compared to reading all documents)
✓ Annual Savings: 94.97% less cost
Code Connections

Connecting Code to Documents

Link your text pages directly to specific functions, rules, or testing files inside your program code.

$ ods context src/storage/db.rs
docs/architecture/storage.md
---
ods:
  profile: spec
  code:
    - path: src/storage/db.rs
      symbol: init_pool()
      role: implementation
    - path: tests/db_test.rs
      role: test
---
Open Standard

Works with Standard Text Files

No hidden databases or complex formats. ODS works on top of simple, standard text files (.md) with clean labels at the top. You own your files forever.

$ ods init
Root index.md
---
ods: 1.0.0
ods-cli: ">=0.1.0"
profiles:
  - spec
  - guide
---
# Workspace Index Tree

Automatic Link Repair Background Tool

Never break a link when you rename files, restructure folders, or change project layouts.

AI Tool Support

Works Natively with AI Tools

Plugs straight into Claude Code, Antigravity, Cursor, Windsurf, and other AI systems as a helper skill.

$ ods context --json
Claude Code
Antigravity
Cursor
Windsurf
Gradual Adoption

Simple Adoption Steps

Adopt ODS at your own pace: from zero-setup plain Markdown (Level 0) to mapped document boundaries (Level 1), standard templates and labels (Level 2), and automated link verification (Level 3).

$ ods index --check
L0 Standard text files
L1 Mapped document boundaries
L2 Standard templates & labels
L3 Automated link verification

ODS Templates: Simple Document Structure

Keep your documents consistent and organized without manual formatting debates.

profile: spec

Technical Specs

Required Headings
## Summary ## Requirements ## Schema
profile: guide

Runbooks & Guides

Required Headings
## Overview ## Prerequisites ## Steps
profile: feature

Product PRDs

Required Headings
## User Goal ## Acceptance Criteria
profile: note

ADRs & Decision Notes

Required Headings
## Context ## Decision ## Impact

Simple Adoption Steps

Level 0
Plain Markdown (Zero Setup)

Use existing .md files as-is with zero changes

Level 1
Mapped document boundaries

Root index.md & tags

Level 2
Standard templates & labels

Profiles & code symbols

Level 3
Automated link verification

Instant document scans

Onboard Existing Folders

Import Existing Files in Seconds

Import your existing text files in seconds. The ods adopt tool automatically sets up labels for all your files so you don't have to edit them manually.

$ ods adopt docs/
CLI Terminal Log
$ ods adopt docs/
✓ Scanned 148 Markdown files
✓ Generated document templates and labels
✓ Created root project index
Better Than Vector Search

Hallucination-Free Reading Lists

Avoid expensive search database hosting and errors. ODS delivers highly accurate reading lists to your AI by using the direct connections you specify.

$ ods graph --format dot
❌ Vector Search: 80,000 words (scrambled snippets)
✓ ODS Map: 4,100 words (instant linked pages)

Keep Sensitive Data Secure

Built-in controls to prevent private data or secret keys from leaking to external AI tools.

Cost Savings Stats

View Your Savings Stats

View estimated savings and cost reductions across your team using the built-in stats command.

$ ods bench stats
ods bench stats
$ ods bench stats
✓ Workspace Files: 240 docs
✓ Word Savings: 94.97%
✓ Estimated Annual Savings: $34,800
Label Management

Update Labels in Bulk

Search, filter, and rename labels across all your documents with a single quick command.

$ ods tag rename old-tag new-tag
Bulk Label Rename
$ ods tag rename deprecated legacy
✓ Updated 38 files in 12ms

Want to see the technical details?

All standard labels, properties, and terminal command flags are documented in the developer guides.