Sypha AI Docs
FeaturesTools

Agentic Tool System Overview

Sypha's integrated toolset enables the AI to interact directly with your local project and machine.

Agentic Tool System Overview

Sypha utilizes a sophisticated "Agentic" architecture. Unlike a typical chatbot, Sypha can actively engage with your local development environment - performing actions such as reading source code, executing terminal instructions, or controlling a web browser.

Tool Categorization

Utilities are partitioned into logical groups, with availability determined by your active Mode.

CategoryUtilitiesObjective
Researchread_file, list_files, search_filesExploring and analyzing project architecture.
Modificationapply_diff, write_to_file, delete_fileEditing code and managing file hierarchies.
Systemexecute_commandRunning test suites, builds, and custom scripts.
Webbrowser_actionAutomated UI testing and web-resident tasks.
Automationnew_task, switch_mode, update_todo_listCoordinating complex, multi-stage project flows.

Interaction Workflow

  1. Decision Analysis: Sypha interprets your prompt and identifies the most efficient tool for the objective.
  2. Action Proposal: A request appears in the chat window, detailing the proposed operation (e.g., "Sypha intends to execute npm run build").
  3. User Confirmation: You can inspect the specific parameters and either Authorize or Deny the request.
  4. Execution and Feedback: Once permitted, Sypha executes the tool and incorporates the results (logs, content, or screenshots) into its reasoning.

Autonomous Operation (YOLO Mode)

Accelerate your development cycle by enabling auto-approval for specific toolsets or command patterns within the Auto-Approve settings. This allows Sypha to process trusted operations without constant manual oversight.

Security Controls

All operations are executed locally within your designated VS Code workspace. Sypha strictly adheres to your .gitignore and .syphaignore protocols to ensure it never interacts with sensitive data you designate as private.

On this page