Getting Started

Quick Start

git clone https://github.com/YOUR_USER/JanusLM.git
cd JanusLM

Open the repo in any coding agent — each one picks up its own instruction file automatically:

claude       # reads CLAUDE.md
codex        # reads AGENTS.md
gemini       # reads GEMINI.md

Works with Cursor (.cursorrules) and Cline (.clinerules) too.

On the very first prompt, the agent detects that Python dependencies are missing and installs them automatically — no manual setup needed.

Usage

You can talk to the agent in natural language or use shorthand:

ingest raw/report.md                       # add a document to the wiki
query: what does the wiki say about agents?   # ask a question across the KB
health                                     # structural integrity checks
build graph                                # generate the knowledge graph

Or just say what you need:

"Ingest this paper and tag it as ai-strategy"
"What does the wiki say about RAG across all projects?"
"Are there contradictions in project-alpha?"
"Build the graph and tell me what's most connected"

try it

“Ingest raw/report.md and tag it as ai-strategy”

JanusLM is multi-agent by design, optimized for Claude but it works with any coding agent that can read markdown instructions and run Python scripts — the workflows and tools are the same for everyone.

The Python scripts in tools/ can also run standalone from terminal, without a coding agent.

Commands

Everything you can do with JanusLM — via the agent or standalone from terminal.

Knowledge Base

Command	What it does
ingest raw/doc.md	Read a document, extract entities and concepts, create/update wiki pages
query "your question"	Search the wiki and synthesize an answer with citations
health	Structural integrity checks — empty pages, index sync, log coverage, tag validation
heal	Auto-fix issues found by health (creates missing pages, repairs links)
stats	Wiki dashboard — page counts by type, tag distribution, link density
forget	Remove a project, entity, or concept from the wiki (with safety confirmation)
rename tag	Rename a project tag across all wiki pages (frontmatter + sections)
wiki-index	Manage wiki/index.md entries deterministically (add, remove, update descriptions)
wiki-protect	Check or toggle wiki permission flags (can_modify, can_forget, can_anonymize_pii)
wiki-log	Show recent wiki activity — ingest, heal, graph operations with date filtering
wiki-validate	Check domain affinity of a document against a project tag (TF-IDF + entity/concept overlap)
wiki-terms	Extract term frequencies from a document for blind review during ingest
help	Show all capabilities with natural language examples

Knowledge Graph

Command	What it does
build graph	Extract wikilinks, detect communities, generate graph data and analysis report
print graph	Render interactive graph.html from the graph data

File Conversion & Maintenance

Command	What it does
/convert	Convert any non-markdown file to markdown for ingest
/privacy-mode	Enable or disable local PII anonymization (Claude Code only)
/scaffold	Check project structure and recreate any missing directories or scaffold files
/setup	Install or reinstall Python dependencies

All scripts accept --help for full options. Most also support --json for machine-readable output and --save to write results to the wiki.