Best OKF Viewers — How to View and Explore Open Knowledge Format Bundles
An OKF viewer helps you browse, search, and understand the contents of Open Knowledge Format bundles. Whether you prefer a web interface, a terminal, or your code editor, there's an OKF viewer that fits your workflow.
What Is an OKF Viewer?
An OKF viewer is any tool that can read, display, and help you navigate the contents of an Open Knowledge Format (OKF) bundle. Since OKF bundles are directories of markdown files with YAML frontmatter, a viewer needs to understand this structure and present it in a human-readable way.
A good OKF viewer should:
- Display bundle metadata — Show the
index.mdmanifest, description, tags, and version info - Navigate the concept tree — Let you browse through subdirectories and individual concept documents
- Render markdown content — Display concept documents with formatting, code blocks, and links
- Follow cross-links — Allow clicking through internal links to related concepts
- Search bundle contents — Find specific concepts by keyword or tag
Key insight: Because OKF bundles are just markdown files, any markdown-capable tool is technically an OKF viewer. What differentiates dedicated viewers is their understanding of bundle structure — they can navigate concepts, follow cross-links, and display metadata in context.
BundleDex — The Web-Based OKF Viewer
BundleDex is the most comprehensive web-based OKF viewer available. Unlike a simple file browser, BundleDex understands the full OKF bundle structure and provides rich exploration features:
Search and Discovery
Browse all 583 indexed bundles using full-text search, tag filters, and category grouping. Each bundle shows:
- Name, description, and author
- GitHub star count and social proof
- OKF conformance badge — verified against the spec
- Category tags for filtering (cli, tool, pkm, notes, etc.)
Detailed Bundle Pages
Each bundle on BundleDex has a dedicated page that serves as a rich OKF viewer. These pages display the bundle's index.md content, list all concept documents, show cross-link relationships, and provide direct links to the GitHub repository. For example, explore the top bundle iwe or browse all bundles.
API Access
BundleDex also provides a JSON API at /api/bundles.json that serves as a programmatic OKF viewer for AI agents and automation:
# Fetch all bundles as JSON
curl https://bundledex.net/api/bundles.json | jq '.bundles[:5] | .[] | {name, stars, description}'CLI-Based OKF Viewers
For developers who prefer the terminal, several CLI tools double as OKF viewers:
Open Knowledge CLI
The Open Knowledge CLI (openknowledge) is the official CLI for OKF. Beyond creating and validating bundles, it can read and display bundle contents:
# View a bundle's index manifest
openknowledge view ./my-bundle/
# List all concepts in a bundle
openknowledge list ./my-bundle/
# Show concept details with frontmatter
openknowledge show ./my-bundle/concepts/core.mdiwe — Markdown Memory System
iwe is the most-starred OKF bundle and includes a powerful CLI that serves as both a knowledge manager and OKF viewer. It understands the OKF directory structure and provides rich navigation:
# View iwe's own bundle structure
git clone https://github.com/iwe-org/iwe.git
cd iwe
# Various ways to explore
ls concepts/ # List concept documents
cat index.md # View the manifest
cat concepts/*.md # Read all conceptsokf-viewer
The dedicated okf-viewer tool provides a visual terminal interface for browsing OKF bundles. It parses the bundle structure and generates an interactive knowledge map showing how concepts connect.
Editor and Desktop Viewers
VS Code and Cursor
VS Code is an excellent OKF viewer. Open the bundle directory using File > Open Folder, and you get:
- File explorer showing the full bundle tree
- Markdown preview with
Ctrl+Shift+V - Search across all concept files
- Git integration for diffing bundle versions
For AI-powered browsing, Cursor loads OKF bundles directly into agent context, making it both a viewer and an interactive knowledge assistant.
Obsidian
As covered in OKF for Obsidian, Obsidian's vault system makes it a natural OKF viewer. Open an OKF bundle as a vault to get:
- Full graph view showing concept relationships
- Backlinks pane for every concept
- Tag-based navigation and queries
- YAML frontmatter rendered as Properties
OKF Harness
OKF Harness is a dedicated desktop application for browsing and managing OKF bundles. It provides a native experience with a purpose-built UI for navigating bundle structures.
Tip: For quick, ad-hoc viewing, nothing beats the simplicity of cat and ls. OKF bundles are just files — the Unix philosophy applies. But for serious exploration, use BundleDex or Obsidian.
How to View OKF Bundles from the Command Line
No viewer tool? No problem. OKF bundles are plain files, so basic command-line tools work as a lightweight viewer:
# 1. Clone a bundle
git clone https://github.com/iwe-org/iwe.git
cd iwe
# 2. View the bundle manifest
cat index.md
# 3. List all concept documents
find . -name "*.md" -not -path "./.git/*" | sort
# 4. Read a specific concept
cat concepts/ai-native-life-os.md
# 5. Quick metadata overview
head -10 concepts/ai-native-life-os.md
# 6. Search across all concepts
grep -r "knowledge graph" --include="*.md" .For a more structured view, use tree to see the bundle's directory structure:
tree -L 3 --gitignoreThis zero-dependency approach works on any system with Git installed, making every OKF bundle viewable without any specialized software.
Frequently Asked Questions
What OKF viewers exist for browsing bundles?
Several OKF viewers exist: BundleDex is the web-based directory with search and filtering; okf-viewer provides a CLI visual interface with knowledge graphs; OKF Harness is a desktop viewer; and any markdown editor (VS Code, Obsidian, Cursor) works as a viewer out of the box. For CLI workflows, Open Knowledge CLI supports reading bundle contents from the terminal.
Can I view OKF files in my code editor?
Yes. OKF bundles are plain markdown files with YAML frontmatter, so any editor that renders markdown works as a viewer. VS Code shows the full directory tree with markdown previews. Obsidian opens bundles as vaults with graph view and backlinks. Cursor and Claude Code can load bundles directly into AI agent context for interactive exploration.
Is BundleDex an OKF viewer?
Yes. BundleDex is the most comprehensive web-based OKF viewer and directory. It indexes over 583 bundles and provides search, filtering by category, star counts, OKF conformance badges, and detailed bundle pages with metadata. It's the best place to discover and explore OKF bundles on the web. Start browsing now.
Do I need a special viewer to read OKF bundles?
No. OKF bundles are directories of markdown files. Any text editor, terminal with cat, or markdown renderer can read them. Dedicated viewers like BundleDex add search, navigation, and discovery features, but they're optional — the format is designed to be readable without any specialized software.
Can I view OKF bundles on my phone?
Yes. BundleDex is a responsive web application that works on mobile browsers. You can browse, search, and explore all 583 indexed bundles from any device. For offline viewing, clone a bundle's GitHub repo and use any mobile markdown reader app.