Nusus SDK & Agent CLI
An open-source TypeScript SDK and agent CLI for searching and citing classical Islamic and Arabic texts through Turath
- Project type
- npm Package
- Role
- Creator & Maintainer
- Date
- Since July 2026
Overview
Nusus (`nusus` on npm) gives research tools and AI agents a reliable interface to Turath, a Shamela-style digital library. It retrieves source text, metadata, citations, page locators, and direct links without adding interpretation, ranking, or grading logic.
Technology
- TypeScript
- Node.js
- Bun
- Turath API
- JSONL
Key features
- TypeScript SDK for Turath book, author, category, page, search, and context retrieval
- Agent-ready nusus CLI distributed in the same npm package
- Bounded retrieval with match-centered passages and optional adjacent pages
- Citations, source locators, provenance, and direct Turath URLs for every result
- Offline book, author, category, and catalog discovery from a bundled snapshot
- JSONL output for reliable composition with command-line AI agents
Why it was built
- To make classical Islamic and Arabic texts accessible to modern research workflows
- To give AI agents source-grounded retrieval with transparent citations
- To keep retrieval separate from interpretation, madhhab ranking, and hadith grading