Skip to content

usage_guide.md

Latest commit

 

History

History
76 lines (62 loc) · 1.55 KB

usage_guide.md

File metadata and controls

76 lines (62 loc) · 1.55 KB

Saguaro Usage Guide

This guide covers the command-line interface (CLI) for Saguaro.

1. Lifecycle Commands

init

Initialize a new Saguaro project. Creates .saguaro/ directory and config.

saguaro init

index

Build or update the holographic knowledge graph.

saguaro index
# Options:
#   --verbose   Show detailed logs
#   --clean     Force full re-indexing

watch

Run in daemon mode, watching for file changes and re-indexing incrementally.

saguaro watch

2. Intelligence Commands

query

Semantic search.

saguaro query "How is user auth handled?"
# Options:
#   --json      Output JSON
#   --k 10      Number of results

agent (SSAI)

Tools for AI perception.

  • skeleton <file>: View structural outline.
  • slice <symbol>: View code implementation with dependencies.
  • impact <sandbox_id>: Predict risk of proposed changes.

simulate

Predictive modeling throughout the codebase.

  • volatility: Heatmap of unstable code regions.
  • regression <file>: Predict regression probability.

3. Governance Commands

verify (The Sentinel)

Check compliance against rules.

saguaro verify .
# Options:
#   --fix       Auto-fix violations
#   --engines   Select engines (native, ruff, semantic)

chronicle

Manage semantic history.

  • snapshot: Save current memory state.
  • diff: Compare current state to last snapshot.

health

System diagnostics.

saguaro health

coverage

AST parsing coverage report.

saguaro coverage