Skip to content
ODS

Make your documents easy for people and AI to understand.

ODS maps connections across your files so AI tools (Claude, Cursor, Copilot & Antigravity) read only what they need — giving you instant answers while saving up to 94% in AI costs.

Paste this single prompt directly into your AI assistant chat window:

Run "gh skill install open-doc-spec/ods-skills" & make my docs AI-ready
Zero Setup Needed
94% AI Savings
Instant Pinpoint Answers
94.97%
Saved in AI Cost
< 5ms
Scanning Speed
17+
AI Tools Supported
100%
Private & Secure

Give AI Less. Let It Understand More.

ODS finds the information that matters before AI starts processing — reducing noise, cost, and unnecessary context.

01EverythingToo much information
02ODS finds what mattersFilters before AI starts
03Relevant contextOnly what AI needs
ODSAIAnswer
Less Context
Lower Cost
Better Answers

Estimate Your Team's AI & Cost Savings

Enter your team size and usage to see how much money and tokens you save on AI tools with ODS.

10 devs
20 prompts
Estimated Annual Savings~95% saved
$9,735/ year
Tokens Saved / Day
15,576,000
tokens filtered before LLM
Response Speed
24x
faster agent execution

Built for Everyone: Writers, Managers, and Developers

ODS is not just for programmers. Anyone who writes documents, guides, guidelines, or research can use ODS without touching a terminal.

PRDGoals

Product & Business Managers

Link PRDs, goals, and checklists directly to project plans.

share: private

Legal, HR & Compliance

Enforce policy rules and keep sensitive data private.

PaperRef ARef BCite

Researchers & Academics

Map and link citations across research notes and papers.

ADR.mdinit_db()

Engineering & DevOps

Connect technical specs and guides directly to source code.

Install ODS in Seconds

Install the ODS skill via gh skill install open-doc-spec/ods-skills, then prompt your AI assistant: "Install ods on this machine and start watching ./docs"

CHOOSE YOUR AI ASSISTANT17+ Assistants
Native Skill
$ ods install
✓ Installing ODS...
✓ Reading list enabled
✓ Connected to your AI assistant
✓ Ready to go!

> Ask your AI anything.
One Command Setup

No extensions or accounts needed

100% Local & Private

Zero telemetry or cloud dependencies

94% Cost Savings

Fast answers with minimum tokens

How ODS Works in 3 Simple Steps

A clean, deterministic workflow from repo initialization to live link maintenance.

Step 1
ods.toml

Prepare Workspace

Run ods init . to create a root ods.toml workspace marker and make your repo ODS-compliant.

$ ods init .
Step 2

Lint & Validate Graph

Run ods lint . to instantly validate your document graph, cross-file references, and frontmatter profiles.

$ ods lint .
Step 3

Background Auto-Sync

Run ods start . to launch the background watch service and automatically repair links whenever files move.

$ ods start .

Vector Search vs ODS Smart Mapping

Why engineering and AI teams replace heavy vector indexing pipelines with deterministic ODS document graphs.

CAPABILITY / METRICEvaluation Criteria
Traditional ApproachVector Search (RAG)
RECOMMENDED STANDARDODS Document Map
How AI Reads Pages
Scrambled snippets
Full pages in exact orderDeterministic Context
Text Sent to AI
80,000+ words
4,100 wordsSave ~94% space
Search Speed
Slow (~1.5s)
Instant< 5 milliseconds
Maintenance Cost
$500+ / month
$0 / FreeZero Cloud Infra
Moving or Renaming Files
Search index breaks
Links auto-repairedSelf-Healing
Freedom & Portability
High vendor lock-in
Zero vendor lock-in100% Plain Text
Verdict

Deterministic document maps outperform vector search with sub-5ms lookups, 94% token savings, and zero vector database overhead.

ODS Document Templates

Pre-structured profiles to keep documents clean and organized.

profile: architecture

Architecture docs

Standardize architecture, APIs, and schemas.

profile: guide

Runbooks & Guides

Clear step-by-step setup and operations.

profile: feature

Product PRDs

Connect user goals to feature plans.

profile: note

Decision Records

Track design context, decisions, and impact.

Pricing & Tier Options

Open Document Spec core is 100% free and open-source forever under the Apache 2.0 license.

ODS Pro CloudComing Soon
Cloud
/ team user

Managed real-time sync, cloud indexing, and web doc hosting for teams.

Planned Features
  • Multi-user real-time graph sync
  • Automated graph drift & health alerts
  • Vector index & hybrid search pipeline
  • Zero-config web docs preview
Get Started in 2 Minutes

Ready to make your documents easy to read and manage?

Get started with ODS in under 2 minutes.