power-framework GitHub Details, Stars and Alternatives | OpenRepoFinder
weby-homelab / repository
power-framework
Validate, index, search, and manage your knowledge base from the command line — or let AI agents do it through MCP. Built for knowledge workers who want machine-readable notes, automated quality checks, and token-efficient AI access to their Second Brain
A transparent discovery signal based on current public GitHub metadata.
Recent activity35% weight
100
Community adoption25% weight
16
Maintenance state20% weight
40
License clarity10% weight
100
Project information10% weight
100
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
README preview
P.O.W.E.R. — AI-Native Toolkit for Second Brain
Validate, index, search, and manage your knowledge base from the command line — or let AI agents do it through MCP. Built for knowledge workers who want machine-readable notes, automated quality checks, and token-efficient AI access to their Second Brain.
About P.O.W.E.R. - Hybrid Knowledge Management Framework
P.O.W.E.R. is a hybrid system built to bridge the gap between human workflows, automated scripts, and LLM-based autonomous agents. The name is an acronym representing its core components: P.A.R.A., OKF, Wiki, and Execution Rules. It integrates these distinct architectural frameworks to construct a coherent, self-validating, and token-efficient Second Brain.
Why P.O.W.E.R.?
Unlike generic knowledge management tools, P.O.W.E.R. is designed from the ground up for AI-first knowledge management:
AI-native metadata — Pydantic v2 schemas enforce strict OKF frontmatter, so every note is machine-readable; includes governance fields (owner, status, expiry) and Graph RAG links ()
related
Token-efficient indexing — hierarchical index.md + per-folder _index.md cuts AI agent context usage by ~75%
Knowledge Graph — related field connects notes across the vault; visualized in sub-indexes for Graph RAG workflows
Freshness Monitoring — linter detects stale/expired notes based on expiry metadata field
pip install git+https://github.com/weby-homelab/power-framework.git@v3.0.0
power init ~/my-vault # Create vault structure
power lint ~/my-vault # Check for broken links & missing metadata
power index ~/my-vault # Generate catalog index.md
power heal ~/my-vault # Auto-fix missing/invalid frontmatter
power markdown-check ~/my-vault # Check markdown quality issues
Development Install (editable + easy update)
For a permanent, always-updatable CLI on your workstation (WS), install in
editable mode from a local clone. This binds power to the repo so code
changes take effect immediately — no reinstall needed.
# 1. Clone once
git clone https://github.com/weby-homelab/power-framework.git /tmp/power-framework
cd /tmp/power-framework
# 2. Editable install into user-site (survives reboots, no venv required)
pip install --user --break-system-packages -e ".[dev]"
# 3. Verify — `power` is now on PATH (via ~/.local/bin)
power --version
Update to the latest code anytime with:
cd /tmp/power-framework && git pull origin main && power --version
# If pyproject.toml changed (new deps/version), reinstall:
pip install --user --break-system-packages -e ".[dev]"
💡 One-liner updater. Save this as /root/.local/bin/power-update and
chmod +x it, then just run power-update to pull + reinstall automatically:
#!/usr/bin/env bash
set -euo pipefail
REPO="/tmp/power-framework"
cd "$REPO"
git fetch origin main && git reset --hard origin/main
if git diff --name-only HEAD@{1} HEAD | grep -q pyproject.toml; then
pip install --user --break-system-packages -e ".[dev]" >/dev/null 2>&1
fi
power --version
What's Inside
Feature
What it does
CLI
power init, lint, index, ingest, search, rot, status, archive, cron, heal, markdown-check, suggest-related — 12 commands for full vault management
MCP Server
Exposes lint_vault, generate_index, read_sub_index, ensure_sub_index, ingest_note, search_vault_tool, synthesize_session, rot_audit, archive_notes, suggest_related_tool, heal_frontmatter_tool, check_markdown_tool — 12 tools for AI agents
OKF Validation
Pydantic v2 schemas enforce strict metadata on every note with governance (owner, status, expiry)
Knowledge Graph (Graph RAG)
related field in OKF frontmatter supporting TypedRelation (path, relation, confidence) with BFS traversal and Mermaid diagram export (to_mermaid)
Freshness Monitoring
Linter flags stale/expired notes by checking expiry dates, ensuring your vault stays current
Agent Auto-Ingest
synthesize_session MCP tool — agents autonomously create permanent notes with governance + graph links + full i
