List files and directories in the repository.

Args: directory: Relative subfolder inside the repository (empty string for root). recursive: Whether to list recursively through child directories (default: True). max_depth: Maximum directory recursion depth (default: 10).

Returns: JSON string containing total_entries and a structured list of files with sizes.

Read text content from a file inside the repository with line windowing.

Args: path: Relative path to the file inside the repository. start_line: 1-indexed starting line number (default: 1). end_line: 1-indexed ending line number (default: None, reads up to 1000 lines).

Returns: JSON string containing path, line numbers, content, and truncation status.

Search for literal text or regular expressions across repository files.

Args: query: The substring or regex to search for. path: Optional relative directory or file to constrain search scope. is_regex: Whether query is a regular expression (default: False). case_sensitive: Whether match should be case-sensitive (default: False). max_results: Maximum matching lines to return (default: 50).

Returns: JSON string with matched lines, line numbers, and file paths.

Execute automated pytest tests within the repository sandbox.

Args: test_target: Optional relative test file or test node (e.g. 'tests/test_math.py::test_add'). timeout_seconds: Maximum time allowed before terminating process (default: 30s).

Returns: JSON string with exit code, passed/failed counts, duration, and output summary.

Retrieve test execution output and logs from a previous test run.

Args: run_id: Specific test run identifier (empty string defaults to most recent run). full: If True, returns full untruncated stdout and stderr (default: False).

Returns: JSON string containing logs, exit code, duration, and pass/fail counts.

Atomically apply a unified diff patch to repository files.

Args: patch: The unified diff content (e.g., standard 'diff --git' or '--- / +++' format). file_path: Optional relative target path if targeting a single file.

Returns: JSON string with success status, list of changed files, and status message.

Retrieve the deterministic Git diff of changes made in the repository.

Args: path: Optional relative file or directory path to scope the diff. cached: If True, inspects staged changes (git diff --cached) (default: False).

Returns: JSON string containing diff string, has_changes boolean, and changed_files list.

Inspect the current Git repository status (modified, staged, untracked files).

Returns: JSON string with branch, clean flag, and lists of modified/staged/untracked files.