aleph

name	aleph
description	/aleph - External memory workflow for large local data.

/aleph - External Memory Workflow

Core rule: keep whole contexts out of the prompt. Return only focused slices or compact derived results.

This plugin bundles the Aleph MCP launcher, /aleph skill, aleph-expert agent, and an install-check hook. It assumes the aleph executable is already installed and available on PATH.

Note: tool names may appear as mcp__aleph__load_workspace_manifest in some clients.

The 5-Phase Loop

1. Load

Pick the correct front door:

• Large repo or codebase: load_workspace_manifest(...)
• Single large file: load_file(...)
• Inline or generated content: load_context(...)

Repo-scale default:

load_workspace_manifest(paths=["src", "tests"], context_id="repo")
rg_search(
  pattern="FastAPI|APIRouter|router\\.",
  paths=["src", "tests"],
  load_context_id="routes"
)
load_file(path="pyproject.toml", context_id="pyproject")

Single-file default:

load_file(path="/absolute/path/to/large.log", context_id="log")
search_context(pattern="ERROR|WARN", context_id="log")
peek_context(context_id="log", start=1, end=60, unit="lines")

Do not start repo work by reading files one by one when load_workspace_manifest(...) is the right first move.

2. Orient

• Use search_context(...) to find relevant regions
• Use peek_context(...) to inspect small ranges
• Use semantic_search(...) for meaning-based lookup
• Use when navigability matters