Research OS for collective actualization. A holonic-science research knowledge base modeling the architecture of reality from the one-infinite-creator down through all scales — atoms → cells → organisms → civilizations → galaxies — with an AI-agent-facing CLI and MCP server for navigating, validating, and evolving the framework.
HoloOS is a holonic-science research knowledge base. It formalizes the invariant architecture of reality — every holon (atom, cell, person, civilization, galaxy) runs one invariant systems architecture with two metabolic cycles (lesser M·P·C·E + greater S·T·G·Ch) on three substrates (Body/Mind/Spirit ↔ Gross/Subtle/Causal) across seven densities and multiple octaves.
The framework is self-evolving: it runs the same 5-phase optimization protocol on itself that it prescribes for all holons. The R&D process IS a holon.
The lesser-cycle metabolism (Doc 02.1) is the single most undistorted articulation available. Everything in the framework is derived from it; nothing is derived from witnesses. External knowledge (Law of One, developmental psychology, biology, physics, cross-tradition) are witnesses that corroborate — never sources that dictate.
Every holon — including the R&D process itself — runs a 5-phase polarity-balancing protocol (per Doc 08.8.36) that IS the archetype-activation sequence (per Doc 08.8.40):
- Silence (M→P) — validate the target, lower the noise-floor
- Self-Acceptance (C→E) — articulate the claim, run the red-team, keep both thesis + antithesis
- Other-Examination (E→S) — check against corroborating witnesses
- Other-Acceptance (S→T) — incorporate the witness with a structural wrapper doc
- Geometrical-Overview (T→G) — articulate the position in the framework's graph
git clone https://github.com/ishan-parihar/HoloOS.git
cd HoloOS
pip install pyyaml jsonschema inquirer jinja2 networkx
# Orient
python3 _INSTRUMENTS/cli/holos.py docs --lens # The 8-doc Framework Lens
python3 _INSTRUMENTS/cli/holos.py joints stats # 287 open joints across 33 series
python3 _INSTRUMENTS/cli/holos.py theory-docs # 184 docs, 161 with frontmatter
python3 _INSTRUMENTS/cli/holos.py archetypes # The 7×3 archetype grid + the Choice
# R&D workflow
python3 _INSTRUMENTS/cli/holos.py catalyst --intake "Your research question"
python3 _INSTRUMENTS/cli/holos.py optimize --doc 02_Ontology/00.md
python3 _INSTRUMENTS/cli/holos.py catalyst --resolve CAT-0001 --experience "What was learned"
# MCP server (for Claude Desktop, Cursor, or any MCP-aware agent)
python3 _INSTRUMENTS/mcp_server.pyFor AI agents: read AGENTS.md first — it is the complete operational guide.
HoloOS/
├── _THEORY/ ← THE FRAMEWORK (184 docs, 161 with frontmatter)
│ ├── 01_Epistemology/ ← 13 docs — the method
│ ├── 02_Ontology/ ← 98 docs — the models (theses + antitheses only)
│ │ ├── 00.md ← The master overview — READ FIRST
│ │ ├── OPEN_JOINTS.md ← 287 joints across 33 series — the R&D agenda
│ │ └── 08.8.x ← active R&D theses (latest: 08.8.45)
│ ├── 03_Witnesses/ ← 18 docs + 51 raw JSONs — corroborating knowledge
│ │ └── 01_law_of_one/ ← 11 wrapper docs (cosmology, archetypes, disciplines)
│ ├── 04_Applications/ ← 11 docs (civilization assessment, collective patterns)
│ ├── 05_Instrumentation/ ← 15 docs (CLI/MCP/KB design)
│ └── 99_ARCHIVE/ ← 28 docs (stale/superseded/process-artifacts)
├── _CREATION/ ← THE KB: 980-holon schema-6.0 lattice (CO/LO/LiO/SO/GO
│ octaves), `holos validate`-clean, template-only so far
├── _INSTRUMENTS/ ← THE TOOLS (108 CLI subcommands, 35 MCP tools, 59 lib modules)
├── _RESEARCH/ ← Active research (sub-agent syntheses) + worklog.md
├── AGENTS.md ← OPERATIONAL GUIDE for AI agents ← READ THIS
└── README.md ← This file
# Orientation
holos docs --lens # The 8-doc Framework Lens
holos joints stats # R&D agenda summary
holos theory-docs tree # Doc hierarchy
holos archetypes # The 7×3 archetype grid
# R&D workflow
holos catalyst --intake "<desc>" # Record a catalyst + print 5-phase checklist
holos optimize --doc <path> # Run the 5-phase protocol on a doc
holos catalyst --resolve <id> --experience "<text>" # Resolve
# Open-joints kanban
holos joints list --priority HIGH # HIGH-priority open joints
holos joints show J-ARCH-2 # One joint in detail
holos joints tag J-ARCH-2 psychology # Tag a joint
# Theory-docs management
holos theory-docs validate # Validate all docs against the schema
holos theory-docs graph # The typed-edge doc-holon graph
holos theory-docs graph --filter red-team # Thesis/antithesis pairs
# Archetype navigator
holos archetypes show 1 # Full detail for archetype 1 (Matrix of the Mind)
holos archetypes vertical M # 3 complex-specific variants for the Matrix role
holos archetypes protocol # 5-phase → archetype-activation mapping
# KB scaffolding — NOTE: `create-holon` writes the pre-schema-6.0 anatomy
# (_PROFILE.md/_focal/_sub), not the quadrants/evidence/synthesis/ layout the
# live 980-holon lattice uses. For new holons inside CO/LO/LiO/SO/GO, extend
# scaffold_full_kb.py instead until create-holon is ported to schema 6.0.
holos create-holon <slug> --name "<Name>" --type T01 --scale S20 --type-name General-Science --density 3 --parent <path_or_holon_id>python3 _INSTRUMENTS/mcp_server.py # stdio transport (for Claude Desktop)Key tools: holos_joints, holos_theory_docs, holos_archetypes, holos_catalyst,
holos_optimize, holos_docs, holos_theory, holos_lens, holos_stratified_influences,
holos_attractor, holos_archetype, holos_health, holos_ray, holos_lineage,
holos_holograph, and 19 more.
- Ontology: 98 docs (latest R&D thesis: 08.8.45 — R-axis definition unresolved, see AGENTS.md)
- Witnesses: 11 Law-of-One wrapper docs + 51 raw JSONs (cosmology, densities, rays, Higher Self, M/B/S Totality, healing, energy transfers, disciplines of Mind/Body/Spirit, 22 archetypes); the other 4 witness traditions are unpopulated placeholders
- Open joints: 287 across 33 series —
holos joints statsfor the live breakdown - CLI: 108 subcommands
- MCP: 35 tools
- KB: 980-holon schema-6.0 lattice (
CO/LO/LiO/SO/GO),holos validateclean, template-only (next: populate evidence/synthesis/ per holon as R&D findings land)
- Python 3.10+
pyyaml,jsonschema,inquirer,jinja2- (Optional)
networkxfor graph visualization
Read AGENTS.md first. It is the complete operational guide covering: the trusted anchor, the 4-axis coordinate system, the 5-phase protocol, all CLI commands, all MCP tools, the R&D workflow, the epistemological standard, and the standing rules.
HoloOS: The structure is the map. The interior is the territory. The gaps are the research agenda. Derive, don't borrow. Mark the unmodelable.