Read the contents of a file from the filesystem. Supports text and binary files.

Write content to a file. Creates the file if it doesn't exist, overwrites if it does. Can create parent directories.

Append content to an existing file. Creates the file if it doesn't exist.

Delete a file from the filesystem. This operation is irreversible.

List contents of a directory with detailed information about each entry (name, type, size, permissions, etc.)

Create a new directory. Can create parent directories if they don't exist.

Delete a directory. Can recursively delete all contents. WARNING: Use with caution as this is irreversible.

Get detailed information about a file or directory (size, permissions, timestamps, etc.)

Move or rename a file or directory

Copy a file to a new location

Execute a shell command with full system access. Supports sudo for privileged operations.

Use this for:

• Running system commands (apt, brew, yum, dnf, pacman, etc.)

• Installing packages and dependencies

• Managing services (systemctl, service, etc.)

• File operations via shell utilities

• Network operations (curl, wget, ssh, scp, etc.)

• Git operations

• Docker commands

• Any other shell command

The command runs in /bin/bash by default. Output is captured and returned after completion. For long-running commands, use shell_execute_streaming instead.

Execute a long-running shell command with streaming output support. Captures output as it's produced.

Use this for:

• Build processes (npm build, cargo build, etc.)

• Long-running scripts

• Services that produce continuous output

• Commands that take significant time to complete

The command runs in /bin/bash by default. Output is streamed and returned when complete.

List Docker containers with their status

Fetch logs from a container

Execute a command inside a running container

Start one or more stopped containers

Stop one or more running containers

Restart one or more containers

Return low-level information on Docker objects (containers, images, networks, volumes)

Build a Docker image from a Dockerfile

List Docker images

Pull an image or repository from a registry

Create and start containers defined in docker-compose.yml

Stop and remove containers, networks created by docker-compose up

List containers in a docker-compose stack

View output from containers in a docker-compose stack

Remove one or more containers

Remove one or more images

Get repository status showing staged, unstaged, and untracked files

Stage files for commit. Use "." to stage all changes

Create a commit with staged changes

Show changes between commits, working tree, and staging area

Show commit history with details

List, create, delete, or rename branches

Switch branches or restore files

Fetch and integrate changes from remote repository

Push commits to remote repository

Clone a repository into a new directory

Initialize a new git repository

Merge a branch into current branch

Reapply commits on top of another branch

Download objects and refs from remote repository

Manage remote repositories

Stash changes in working directory

Reset current HEAD to specified state

Revert a commit by creating a new commit

Create, list, or delete tags

Show details of a commit

Get or set git configuration