Documentation Index
Fetch the complete documentation index at: https://docs.kiwifs.com/llms.txt
Use this file to discover all available pages before exploring further.
Change velocity
Analyze the rate and distribution of changes across your knowledge base over a time period.
Time window. Supports Nd (days), Nw (weeks), Nm (months).
Max number of items in hot/cold spot lists.
Limit analysis to a subdirectory.
curl 'http://localhost:3333/api/kiwi/velocity?period=14d&limit=5'
{
"period": "14d",
"total_changes": 87,
"hot_spots": [
{"path": "concepts/auth.md", "changes": 12},
{"path": "runbooks/deploy.md", "changes": 9}
],
"cold_spots": [
{"path": "concepts/legacy.md", "changes": 0, "days_since_update": 120}
],
"bursts": [
{"date": "2026-04-28", "changes": 23, "actor": "agent:importer"}
],
"single_author_pages": 14
}
Total commits in the period.
Most frequently changed pages.
Least recently changed pages.
Days with unusually high change counts.
Pages with only one contributor.
Use velocity data to identify knowledge that’s churning (hot spots may need stabilization) and knowledge that’s stale (cold spots may need review).
Graph analytics
Structural analysis of the wiki-link graph using PageRank and connectivity metrics.
GET /api/kiwi/graph/analytics
Number of top pages to return.
curl 'http://localhost:3333/api/kiwi/graph/analytics?limit=10'
{
"total_nodes": 142,
"total_edges": 387,
"components": 3,
"largest_component_size": 138,
"orphans": ["concepts/legacy.md", "scratch/notes.md"],
"top_pages": [
{"path": "concepts/auth.md", "pagerank": 0.042, "in_degree": 18, "out_degree": 5},
{"path": "concepts/users.md", "pagerank": 0.038, "in_degree": 15, "out_degree": 8}
]
}
Total pages in the graph.
Total wiki-link connections.
Number of disconnected subgraphs.
Pages in the largest connected component.
Pages with no incoming or outgoing links.
Highest PageRank pages with degree counts.
503 if the link indexer is not available.
Suggestions
Get semantically similar pages for a given page, useful for “related pages” features and discovering missing links.
GET /api/kiwi/suggestions
File path to find suggestions for.
Max suggestions to return.
curl 'http://localhost:3333/api/kiwi/suggestions?path=concepts/auth.md&limit=3'
{
"suggestions": [
{"target": "concepts/api-keys.md", "similarity": 0.89, "snippet": "API key authentication..."},
{"target": "concepts/sessions.md", "similarity": 0.84, "snippet": "Session management..."}
]
}
Embeddings
Retrieve the raw embedding vectors for a page’s chunks.
File path to retrieve embeddings for.
curl 'http://localhost:3333/api/kiwi/embeddings?path=concepts/auth.md'
{
"path": "concepts/auth.md",
"dimensions": 768,
"chunks": [
{"chunk_idx": 0, "text": "# Authentication\n\nOAuth2...", "vector": [0.012, -0.034, ...]},
{"chunk_idx": 1, "text": "## Refresh tokens\n\n...", "vector": [0.008, 0.021, ...]}
]
}
503 if vector search is not enabled.
Search evaluation
Benchmark your search quality against expected results.
curl -X POST 'http://localhost:3333/api/kiwi/eval' \
-H "Content-Type: application/json" \
-d '{
"queries": [
{"question": "how does authentication work", "expected_paths": ["concepts/auth.md"]},
{"question": "deploy checklist", "expected_paths": ["runbooks/deploy.md"]}
]
}'
{
"fts": {"hit_rate": 1.0, "mrr": 0.75, "precision_at_5": 0.6},
"semantic": {"hit_rate": 1.0, "mrr": 0.9, "precision_at_5": 0.8},
"per_query": [
{"question": "how does authentication work", "fts_rank": 2, "semantic_rank": 1}
]
}
Fraction of queries where the expected page appeared in top-5.
Mean Reciprocal Rank across all queries.
Average precision in the top-5 results.
