Get AI-friendly explanation of command error

Get suggested fixes for error

Spawn specialized agent for task

Execute workflow pipeline

Get command history

Read a file with SAGE compression: small files exact, large files as outline + head with line references. Prefer this over cat/type/Get-Content to save context.

Search files with compressed, grouped results (exact paths and line numbers kept). Prefer this over rg/grep when output may be large.

Run a command as an explicit agent tool-call with purpose metadata (tracked for tool-quality metrics).

Recover the exact stored output of a previous run by ID (compression never destroys the original).

Create or update a file. Returns bytes/lines/sha256 confirmation instead of echoing the content back — saves the whole file's tokens. Existing files require overwrite=true (a snapshot is taken first so it is reversible).

Exact string replacement in a file. Returns a compact change preview instead of the whole file, and snapshots the pre-edit content for undo. old must match exactly and be unique unless replace_all=true.

Find files by pattern, newest first, junk directories ignored, capped output. Prefer over recursive directory listings.

Compact depth-limited directory overview instead of ls -R noise.

Run a command with SAGE's agentic loop — auto-retries on failure, applies fixes, verifies. Use instead of sage_run_command when you want automatic error recovery.

Get an auto-fix suggestion for the last failed command. Returns the fix command, strategy, and confidence.

Get the current agentic session state — failure streak, recent errors, intent chain. Useful for understanding context before deciding next action.