Clear the session command history.

This does not affect the working directory, environment variables, or any other session state. Only the command history is cleared.

Returns: A dict with keys: status, data (confirmation message).

Examples: clear_session_history()

Return the value of an environment variable.

Checks session-scoped overrides first, then falls back to the inherited process environment.

Return recent command history for the current session.

History entries include the command, tool name, exit code, timestamp, and duration. History is capped at 500 entries.

Return a snapshot of the current session state.

Includes the working directory, last exit code, active virtual environment, active Git repository, active project, and session start time.

Returns: A dict with keys: status, data (session snapshot).

Examples: get_session_info()

Return the current session working directory.

The working directory persists across all tool calls within the same server session. It defaults to the user's home directory on startup.

Returns: A dict with keys: status, data (containing cwd, exists, is_dir).

Examples: get_working_directory()

List all environment variables visible to the MCP server process.

Returns both process-level and session-scoped overrides. Session overrides are marked with source: "session" in the output.

Execute a CMD command and return the output.

Useful for legacy batch operations, tools that behave differently under CMD, or when PowerShell is unavailable.

Execute a PowerShell command and return the output.

The command passes through the full security validation pipeline before execution. Dangerous commands (format, shutdown, etc.) are blocked automatically.

Execute a PowerShell (.ps1) or batch (.bat/.cmd) script file.

Resolves the script path relative to the current working directory. The script must exist within the configured workspace boundary.

Change the current session working directory.

The new directory must exist and must be within the configured workspace boundary. Relative paths are resolved against the current working directory.

    Append content to an existing file (or create it if it does not exist).

    Args:
        path:     Path to the file.
        content:  Content to append.
        encoding: File encoding. Default: "utf-8".

    Returns:
        A dict with keys: status, data (path, total_size_bytes).

    Examples:
        append_file("log.txt", "New entry

") append_file("output.csv", "row1,row2 ")

Copy a file to a new location within the workspace.

Create a directory and all necessary parent directories.

Permanently delete a file from the workspace.

This operation is irreversible. Requires explicit confirmation when security.require_confirmation is enabled (default: True).

Check whether a path exists within the workspace.

Return metadata for a file or directory.

Includes size, creation time, modification time, file type, and whether the path is readable/writable.

List the contents of a directory.

Move or rename a file within the workspace.

Read and return the contents of a text file.

Search for files matching a glob pattern.

Return a directory tree view up to a specified depth.

    Create or overwrite a file with the given content.

    Creates parent directories automatically. Overwrites existing files
    without warning — use file_exists() first if unsure.

    Requires explicit confirmation when ``security.require_confirmation``
    is enabled in config.

    Args:
        path:     Path to write (absolute or relative to cwd).
        content:  The text content to write.
        encoding: File encoding. Default: "utf-8".
        confirm:  Set to True to confirm when required by config.

    Returns:
        A dict with keys: status, data (path, size_bytes, lines).

    Examples:
        write_file("notes.txt", "Hello, World!")
        write_file("src/config.py", "DEBUG = True

", confirm=True)

Stage files for commit.

Show line-by-line authorship information for a file.

List local (or all) branches and indicate the current branch.

Switch to a branch, or restore a file to its last committed state.

Clone a remote repository into a local directory.

The destination must be within the workspace boundary.

Create a commit with the staged changes.

Requires explicit confirmation when security.require_confirmation is enabled in config (default: True).

Create a new branch and switch to it.

Show changes between commits, working tree, or index.

Initialise a new Git repository.

The target path must be within the workspace boundary.

Return recent commit history.

Pull changes from a remote repository.

Push commits to a remote repository.

Requires explicit confirmation when security.require_confirmation is enabled in config (default: True).

Show configured remote repositories and their URLs.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: git_remote_info()

Stash or restore uncommitted changes.

Return the current Git working tree status.

Shows the state of the index and working directory — which files are staged, unstaged, or untracked.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: git_status()

List all tags in the repository.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: git_tags()

Register a virtual environment as active in the current session.

This does not "activate" the venv in a shell sense (which is a shell-level operation). Instead, it records the venv path in the session so that subsequent python_* and pip_* tool calls use the venv's interpreter and pip automatically.

Check whether a package is installed and return its version.

Create a new Python virtual environment.

Deactivate the current session's virtual environment.

After this call, python_* and pip_* tools will use the system Python interpreter.

Returns: A dict with keys: status, data (confirmation).

Examples: deactivate_venv()

Install a Python package with pip.

Requires explicit confirmation when security.require_confirmation is enabled in config.

List all installed Python packages.

Output installed packages in requirements.txt format.

Useful for generating a requirements.txt file or auditing the exact package versions in the current environment.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: pip_freeze()

Return the current pip version.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: pip_version()

Return comprehensive Python environment information.

Includes version, executable path, platform, prefix, and active virtual environment (if any).

Returns: A dict with keys: status, data (detailed env info).

Examples: python_info()

Return the current Python interpreter version.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: python_version()

Execute a Python script file.

The script must be within the workspace boundary. Uses the active virtual environment's Python if one is registered in the session.

Uninstall a Python package with pip.

Requires explicit confirmation (passes --yes to pip to avoid interactive prompt).

Execute a JavaScript file with Node.js.

Return the installed Node.js version.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: node_version()

Fetch information about an npm package from the registry.

Install npm packages.

List installed npm packages.

Run an npm script defined in package.json.

Return the installed npm version.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: npm_version()

Execute a command with npx.

Build a Docker image from a Dockerfile.

Stop and remove Docker Compose services.

Return logs from Docker Compose services.

Start Docker Compose services.

Execute a command inside a running container.

Return Docker system-wide information.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: docker_info()

List Docker containers.

List Docker images.

Return logs from a container.

Pull a Docker image from a registry.

Remove a Docker container.

Run a Docker container.

Stop a running container.

Return the installed Docker version.

Returns: A dict with keys: status, exit_code, stdout, stderr, output, duration_ms.

Examples: docker_version()

Return CPU usage statistics and core information.

Returns: A dict with keys: status, data (cores, usage%, frequency).

Examples: cpu_info()

Return disk partition information and usage for each drive.

Returns: A dict with keys: status, data (list of partition details).

Examples: disk_info()

Return detailed information about a specific process.

List running processes with resource usage.

List Windows services with their status.

Return RAM and virtual memory statistics.

Returns: A dict with keys: status, data (total, available, used, percent for RAM and swap).

Examples: memory_info()

Return comprehensive system information.

Includes OS version, hostname, uptime, Python version, architecture, and processor brand.

Returns: A dict with keys: status, data (detailed system snapshot).

Examples: system_info()

Return detailed Windows version information.

Returns: A dict with keys: status, data (version, build, edition strings).

Examples: windows_version()

Perform a DNS lookup for the given hostname.

Return local network adapter information and IP addresses.

Includes all IPv4 and IPv6 addresses for each active adapter.

Returns: A dict with keys: status, data (hostname, adapters list).

Examples: get_ip_info()

List locally open (listening) TCP and UDP ports.

Perform an HTTP GET request and return the response.

Useful for testing APIs and web endpoints. Response body is truncated at 10,000 characters.

Ping a host and return round-trip statistics.

Trace the network route to a host.

Search for SQLite database files within the workspace.

Execute any SQL statement against a SQLite database.

Write operations (INSERT, UPDATE, DELETE, CREATE, DROP, etc.) require explicit confirmation.

List all tables in a SQLite database file.

Execute a read-only SELECT query against a SQLite database.

Only SELECT statements are allowed. Use sqlite_execute for writes.

Return the CREATE statement(s) for tables in a database.

Return column definitions for a specific table.

Detect project type, framework, and key configuration files.

Identifies Python, Node.js, .NET, Rust, Go, Java, Docker, and other project types automatically by checking for characteristic files.

Count lines of code across the codebase.

Counts total lines, code lines (non-blank, non-comment), blank lines, and comment lines per file extension.

Search for TODO/FIXME/HACK and similar tags in source files.

Return a comprehensive project overview combining multiple analyses.

Combines project type detection, LOC counting, and TODO/FIXME listing into a single structured report.

Parse and summarise a package.json file.

Returns project name, version, description, scripts, dependencies, and devDependencies.

Parse and summarise a pyproject.toml file.

Returns project name, version, description, dependencies, and tool configurations.

Check GitHub authentication status and token validity.

Returns whether a token is configured and (if so) the authenticated user's login name.

Returns: A dict with keys: status, data (authenticated, token_present, user).

Examples: github_auth_status()

Create a new GitHub issue.

Requires a GITHUB_TOKEN with issue write permissions and explicit confirmation when required by config.