Send a message to the user via Telegram. Use for status updates, informational messages, or any communication that doesn't require approval.

Request approval for an implementation plan before making changes. Use this before modifying more than 3 files or making significant changes. The user will see the plan summary and can approve or reject.

Request approval for specific code changes. Use for reviewing important modifications before they are committed.

Send an artifact (screenshot, recording, or file) to the user via Telegram. Use after capturing UI screenshots or generating visual content.

Update the status ticker message. This edits the existing status message instead of sending a new one, reducing message spam.

Send a critical error notification to the user. Use when terminal commands fail or errors occur that need user attention.

Wait for the user to respond with a message. Use when you need specific input or instructions from the user.

Check for pending prompts from the Telegram user. Call this when the user asks you to check telegram or at the start of a session. Returns any queued prompts that the user sent via the Telegram bot.

Wait efficiently for a new prompt to arrive from Telegram. Blocks until a prompt is found or timeout is reached. Use this in a loop to monitor for incoming tasks.

Read the contents of a file from the current project. Use to report file contents back to Telegram or verify changes.

Write content to a file in the project. Creates parent directories if needed. Use for code modifications.

List files and directories in the project. Use to explore project structure or find files matching a pattern.

Search for code patterns in the project using grep. Returns matching files with line numbers and content snippets.

Run a terminal command in the project directory. Returns stdout, stderr, and return code. Use for builds, tests, etc.

Get information about the current project context. Returns project path, file counts by type, git status, and settings.

Set the current project path for IDE operations. All file operations will be relative to this path.

Send a code update notification to Telegram. Use after making significant code changes to inform the user.