Skip to content

indigokarasu/elephas

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐘 Elephas

Long-term memory — the sole writer to Chronicle, the authoritative knowledge graph.

Why Elephas?

In a system that generates signals from 26+ skills, you need a single source of truth. Elephas is that source. It ingests structured signals from every skill's journals, Memory files, and session logs, scores candidate facts for confidence, resolves identity across duplicates, and promotes what survives into Chronicle as durable facts with full provenance.

Skill packages follow the agentskills.io open standard and are compatible with OpenClaw, Hermes Agent, Claude, and any agentskills.io-compliant client.

Quick Start

# Query Chronicle
"What do I know about Anthropic?"

# Check pending candidates
"What facts are waiting to be promoted?"

Elephas auto-initializes on first use, registering cron jobs for ingestion and consolidation.

What It Does

Every other skill in OCAS generates signals. Elephas makes those signals permanent. It ingests from all skill journals, Memory files, and session logs. It scores confidence, evaluates user relevance, resolves identity across potential duplicates, and promotes to Chronicle. As the sole writer, Elephas is the single source of truth for long-term world knowledge.

Commands

Command Description
elephas.ingest.journals Ingest signals from skill journal files
elephas.ingest.memory Extract knowledge from Memory files
elephas.ingest.sessions Extract knowledge from session transcripts
elephas.consolidate.immediate Score candidates, promote above threshold
elephas.consolidate.deep Full ingestion, identity reconciliation, inference
elephas.identity.resolve Check if two records are the same entity
elephas.identity.merge Merge confirmed-same records (reversible)
elephas.candidates.list List pending candidates
elephas.candidates.promote Manually promote a candidate
elephas.candidates.reject Reject a candidate with reason
elephas.query Query Chronicle
elephas.status Chronicle health and counts
elephas.journal Write journal
elephas.update Self-update

Dependencies

  • All skills — ingests journals from all
  • Bower — Drive artifact signals
  • Weave — cross-DB social graph queries
  • Mentor — reads Chronicle for evaluation
  • LadybugDB (embedded graph database, auto-created)

Scheduled Tasks

Job Schedule Command
elephas:ingest Every 15 min Ingest + immediate consolidation
elephas:deep 0 4 * * * Full identity reconciliation + cleanup
elephas:update 0 0 * * * Self-update

Changelog

v3.2.10 — April 26, 2026

  • Version alignment per publishing spec

v3.1.0 — April 3, 2026

  • Signal format normalization layer, resolves 9,009 rejected signals

v3.0.0 — April 2, 2026

  • Memory file ingestion, session log ingestion, user relevance model

Elephas is part of the OCAS Agent Suite.

About

Elephas: long-term memory — sole writer to Chronicle, the authoritative knowledge graph for all confirmed facts.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors