# Gemini CLI Tool Mapping

This document maps Claude Code tool names used in MaxFrame skills to Gemini CLI equivalents.

## Core Tools

| Claude Code Tool | Gemini CLI Tool | Notes |
|------------------|-----------------|-------|
| `Read` | `read_file` | Read file contents |
| `Write` | `write_file` | Write new file |
| `Edit` | `edit_file` | Edit existing file with string replacement |
| `Bash` | `run_shell_command` | Execute shell commands |
| `Glob` | `find_files` | Find files by pattern |
| `Grep` | `search_files` | Search file contents |

## Task Management

| Claude Code Tool | Gemini CLI Tool | Notes |
|------------------|-----------------|-------|
| `TodoWrite` | `write_todos` | Manage task list |
| `TaskCreate` | `create_task` | Create new task |
| `TaskUpdate` | `update_task` | Update task status |
| `TaskList` | `list_todos` | List all tasks |
| `TaskGet` | `get_task` | Get task details |

## Agent & Skill Tools

| Claude Code Tool | Gemini CLI Tool | Notes |
|------------------|-----------------|-------|
| `Skill` | `activate_skill` | Load and activate skill content |
| `Agent` | `launch_agent` | Launch specialized subagent |
| `TaskOutput` | `get_agent_output` | Get output from running agent |

## Interaction Tools

| Claude Code Tool | Gemini CLI Tool | Notes |
|------------------|-----------------|-------|
| `AskUserQuestion` | `ask_user` | Ask user for clarification or decisions |
| `EnterPlanMode` | N/A | Use direct conversation for planning |
| `ExitPlanMode` | N/A | N/A |

## Web Tools

| Claude Code Tool | Gemini CLI Tool | Notes |
|------------------|-----------------|-------|
| `WebFetch` | `fetch_web_content` | Fetch and analyze web content |
| `WebSearch` | `search_web` | Search the web |

## Notebook Tools

| Claude Code Tool | Gemini CLI Tool | Notes |
|------------------|-----------------|-------|
| `NotebookEdit` | `edit_notebook_cell` | Edit Jupyter notebook cells |

## Tool Availability

Gemini CLI loads skill metadata at session start and activates full content on demand via `activate_skill`. The platform automatically discovers skills from configured skill directories.

## Platform-Specific Behavior

- **Lazy Execution**: Both platforms use lazy execution patterns for MaxFrame operations
- **Session Management**: Both require explicit session creation and cleanup
- **Skill Loading**: Gemini uses `activate_skill` instead of Claude Code's `Skill` tool
- **Tool Substitution**: When skills reference Claude Code tools, substitute with Gemini equivalents listed above

## Usage Example

If a MaxFrame skill says:
```
Use the Skill tool to load alibabacloud-maxframe-coding
```

In Gemini CLI, use:
```
activate_skill skill_name="alibabacloud-maxframe-coding"
```
