Documentation
Tool Calls
These are the specialized tool calls available to Codinel's agentic AI - code intelligence, refactoring, version control, testing, and terminal access, alongside standard file operations. Destructive tools are gated by the approval policy documented under Security.
Core File & Code Operations
Standard operations to navigate the project workspace, read and write files, and parse code structure to optimize context window usage.
read_file
Reads the full content of one or more existing files in a single call.
paths: array
write_file
Writes complete content to a file. Rejects writes that would remove most of an existing file unless explicitly confirmed.
file: string
content: string
confirmLargeDeletion: boolean
search_replace
Replaces exact code snippets in a file with new code. Groups all edits for one file into a single call.
file: string
replacements: array
delete_file
Permanently deletes one or more files in a single call.
files: array
move_file
Moves a file to a target directory, preserving file history.
sourcePath: string
targetDir: string
project: string
move_folder
Moves a folder to a target directory.
sourcePath: string
targetDir: string
project: string
get_symbol
Retrieves specific functions, classes, or variables from a file without loading the whole file.
file: string
symbol: string
symbols: array
project: string
search_codebase
Searches the codebase for multiple literal strings or regex patterns in a single pass.
queries: array
project: string
get_project_manifest
Returns the file manifest for one or more loaded projects on demand.
projects: array
type: light | outline
Unity Bridge Tools
Direct integration with the live Unity Editor through the official Unity CLI/Editor Pipeline and the Codinel Bridge plugin. These tools give the AI real-time access to your scene, assets, terrain, and editor functionality.
execute_unity_cli
Executes one or more Unity CLI commands via the connected Editor Pipeline.
command: string
args: object
commands: array
get_unity_command_help
Returns the full description and parameter documentation for specific Unity CLI commands.
names: array
scaffold_ui_toolkit_menu
Creates UXML, USS, PanelSettings, and UIDocument.
spec: string
get_project_settings
Returns key Unity project settings including quality, physics, player, color space, and rendering config.
No parameters required
get_asset_dependencies
Returns the dependencies of a specific asset path.
assetPath: string
recursive: boolean
download_google_font
Downloads a Google Font (.ttf) into the Unity workspace.
fontFamily: string
destinationPath: string
get_unity_uss_properties
Retrieves the list of Unity's USS supported properties.
No parameters required
manage_addressables
Addressables group operations. Requires com.unity.addressables to be installed.
action: GET_ADDRESSABLE_GROUPS | CREATE_ADDRESSABLE_GROUP | ADD_TO_ADDRESSABLE_GROUP
groupName: string
assetPath: string
eval_unity_code
Runs C# statements against the live Unity Editor to act on the open scene and read state back.
code: string
timeout: number
unityPort: number
manage_scene_backup
Snapshots and restores the open scene. Supports LIST, CREATE, RESTORE, DELETE, and VERIFY.
action: LIST | CREATE | RESTORE | DELETE | VERIFY
backupName: string
manage_broken_url_refs
Scans the project for broken URL-style asset references and optionally repairs them.
action: SCAN | FIX
searchFolder: string
serialize_canvas_hierarchy
Serializes a uGUI Canvas and its children to structured JSON, including layout and component values.
gameObjectName: string
manage_ui_toolkit_host
Mounts a UXML asset into the active scene, or migrates UIDocument hosts to PanelRenderer.
action: MOUNT | MIGRATE
assetPath: string
gameObjectName: string
unity_asset_search
Searches the project's prefabs and models by meaning. Returns placement-ready metadata: world size, pivot, collider, and LODs.
query: string
kind: prefab | model
folder: string
limit: number
unity_place
Places a single prefab or model instance in the active scene, keeping its prefab link.
prefabPath: string
position: array
rotationY: number
scale: number
parent: string
snapToGround: boolean
unity_scatter
Scatters many prefab instances across a region in a single call, with ground snapping, spacing, and random rotation/scale.
prefabs: array
count: number
region: object
minSpacing: number
align: up | surface
rotationY: array
scale: array
parent: string
seed: number
snapToGround: boolean
maxSlope: number
unity_scene_map
Draws a top-down map of where objects actually are and returns it as an image plus measured findings.
root: string
layers: array
checks: array
unity_terrain
Creates and sculpts a Unity Terrain, and answers height/slope questions about it.
action: string
size: array
resolution: number
position: array
assetPath: string
shape: object
points: array
maxSlope: number
layers: array
rules: array
removeLayers: boolean
paintAreas: array
manage_asset_catalog
Inspects and maintains the asset palette behind unity_asset_search.
action: STATUS | REBUILD | ENRICH | DESCRIBE | STAR | UNSTAR | BAN | UNBAN
paths: array
Development Tools
Advanced development capabilities beyond standard file operations - test generation, database queries, version control, and terminal access.
generate_ui_asset
Generates a UI image asset from a text prompt.
prompt: string
destination_path: string
remove_background: boolean
aspect_ratio: string
image_size: string
execute_db_query
Executes a database query against the active or specified connection.
query: string
connectionId: string
get_db_schema
Gets the database schema for one or more connections.
connectionIds: array
run_terminal_command
Executes one or more shell commands in the active project context.
command: string
commands: array
failOnError: boolean
fail_on_error: boolean
proposed: boolean
stdout_max_bytes: number
stderr_max_bytes: number
generate_unit_tests
Generates unit tests for target logic/backend source-target file pairs.
targets: array
generate_ui_tests
Generates UI tests for source/target file pairs.
targets: array
generate_integration_tests
Generates integration tests for source/target file pairs, with optional API contract details.
targets: array
vcs_action
Performs version control operations: branch, commit, and merge.
action: branch | commit | merge
arg: string
arg2: string
Planning, Safety & Control
Tools that enforce developer control and prevent AI hallucinations - planning, task lifecycle, QA validation, and undo - ensuring the agent works safely within your project boundaries.
ask_user
Shows interactive quick-reply buttons in chat for one or more questions.
question: string
buttons: array
questions: array
request_clarification
Requests clarification when a request is ambiguous or lacks enough information to proceed.
message: string
options: array
undo
Undoes the last action.
No parameters required
action_item
Creates a manual action item with a title, description, and severity.
title: string
description: string
severity: blocker | info
propose_phase_plan
Proposes a multi-phase blueprint for building something large from little or nothing, where each phase runs in its own fresh chat.
shortMessageToUser: string
phases: array
globalNote: string
propose_micro_plan
Proposes a sequential micro-task plan for repetitive file-editing tasks or multi-file refactors.
shortMessageToUser: string
globalInstructions: string
tasks: array
complete_task
Finalizes the run when a task or set of pipeline tasks is complete.
taskId: string
taskIds: array
complete_phase
Marks a phase or set of phases as completed in a phase pipeline.
phaseId: string
phaseIds: array
validate_implementation
Performs a read-only QA review of a completed task against its acceptance criteria and branch diff.
project: string
task: object
skip_qa
Bypasses QA validation when no code files were modified.
No parameters required
codinel_learn
Proposes a durable Codinel rule based on a user correction or new architectural paradigm, for the user to approve.
rule: string
markdown_document
Renders a formatted markdown document to the user.
content: string
file: string