Io
Tools for io
codemap_append
Append content to end of file.
→codemap_copy
Copy a file or directory to a new location, preserving the original
→codemap_create
Create a new file. Fails if file exists (conflict envelope returned).
→codemap_create_symbol
Insert a new symbol (function, method, class, interface, type, const, or enum) into an existing file with precise placement control. Automatically handles indentation and spacing based on file conventions. Triggers automatic re-parse so the knowledge graph stays current.
→codemap_delete
Delete a file, directory, or an entire symbol from a file. Use symbol targeting (relativePath$symbolName) to surgically remove a function or class without touching the rest of the file.
→codemap_edit_summary
Update an existing stored summary for a file. Errors with NO_SUMMARY_FOUND if no summary exists yet — use codemap_set_summary to create one first. Returns the previous value.
→codemap_get_annotations
Get @codemap annotations for a file or scoped to a specific symbol. Symbol targeting (relativePath$symbolName) filters annotations to only those within that symbol's line range, excluding file-level meta/domain annotations.
→codemap_get_symbols
Get all symbols (functions, classes, interfaces, etc.) in a file. Supports symbol targeting (relativePath$symbolName) to get nested symbols — e.g. passing a class name returns only its methods, excluding top-level file symbols.
→codemap_list
List directory contents with optional depth for recursive listing.
→codemap_move
Move or rename a file or directory to a new location
→codemap_peek
Get comprehensive file overview — imports, importedBy, all symbols with call graph data (calls + calledBy per symbol always included), groups, labels, and file metadata. The 'show everything' tool for a single file.
→codemap_read_file
Read file contents with pagination. Supports symbol references (file.ts$symbolName) to read just that symbol. Use offset/length for large files.
→codemap_read_multiple
Read content from multiple files in one call.
→codemap_remove_summary
Remove the stored agent summary for a file. The heuristic summary extracted from JSDoc during scan is unaffected — it will re-populate on the next scan. Use this to let the heuristic take over again after an agent summary becomes stale.
→codemap_rename
Rename or move a file.
→codemap_replace_many
Perform multiple find-and-replace operations in one file. Supports symbol targeting (relativePath$symbolName) to scope all replacements within a specific function or class. Supports regex with capture groups via useRegex.
→codemap_replace_text
Find and replace text in a file. Supports symbol targeting (relativePath$symbolName) to scope changes to a specific function or class, exact mode (recommended for template literals), line ranges (relativePath:10-20), and fuzzy matching.
→codemap_set_summary
Set or update the plain-language summary for a file. Creates the summary if none exists; updates it if one already does. Becomes immediately searchable with no rescan required.
→codemap_write
Write or update file contents. Supports symbol targeting (relativePath$symbolName) to replace an entire symbol (function, class, method) without touching the rest of the file.
→