Sypha AI Docs
FeaturesTools

execute_command

Interact directly with your system terminal to manage builds, tests, and environment setups.

execute_command

The execute_command utility enables Sypha to perform essential system-level operations, such as managing dependencies, executing test suites, or initializing development infrastructure.

Parameters

  • command (required): The CLI instruction to be processed.
  • cwd (optional): The working directory for execution (defaults to the workspace root).

Functional Workflow

Commands are processed within a dedicated terminal session managed inside VS Code. You can monitor the real-time stream in the terminal window while Sypha analyzes the logs for critical feedback or successful completion markers.

Common Objectives

  • pnpm install for project initialization.
  • vite build or gcc for compiling assets and binaries.
  • git push or git commit for managing version history.
  • docker-compose up for orchestrating multi-container environments.

Controls & Security

  • Authorized Allowlist: You can pre-approve standard command structures (e.g., git status or npm test) to enable Sypha to work without constant interruption.
  • Command Validation: Sensitive patterns, such as complex subshells or unauthorized backticks, are automatically inspected by Sypha's security engine.
  • High-Autonomy Mode: For maximum efficiency in secure or isolated development zones, you can grant total command approval, significantly boosting task completion speed.

Execution Examples

Initializing a development environment

<execute_command>
  <command>npm run start:dev</command>
</execute_command>

Complex directory and file setup

<execute_command>
  <command>mkdir -p api/v2 && touch api/v2/routes.go</command>
</execute_command>

On this page