Read a file with pagination. Returns content, total lines, and file size.

Write content to a file. Creates directories if needed. Handles escaping correctly.

Search files by regex pattern within the project.

List directory contents.

Run a predefined command from the project config. Available: build, test, dev, start, ps, logs.

Start a command in the background and return immediately with a job ID. Use shell_bg_status, shell_bg_log, and shell_bg_stop to manage the job. Default timeout is 30 minutes. Commands run in /bin/sh.

Check the status of a background job. Returns running state, exit code (if done), stdout/stderr so far, and duration.

Get the log output of a background job. Optionally limit to the last N lines.

Stop a running background job by sending SIGTERM (then SIGKILL after 5s if needed).

List all active or recently finished background jobs.

Get the current git status: branch, clean/dirty, staged/unstaged/untracked files, ahead/behind remote, last commit.

Get recent commit history.

Get diff of changes. Defaults to diff against HEAD.

Get comprehensive info about a project: stack, structure, file counts, config detection, enabled tools.

Read a project resource file (handoff, plan, schema, docs).

List all configured projects with their name, root, stack, and enabled tools.

Set the active project for subsequent tool calls that don't specify a project explicitly.

[example-echo v1.0.0] Echoes back the input message exactly as provided

[example-echo v1.0.0] Returns a friendly greeting for the given name