Tools

The 4-tool API for persistent AI memory.

Synthesis provides 4 tools that your AI assistant can call to manage project context and knowledge.

Available Tools

synthesis_start

Load project context at session start. Returns current state, next steps, blockers, and relevant lessons.

Parameters:

• query (string): Project name, path, or description to search for
• register_if_new (boolean): Create project if not found

synthesis_checkpoint

Save progress after meaningful work. Updates context and creates a work log entry.

Parameters:

• project_id (string): Project ID from synthesis_start
• summary (string): Brief summary of what was accomplished
• files_changed (string[]): List of modified files
• completed_steps (number[]): Indices of completed Next Steps

synthesis_lesson

Capture reusable knowledge when you solve a problem or discover a technique.

Parameters:

• project_id (string): Project ID
• type ("incident" | "pattern"): Type of lesson
• title (string): Short title
• what_happened (string): Problem or context
• solution (string): How it was solved

synthesis_search

Search past lessons when stuck or facing a familiar error.

Parameters:

• keywords (string[]): Keywords to search for
• error_message (string): Specific error message

When to Use Each Tool