krypperx/krypper

How krypperx/krypper works

Krypper is an offline-first Rust CLI and in-process task runtime. Users can inspect, list, and create workspace files directly, or run a bounded task: provide decisions interactively or opt into a local model, perform safe workspace actions, and continue, complete, cancel, or checkpoint and resume. The graph also shows task/turn history and checkpoint persistence, plus recursive search. Some subsystem links rely on the SOURCE INDEX or README rather than fully sampled implementations; those evidence limits are reflected by omitting uncertain connections.

Main entry points: cli.rs Command Handler · execution.rs Turn Execution · lifecycle.rs Task Lifecycle · workspace_safety.rs Safe File Operations

Components 18

CLI Interface

Command Handler src/cli.rs
Direct File Commands src/cli.rs

Task Runtime

Turn Execution src/harness/execution.rs
Prompt Context src/harness/context.rs
Task Recovery src/harness/recovery.rs
Turn Verification src/harness/verification.rs
Task Lifecycle src/core/lifecycle.rs
Task State Model src/core/task.rs
Checkpoint Storage src/core/lifecycle/checkpoint.rs

Decision Sources

Decision Interface src/agent_loop.rs
Model Providers src/brain/providers.rs
Model Adapter src/brain/mod.rs

Workspace Operations

Action Registry src/tools/registry.rs
Safe File Operations src/tools/workspace_safety.rs
Recursive Search src/tools/workspace_safety/search.rs

Other components

CLI User
Local Workspace
Local Ollama

Connections 26

CLI User → Command Handler: runs commands README.md
Command Handler → Direct File Commands: dispatches file commands README.md
Command Handler → Turn Execution: starts task turns src/cli.rs
Command Handler → Task Recovery: resumes tasks src/cli.rs
Command Handler → Turn Verification: verifies turns src/cli.rs
Command Handler → Task Lifecycle: manages task state src/cli.rs
Command Handler → Checkpoint Storage: saves or restores README.md
Command Handler → Decision Interface: selects decision source src/cli.rs
Turn Execution → Decision Interface: requests decisions src/agent_loop.rs
Turn Execution → Prompt Context: builds task context src/harness/context.rs
Turn Execution → Task Lifecycle: records turn activity src/harness/execution.rs
Turn Execution → Safe File Operations: executes workspace actions
Task Lifecycle → Task State Model: tracks task transitions src/core/lifecycle.rs
Task Lifecycle → Safe File Operations: performs safe file operations src/core/lifecycle.rs
Task Lifecycle → Checkpoint Storage: serializes session state src/core/lifecycle/checkpoint.rs
Model Adapter → Model Providers: adapts provider calls src/brain/mod.rs
Model Adapter → Action Registry: declares model actions src/brain/mod.rs
Model Adapter → Prompt Context: builds model prompt src/brain/mod.rs
Model Providers → Local Ollama: sends local requests
Decision Interface → Model Adapter: uses model decisions src/brain/mod.rs
Action Registry → Safe File Operations: defines supported actions
Direct File Commands → Local Workspace: reads or writes files README.md
Safe File Operations → Local Workspace: reads and modifies
Safe File Operations → Recursive Search: delegates recursive search src/tools/workspace_safety.rs
Recursive Search → Local Workspace: searches files README.md
Turn Execution → Local Workspace: returns action observations

Drawn by GitDiagram on November 15, 2026 from the repository's file tree, README and source files. Read as Markdown ·