@talocode/wiki
v0.1.0
Published
Agent knowledge base — ingest, query, and manage a structured wiki of plain Markdown files
Maintainers
Readme
Talocode Wiki
Agent knowledge base — ingest, query, and manage a structured wiki of plain Markdown files.
Talocode Wiki turns any agent into a knowledge-powered assistant. It creates, maintains, and queries a structured knowledge base that persists across sessions.
Features
- Ingest documents, PDFs, web pages, and text into linked knowledge pages
- Query the knowledge base with natural language questions
- Cross-reference and link related concepts automatically
- Hot cache for instant context in new sessions
- Lint the wiki to find contradictions, dead links, and orphans
- Obsidian-compatible — plain Markdown, works with Graph View
Install
# npm
npm install -g @talocode/wiki
# pip
pip install talocode-wikiCLI Usage
# Initialize wiki
wiki init
# Ingest a file
wiki ingest research-paper.pdf
# Query the knowledge base
wiki query "what do you know about AI agents?"
# Check wiki health
wiki lint
# Save conversation
wiki save "Key insights" -c "Important findings from today"SDK Usage
TypeScript
import { WikiClient } from '@talocode/wiki';
const wiki = new WikiClient({ wikiDir: './wiki' });
await wiki.init();
// Ingest content
await wiki.ingest('notes.md', 'Content to remember...');
// Query
const result = await wiki.query('What do we know about X?');
console.log(result.answer);Python
from talocode_wiki import WikiClient
wiki = WikiClient(wiki_dir='./wiki')
wiki.init()
# Ingest content
wiki.ingest('notes.md', 'Content to remember...')
# Query
result = wiki.query('What do we know about X?')
print(result.answer)MCP Integration
Add to your agent config:
{
"mcp": {
"wiki": {
"type": "local",
"command": ["npx", "-y", "@talocode/wiki", "mcp"]
}
}
}Available tools:
wiki_init— Initialize wiki structurewiki_ingest— Ingest content into knowledge basewiki_query— Query with natural languagewiki_lint— Check wiki healthwiki_save— Save content as wiki page
Hosted API
# Ingest
curl -X POST https://api.talocode.site/v1/wiki/ingest \
-H "Authorization: Bearer $TALOCODE_API_KEY" \
-d '{"content": "...", "source": "notes.md"}'
# Query
curl -X POST https://api.talocode.site/v1/wiki/query \
-H "Authorization: Bearer $TALOCODE_API_KEY" \
-d '{"question": "What do you know about AI?"}'API Pricing
| Action | Credits | |--------|---------| | Ingest | 5 | | Query | 3 | | Lint | 2 | | Init | Free |
Wiki Structure
wiki/
├── index.md # Master index
├── hot.md # Recent context cache
├── domains/ # Domain-specific knowledge
├── sources/ # Ingested sources
│ └── <source>/
│ ├── index.md
│ └── pages/
└── links.md # Cross-referencesCommands
| Command | Description |
|---------|-------------|
| wiki init | Initialize wiki structure |
| wiki ingest <file> | Add file to knowledge base |
| wiki query <question> | Search the wiki |
| wiki lint | Check for issues |
| wiki save <title> | Save content as page |
Related Packages
| Package | npm | PyPI |
|---------|-----|------|
| DocuLane | @talocode/doculane | talocode-doculane |
| XSearchLane | @talocode/xsearchlane | talocode-xsearchlane |
| Wiki | @talocode/wiki | talocode-wiki |
License
MIT © Talocode
