Skip to main content
CategoryPurposeTool Names
ReadAccess file content and explore code structureread_file, search_files, list_files, list_code_definition_names
EditCreate or modify files and codewrite_to_file, apply_diff
ExecuteRun commands and perform system operationsexecute_command
BrowserInteract with web contentbrowser_action
WorkflowManage task progress and contextask_followup_question, attempt_completion, switch_mode, newt_task

​
Example: Using Tools

Here’s a typical interaction with Softcodes tools: The tool approval interface displays “Save” and “Reject” buttons, along with an optional Auto-approve checkbox. Scenario: Create a file named greeting.js that logs a greeting message.
  1. User: Requests the file creation.
  2. Softcodes: Suggests using the write_to_file tool.
<write_to_file>
<path>greeting.js</path>
<content>
function greet(name) {
  console.log(`Hello, ${name}!`);
}

greet('World');
</content>
<line_count>5</line_count>
</write_to_file>
  1. User: Clicks Save in the interface.
  2. Softcodes: Confirms the file has been created successfully.

​
Tool Safety and Approval

Every tool action requires your explicit confirmation. When a tool is suggested, you’ll see:
  • Save – approve and execute the tool.
  • Reject – decline the proposed tool.
  • Auto-approve – optionally allow trusted operations to run automatically.
This safeguard ensures you retain control over:
  • Which files are created or modified
  • Which commands are executed
  • How the codebase changes
Always review proposed tools carefully before approving.

​
Core Tools Reference

Tool NameDescriptionCategory
read_fileReads file content with line numbersRead
search_filesSearches files for text or regex patternsRead
list_filesLists files and directories at a given pathRead
list_code_definition_namesLists code definitions (classes, functions, etc.)Read
write_to_fileCreates new files or overwrites existing onesEdit
apply_diffApplies precise changes to specific sectionsEdit
execute_commandRuns commands in the terminalExecute
browser_actionPerforms operations in a headless browserBrowser
ask_followup_questionPrompts you for additional clarificationWorkflow
attempt_completionMarks the task as completeWorkflow
switch_modeChanges Softcodes to a different operational modeWorkflow
new_taskCreates a subtask with a defined starting modeWorkflow
This format ensures Softcodes actions are both transparent and safe, while still allowing fast, efficient interaction with its tools.