Knowledge Base

The Knowledge Base is your workspace's central repository for documentation, standard operating procedures, playbooks, and team knowledge. With AI-powered semantic search, finding information is fast and intuitive.

What Is the Knowledge Base?

Think of the Knowledge Base as your team's internal wiki:

Document everything — SOPs, meeting notes, project docs, and more
Find instantly — AI-powered search understands meaning, not just keywords
Stay organized — Use scopes and tags to categorize content
Import existing docs — Sync from GitHub or import markdown files

Creating Documents

Quick Create

Navigate to Knowledge Base in the sidebar
Click New Document
Enter a title
Select a scope (see below)
Click Create

You'll be taken to the document editor to start writing.

Document Scopes

Every document has a scope that determines visibility:

Scope	Visibility	Best For
Workspace	Everyone in the workspace	Company policies, general docs
Team	Specific team members	Department SOPs, team playbooks
Project	Project members only	Project specs, technical docs

Scope is set when creating a document and can be changed later from the document settings.

The Document Editor

Leenops uses a rich text editor (Tiptap) with support for:

Feature	How to Use
Headings	Type `#` for H1, `##` for H2, etc.
Bold/Italic	Select text and use toolbar or Cmd+B / Cmd+I
Lists	Type `-` or `1.` at the start of a line
Tables	Use the table button in the toolbar
Links	Select text and press Cmd+K
Code blocks	Use triple backticks ```

AI-Powered Search

The Knowledge Base features hybrid semantic search that combines three search techniques for the best results.

How It Works

Technique	What It Does	Example
Vector Search	Finds conceptually similar content using AI embeddings	Searching "onboarding" finds "new hire process"
Full-Text Search	Matches exact words and phrases	Finds documents containing exact terms
Fuzzy Search	Catches typos and partial matches	"recieve" matches "receive"

Results are combined using Reciprocal Rank Fusion to surface the most relevant documents.

Using Search

Type in the search bar (top of Knowledge Base page)
When you enter 3+ characters, AI search activates automatically
Results update in real-time as you type
An "AI Search" indicator appears when semantic search is active

Search understands natural language. Try asking questions like "How do I reset my password?" instead of just keyword searches.

Search by Scope

Use the scope tabs to filter documents:

All — Search across all scopes
Workspace — Only workspace-level documents
Teams — Team-scoped documents you have access to
Projects — Project documents for your projects

Organizing with Tags

Tags help categorize and filter documents:

Viewing Tags

Available tags appear below the scope tabs. Click a tag to filter documents.

Common Tag Patterns

Tag Type	Examples
Department	`sales`, `engineering`, `hr`
Document Type	`sop`, `playbook`, `meeting-notes`
Status	`draft`, `approved`, `archived`
Topic	`onboarding`, `security`, `api`

Tags are workspace-wide. Anyone can create tags by typing them when editing a document.

Import from GitHub

Already have documentation in GitHub? Import it directly into the Knowledge Base.

Prerequisites

A GitHub account with access to your repositories
Repositories containing markdown (.md) files

Connecting GitHub

Go to Knowledge Base
Click the ... (more options) menu
Select Import from GitHub
Complete the OAuth flow with GitHub
Grant repository access permissions

Selecting Repositories and Files

After connecting:

Select the repository to import from
Choose the branch (usually main or master)
Select specific folders or files
Choose import options:
- Import as workspace docs — Available to everyone
- Import as personal docs — Private to you

How Sync Works

Documents are imported via the sync-github-docs edge function:

Markdown files are converted to Knowledge Base documents
Frontmatter (YAML headers) is preserved as metadata
File structure becomes document tags

The initial import is one-way. Changes made in Leenops don't sync back to GitHub. To re-sync after GitHub changes, you'll need to re-import.

Troubleshooting GitHub Import

Issue	Solution
Private repos not appearing	Ensure you've granted access to private repositories during OAuth
Files not importing	Only `.md` and `.mdx` files are supported. Check file extensions.
Formatting looks wrong	Complex GitHub-flavored markdown may need manual cleanup after import

Start with a clear title — Use descriptive, searchable titles
Add a table of contents — For longer documents, include TOC
Use headings liberally — Makes scanning and linking easier
Tag appropriately — Helps with discovery and filtering
Choose the right scope — Don't over-share sensitive docs

Document Lifecycle

Stage	Action
Draft	Create with personal or team scope, tag as `draft`
Review	Share with stakeholders for feedback
Publish	Move to workspace scope, remove `draft` tag
Maintain	Update as processes change
Archive	Tag as `archived` when deprecated

Keyboard Shortcuts

Shortcut	Action
Cmd+K	Search from anywhere
Cmd+N	New document
Cmd+S	Save document
Esc	Close document and return to list

Next Steps

GitHub Sync — Detailed guide to GitHub integration
AI Assistant — Use AI to search and create content