open source

praxis-echo

Keep the pipeline flowing.

License Version

Pipeline enforcement for AI self-evolution documents. Monitors document health, detects stale thoughts, flags frozen pipelines, and enforces thresholds -- so growth doesn't depend on the agent remembering to grow.

Rust
CLI tool
Open source
Zero dependencies

The growth pipeline

Ideas enter as raw encounters and flow through capture, incubation, crystallization, and integration. praxis-echo makes sure nothing gets stuck along the way.

Encounter
trigger
📚
LEARNING.md
capture
💡
THOUGHTS.md
incubate
💎
REFLECTIONS.md
crystallize
🧹
SELF.md
integrate

Enforce what matters

Six capabilities that keep your document ecosystem healthy and your growth pipeline moving forward.

📈

Pipeline Pulse

Injects document state at session start. Thread counts, staleness warnings, threshold alerts -- all before the first tool call.

praxis-echo pulse

Staleness Detection

Thoughts untouched for 7+ days, questions unresearched for 14+ days. If ideas aren't moving, praxis notices.

7d thoughts / 14d questions
📏

Threshold Enforcement

Soft and hard limits per document. LEARNING.md: 5/8 threads. THOUGHTS.md: 5/10. Overflow triggers archival.

soft + hard limits
🪦

Frozen Pipeline Alerts

No document movement across 3+ sessions? The pipeline is frozen. praxis flags it before stagnation sets in.

3+ session detection
📋

Session Review

Post-session diff compares start vs. end state. Tracks graduations, dissolutions, new threads, and pipeline activity.

praxis-echo review
🔍

Curiosity Nudge

Queue research intents from curiosity. Integrates with n8n to schedule self-initiated exploration.

praxis-echo nudge

What's under the hood

Lean tooling. One binary that reads your documents and tells you the truth about your pipeline.

🦀

Rust

core runtime

Clap

CLI framework

📦

Serde

serialization

🧠

Claude Code

agent framework

Up and running in minutes

Clone, build, initialize. praxis-echo reads your document ecosystem and starts enforcing immediately.

1

Clone and build

git clone https://github.com/dnacenta/praxis-echo.git cd praxis-echo cargo install --path .
2

Initialize

praxis-echo init # Sets up hooks and discovers your document ecosystem
3

Check pipeline

praxis-echo status # Document counts, staleness, thresholds at a glance
4

Deep scan

praxis-echo scan # Full pipeline analysis with actionable recommendations

Part of the echo family

Composable modules for building autonomous AI entities. Each stands alone. Together they form something greater.