LLM Wiki is a cross-platform desktop application that turns your documents into an organized, interlinked knowledge base — automatically. Instead of traditional RAG (retrieve-and-answer from scratch every time), the LLM incrementally builds and maintains a persistent wiki from your sources。
TypeScript
import { createDirectory, fileExists, writeFile } from "@/commands/fs"
import { getFileName, normalizePath } from "@/lib/path-utils"
import { makeQuerySlug } from "@/lib/wiki-filename"
import { inferWikiTypeFromPath } from "@/lib/wiki-page-types"
export function lintLinkTarget(target: string): string {
return normalizePath(target)
.replace(/^wiki\//i, "")
.replace(/\.md$/i, "")
.trim()
}
function normalizedLintLinkTarget(target: string): string {
return lintLinkTarget(target).toLowerCase()
}
function hasWikilinkToTarget(content: string, target: string): boolean {
const normalized = normalizedLintLinkTarget(target)
return Array.from(content.matchAll(/\[\[([^\]|]+?)(?:\|[^\]]+?)?\]\]/g))
.some((match) => normalizedLintLinkTarget(match[1]) === normalized)
}
export function appendWikilink(content: string, target: string): string {
const linkTarget = lintLinkTarget(target)
if (hasWikilinkToTarget(content, linkTarget)) return content
const linkLine = `- [[${linkTarget}]]`
const relatedHeading = /^##\s+Related\s*$/im.exec(content)
if (relatedHeading) {
const insertAt = relatedHeading.index + relatedHeading[0].length
return `${content.slice(0, insertAt)}\n${linkLine}${content.slice(insertAt)}`
}
return `${content.trimEnd()}\n\n## Related\n${linkLine}\n`
}
export function rewriteWikilinkTarget(
content: string,
brokenTarget: string,
suggestedTarget: string,
): string {
const broken = normalizedLintLinkTarget(brokenTarget)
const replacement = lintLinkTarget(suggestedTarget)
return content.replace(
/\[\[([^\]|]+?)(\|[^\]]+?)?\]\]/g,
(match, rawTarget: string, rawAlias?: string) => {
if (normalizedLintLinkTarget(rawTarget) !== broken) return match
return `[[${replacement}${rawAlias ?? ""}]]`
},
)
}
export function stubRelativePathFromBrokenTarget(brokenTarget: string): string {
const normalized = lintLinkTarget(brokenTarget)
const parts = normalized
.split("/")
.map((part) => makeQuerySlug(part))
.filter(Boolean)
const rel = parts.length > 1
? parts.join("/")
: `queries/${parts[0] ?? "missing-page"}`
return `${rel}.md`
}
function stubTitleFromBrokenTarget(brokenTarget: string): string {
return getFileName(lintLinkTarget(brokenTarget))
.replace(/[-_]+/g, " ")
.trim() || "Missing Page"
}
export async function ensureBrokenLinkStub(
projectPath: string,
brokenTarget: string,
): Promise<{ fullPath: string; relativePath: string; created: boolean }> {
const relativePath = stubRelativePathFromBrokenTarget(brokenTarget)
const fullPath = `${projectPath}/wiki/${relativePath}`
if (await fileExists(fullPath)) {
return { fullPath, relativePath, created: false }
}
const parent = fullPath.split("/").slice(0, -1).join("/")
await createDirectory(parent)
const title = stubTitleFromBrokenTarget(brokenTarget)
const date = new Date().toISOString().slice(0, 10)
const pageType = inferWikiTypeFromPath(`wiki/${relativePath}`) ?? "query"
const content = [
"---",
`type: ${pageType}`,
`title: "${title.replace(/"/g, '\\"')}"`,
`created: ${date}`,
`updated: ${date}`,
"tags: [stub, lint]",
"related: []",
"sources: []",
"---",
"",
`# ${title}`,
"",
"Created by Wiki Lint as a placeholder for a missing wikilink target.",
"",
].join("\n")
await writeFile(fullPath, content)
return { fullPath, relativePath, created: true }
}