Tools reference
The full set of tools the server registers at startup. All paths are resolved against FORGELINE_WORKSPACE_ROOT.
read_file
Read a UTF-8 text file from the workspace. Returns content as a string plus bytes_read.
{ "path": "notes/inbox.md" }
write_file
Create or replace a file. Parent dirs are created on demand.
{ "path": "out/report.md", "content": "# hello" }
list_dir
Enumerate a directory. Returns entries with name, type, and size.
{ "path": "notes" }
run_command
Execute a shell command with cwd pinned inside the workspace. Stdout streams back as it arrives; stderr and exit code return on completion.
{ "cmd": "pytest -q", "cwd": "projects/api" }
fetch_url
GET a URL. Returns status, headers, and body (text or base64 depending on content-type).
{ "url": "https://example.com/api/thing" }
cdp_attach
Connect to a Chrome instance started with --remote-debugging-port. See the browser bridge page.
{ "endpoint": "http://127.0.0.1:9222" }