Skip to main content
Tools to read the file tree, read a file, write commits and search text in the code.

get_presentation

Ver apresentação aplicada. Lê a apresentação validada, commit aplicado e erros, sem publicar o executável.
Read only: changes nothing. Confirmation belongs to the AI client; scopes and blocks still apply.

Parameters

string
required
Script ID (uuid)

Example

validate_presentation

Validar cartão e popup. Valida ui/site/ de uma branch ou commit. Não aplica branches de trabalho.
Read only: changes nothing. Confirmation belongs to the AI client; scopes and blocks still apply.

Parameters

string
required
Script ID (uuid)
string
Branch ou commit

Example

ensure_presentation_files

Preparar apresentação. Adiciona apenas arquivos ui/site/ ausentes ao repositório antigo. Não sobrescreve o executável. Exige expected_head.
Writes or changes script data. Confirmation belongs to the AI client; scopes and blocks still apply.

Parameters

string
required
Script ID (uuid)
string | null
required
—

Example

read_tree

Read tree. Lists the files of a branch or commit.
Read only: changes nothing. Confirmation belongs to the AI client; scopes and blocks still apply.

Parameters

string
required
Script ID (uuid)
string
Branch or SHA (default: main)

What it calls in the API

Por baixo, a ferramenta usa GET /scripts/{script_id}/repo/tree da API do Scripts. The response includes text and structuredContent, with secrets removed.

Example

read_file

Read file. Content of a file.
Read only: changes nothing. Confirmation belongs to the AI client; scopes and blocks still apply.

Parameters

string
required
Script ID (uuid)
string
required
Path, e.g. src/script.js
string
Branch or SHA

What it calls in the API

Por baixo, a ferramenta usa GET /scripts/{script_id}/repo/files/{path} da API do Scripts. The response includes text and structuredContent, with secrets removed.

Example

write_files

Write files. Writes a commit. Read the branch head in list_branches and send it in expected_head. content null deletes the file.
Writes or changes script data. Destructive action: review in your AI client before confirming. Confirmation belongs to the AI client; scopes and blocks still apply.

Parameters

string
required
Script ID (uuid)
string
Branch (default: main)
string
required
Current head_sha of the branch
string
required
Commit message
object[]
required
List of items.

What it calls in the API

Por baixo, a ferramenta usa POST /scripts/{script_id}/repo/commits da API do Scripts. The response includes text and structuredContent, with secrets removed.

Example

search_code

Search code. Searches text in every file of a ref (up to 50 results).
Read only: changes nothing. Confirmation belongs to the AI client; scopes and blocks still apply.

Parameters

string
required
Script ID (uuid)
string
required
Text
string
Branch or SHA

What it calls in the API

Por baixo, a ferramenta usa GET /scripts/{script_id}/repo/tree, GET /scripts/{script_id}/repo/files/{path} da API do Scripts. The response includes text and structuredContent, with secrets removed.

Example