v0.5.2 - Latest Release

All your knowledge.
One place.

Stop losing documentation in Notion, Google Docs, and scattered README files.
Unify everything. Navigate with AI.

Open source. Works offline. No account needed.

terminal
$ kp init my-project

β†’ Creating Knowledge Pack: my-project
  β€’ Language: English

βœ“ Knowledge Pack created successfully!

$ kp validate
βœ“ Pack is valid (8 files checked)

Why Knowledge Pack?

Finally, a home for all your project knowledge.

πŸ“¦

Everything in One Place

APIs, guides, specs, decisions β€” all connected in a structured, searchable pack.

πŸ”—

Connected Knowledge

Documents link to each other with semantic relationships. Never lose context again.

πŸ€–

AI-Ready

AI agents navigate your knowledge with full context β€” no more copying and pasting.

πŸ“

Plain Markdown

No vendor lock-in. Your docs are plain text files. Works with any editor.

✍️

Writing Guidelines

Define your style rules. AI follows YOUR standards when contributing docs.

🌐

Works Offline

No cloud required. Everything runs locally. Your knowledge stays with you.

Start in 30 seconds

One command. No signup. No config.

macOS / Linux
curl -fsSL https://kpack.dev/install.sh | bash
Windows (PowerShell)
iwr -useb https://kpack.dev/install.ps1 | iex

Then run kp init my-project to create your first pack

Powerful CLI

Everything you need to manage your knowledge.

kp init Create a new Knowledge Pack
kp serve Browse your docs in the browser
kp validate Check structure and links
kp search Find anything in your pack
kp bundle Export for AI context windows
kp lint Check style and writing guidelines
kp transfer Import docs from external sources
kp profile Manage writing style profiles
kp describe AI-optimized pack description

For Any Kind of Project

Software, books, companies, research β€” organize any knowledge.

Your Knowledge, Your Way

Whether you're documenting an API, writing a book, or building a company wiki β€” Knowledge Pack gives you a consistent structure that scales from personal notes to enterprise documentation.

πŸ’»

Software Projects

API docs, architecture decisions, guides β€” all versioned with your code.

πŸ“š

Books & Creative Work

Characters, worldbuilding, chapters β€” connected with relationships.

🏒

Company Knowledge

Processes, onboarding, runbooks β€” tribal knowledge that never gets lost.

🧠

Personal Notes

Ideas, research, references β€” linked with semantic relationships.

Example Structure

my-knowledge-pack/
β”œβ”€β”€ manifest.yaml      ← Identity & writing rules
β”œβ”€β”€ README.md          ← Entry point
β”œβ”€β”€ docs/
β”‚   β”œβ”€β”€ concepts/      ← Core ideas
β”‚   β”œβ”€β”€ guides/        ← Step-by-step
β”‚   β”œβ”€β”€ api/           ← Reference
β”‚   └── decisions/     ← Why we chose X
└── index/
    β”œβ”€β”€ topics.yaml    ← What exists
    β”œβ”€β”€ glossary.yaml  ← Key terms
    └── relations.yaml ← How things connect
kp context auth --area backend Filter by area

βœ… Use Monorepo When:

  • β€’ Multiple related areas (API, frontend, backend)
  • β€’ Need unified search & context
  • β€’ Share concepts between teams
  • β€’ Single organization/product

❌ Use Multi-Repo When:

  • β€’ Completely independent projects
  • β€’ Separate teams with different cycles
  • β€’ Need granular access control
  • β€’ Different products/audiences

Best Practices

Proven patterns for effective AI-native documentation.

1

Keep START_HERE.md Updated

This is the AI's entry point. Make sure it provides a clear overview and navigation hints for the most important topics. Think of it as the "README for AI" - concise but comprehensive enough to understand your knowledge structure.

Example: Include key concepts, document types, and where to find critical information.
2

Use Descriptive Frontmatter

The description field in frontmatter appears in bundle summaries. Write it like an abstractβ€”concise but informative. This is what AI reads first when deciding if a document is relevant.

---
title: JWT Authentication
description: OAuth 2.0 JWT implementation with refresh tokens and role-based access control
topics: [auth, security, backend]
confidence: stable
---
3

Maintain the Glossary

Organization-specific terms belong in index/glossary.yaml. This prevents AI from misinterpreting your jargon and ensures consistent understanding across all documents.

βœ“ Good

Define: "PVC", "mesh", "tenant", custom acronyms

βœ— Skip

Common terms: "API", "JWT", "Docker"

4

Set Confidence Levels

Mark documents as stable, review, or draft. AI can then weight responses appropriatelyβ€”relying more on stable docs and flagging drafts as tentative.

stable: Production-ready review: Needs validation draft: Work in progress
5

Validate Before Committing

Add kp validate --strict to your CI pipeline to catch structural issues before they reach main. This ensures your knowledge pack remains AI-readable and prevents broken references.

# .github/workflows/validate.yml
- name: Validate Knowledge Pack
  run: kp validate --strict
6

Use Areas for Large Projects

In index/topics.yaml, define areas like api, frontend, backend to organize topics. Then use --area flags to filter context by domain.

kp stats --area api kp context auth --area backend

What's New

See all updates and improvements to Knowledge Pack

View Full Changelog

Ready to start?

Create your first Knowledge Pack in under a minute.