Skip to content
leslesliePublic

About

Meta-project for the Bodai ecosystem — configuration, documentation, and operations across all components

Resources

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

Bodai - The Orb

Code style: crackerjack Runtime: oneiric uv Python: 3.14+

Central meta-project for the Bodai ecosystem, providing configuration, documentation, and operations for all components.

ORB: Orchestrated Reasoning Brain

Perceive. Reason. Orchestrate.

Etymology: From Sanskrit bodhi (awakening, enlightenment) - the state of supreme understanding.

About the Bodai Ecosystem

Bodai (Sanskrit: bodhi, "awakening") is the meta-project that ties together:

  • mahavishnu — Multi-repo workflow orchestration and worker pools
  • akosha — Cross-system intelligence, embeddings, semantic search
  • dhara — Persistent object storage with ACID transactions
  • session-buddy — Session lifecycle and knowledge graphs
  • crackerjack — Quality gates and CI/CD validation
  • oneiric — Component resolution and runtime foundation

When run together, these components form the Bodai Orb (Orchestrated Reasoning Brain) — an integrated development environment for AI-native engineering. Each component is also fully usable on its own.

ORB: Orchestrated Reasoning Brain

Perceive. Reason. Orchestrate.

Quick Links

Quality & CI

Crackerjack is the Bodai ecosystem's standard quality-control and CI/CD runner. Repo-level quality gates should align with Crackerjack workflows unless a repo documents an exception.

Ecosystem Components

The Bodai ecosystem consists of six interconnected components, each with a distinct role. Five are network services with MCP servers, while Oneiric serves as a shared library.

Component Role Port GitHub Description
Mahavishnu Orchestrator 8680 lesleslie/mahavishnu Multi-engine workflow orchestration
Akosha Seer 8682 lesleslie/akosha Cross-system intelligence & vector embeddings
Dhara Curator 8683 lesleslie/dhara Persistent object storage with ACID
Session-Buddy Builder 8678 lesleslie/session-buddy Session lifecycle & knowledge graphs
Crackerjack Inspector 8676 lesleslie/crackerjack Quality gates & CI/CD validation
Oneiric Foundation N/A lesleslie/oneiric Component resolution, lifecycle management, adapter system, action kits, domain bridges, runtime orchestration, remote delivery

Mahavishnu - The Orchestrator

From Sanskrit maha (great) + Vishnu (the preserver in Hindu trinity)

The central workflow engine that routes tasks to appropriate execution engines, coordinates multi-step processes across components, and manages workflow definitions and templates.

  • Routes tasks to Akosha for intelligence operations
  • Persists state to Dhara for recovery
  • Tracks context in Session-Buddy
  • Validates with Crackerjack before execution

Akosha - The Seer

From Sanskrit akasha (sky, ether, space) - the fifth element, medium of consciousness

Provides cross-system intelligence through vector embeddings, semantic search, pattern detection, and knowledge graphs. Enables predictive analysis and recommendations across all sessions.

  • Receives session data from Session-Buddy for embedding
  • Stores patterns in Dhara
  • Provides intelligence to Mahavishnu
  • Receives code analysis from Crackerjack

Dhara - The Curator

From Sanskrit dhara (firm, constant, unchanging) - also the Pole Star

The single source of truth for persistent data. Provides ACID transaction guarantees, data versioning, backup/recovery, and efficient querying.

  • Stores state for Mahavishnu
  • Persists patterns for Akosha
  • Backs up sessions for Session-Buddy
  • Stores quality reports for Crackerjack

Session-Buddy - The Builder

The session lifecycle manager that tracks conversation history, builds knowledge graphs, and enables context switching between sessions.

  • Sends data to Akosha for embedding
  • Stores backups in Dhara
  • Provides context to Mahavishnu
  • Receives quality metrics from Crackerjack

Crackerjack - The Inspector

The quality enforcer that runs automated test suites, manages CI/CD pipelines, provides code analysis and linting, and tracks quality metrics over time.

  • Validates workflows for Mahavishnu
  • Sends code analysis to Akosha
  • Stores reports in Dhara
  • Records metrics in Session-Buddy

Oneiric - The Foundation

From Greek oneiros (dream) - relating to dreams, the abstract and complex

The platform foundation library that provides explainable component resolution, lifecycle management, an adapter system spanning 18+ domains, action kits for automation, domain bridges (services/tasks/events/workflows), runtime orchestration, and remote delivery via signed manifests. Every other Bodai component builds on top of Oneiric's patterns.

  • Used by Mahavishnu for layered configuration and lifecycle management
  • Used by mcp-common as the Oneiric-native foundation for all MCP servers
  • Used by Dhara for configuration, logging, and secrets management
  • Used by Session-Buddy for storage adapters, configuration, and lifecycle
  • Used by Crackerjack for runtime orchestration and health snapshots
  • Used by Akosha for universal storage abstraction and adapter resolution

Installation

uv sync

Commands

Bodai provides a unified CLI for managing the ecosystem:

Command Description
bodai health Check health status of all ecosystem components
bodai start Start all ecosystem services
bodai stop Stop all ecosystem services
bodai restart Restart all ecosystem services
bodai dashboard Launch the interactive monitoring dashboard
bodai shell Open an interactive management shell
bodai config show Display current configuration
bodai config validate Validate configuration files

Shell

bodai shell opens an IPython REPL pre-loaded with the Bodai ecosystem context. The shell is the most direct way to inspect and poke at the running components from the terminal:

bodai shell

The following names are pre-loaded in the IPython namespace:

  • Config objects: ecosystem, portmap, storage_map.
  • Config loaders: load_ecosystem(), load_portmap(), load_storage_map().
  • Health probes: check_all() (returns per-component health), check_component("mahavishnu") (probes a single component).
  • Models: Component, Ecosystem.
  • Per-component variables: every registered component name (e.g. mahavishnu, akosha, session-buddy, crackerjack) is bound to its Component instance — mahavishnu.port / akosha.health_url() etc. work directly from the prompt.

The shell requires ipython; if the import fails the CLI prints the installer hint and exits 1 (no silent fallback):

uv pip install 'bodai[shell]'   # installs the ipython + textual extras

See .claude/decisions/2026-08-25-bodai-tui-contract.md for the AdminShell reuse pattern that bodai builds on.

TUI Dashboard

bodai dashboard opens a Textual TUI showing every registered ecosystem component in a single grid. It is the cross-component aggregator surface — see .claude/decisions/2026-08-25-bodai-tui-contract.md.

bodai dashboard
  • Press r to reload all component health data.
  • Press q to quit.
  • The grid refreshes when you press r; it does not auto-poll (the underlying check_all() is a one-shot snapshot today — auto-refresh is a Plan B future).

The dashboard requires textual; if the import fails the CLI prints the installer hint and exits 1:

uv pip install 'bodai[shell]'   # installs the ipython + textual extras

The bodai dashboard surface complements mahavishnu monitor watch (component-internal vs cross-component split — see the TUI contract decision doc).

Architecture

For detailed architecture documentation, see docs/architecture.md.

Development

Running Tests

pytest

Quality Checks

crackerjack run

Related Documentation

Claude Code marketplace

The five Bodai MCP-server plugins are distributed via the bodai-plugins marketplace:

claude plugin marketplace add https://github.com/lesleslie/bodai-plugins
claude plugin install mahavishnu
claude plugin install session-buddy
claude plugin install crackerjack
claude plugin install akosha
claude plugin install dhara

Each plugin ships its own slash commands under the <server>:<command> namespace (e.g. /mahavishnu:status, /session-buddy:checkpoint).

About

Meta-project for the Bodai ecosystem — configuration, documentation, and operations across all components

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages