Skip to content

Profiles

--profile defaults to ultra. Unknown values are rejected (strict, agent, or ultra only).

ProfileToolsWhat it adds
strict17Agent core. No git.
agent18Strict plus git.
ultra29Full catalog. Default.

--git-network is ignored in strict. It is honored by ultra and agent.

Recommended agent flags: --profile=strict --compact-mode --roots-mode=union.

strict tools are also in agent and ultra.

ToolProfileRole
list_allowed_directoriesstrictSandbox roots. No parameters.
directory_treestrictCompact tree. Defaults: respect_ignore=true, max_depth=2, max_nodes=500.
list_directorystrictDirectory listing.
search_filesstrictName search. Content with include_content:true.
get_file_infostrictSize, dates, type. Batch paths.
read_filestrictRead. Replaces cat, head, tail, cut.
write_filestrictCreate or overwrite.
edit_filestrictExact, regex, range, insert.
multi_editstrictSeveral replacements, one file.
apply_patchstrictUnified diff.
diff_filesstrictTwo paths, or against:"backup".
create_directorystrictRecursive mkdir.
move_filestrictMove or rename.
delete_filestrictSoft-delete by default.
backupstrictUndo, restore, trash.
helpstrictCatalog, or help(tool:"X").
security_policystrictWhether a file policy is active. Does not list rules.
gitagent, ultraLocal git unless --git-network.
copy_fileultraCopy a file or directory.
batch_operationsultraBatch, pipeline, or rename.
project_replaceultraOne find/replace across a tree or a paths list.
analyze_operationultraDry-run preview: file, optimize, write, edit, delete.
wslultraWSL sync and path conversion. Blocked while a file policy is active.
server_infoultrahelp, stats, artifact.
minify_jsultraPure-Go JS minify. No Node.
analyze_codeultraRead-only symbols, lint, sec, impact. Not a writer.
github_issuesultraGitHub issues via gh. Open-world.
gitlab_issuesultraGitLab issues via HTTP. Open-world.
context_packultraExperimental since 4.8.0. No outputSchema. Ranked files and short snippets. Not an embedding index.

analyze_code symbols: Go via AST; JS, TS, C#, and SQL via regex (name and line).

context_pack is the only experimental tool. Its description is prefixed at registration. It must not declare an outputSchema.

These names exist in source and are not added in registerTools:

read_text_file, search, edit, write, create_file, View, Edit, Write, Replace, LS, GlobTool, GrepTool, fs.

directory_tree is registered. It is not one of those aliases.

If a client asks for read_multiple_files or read_text_file, use read_file with paths.