Tools Overview

Gee-Code ships with over 100 purpose-built tools that the AI uses to interact with your system. These aren’t plugins or extensions — they’re core capabilities available in every session. This page covers the essentials; see the Tools Reference for the complete list with parameters and examples.

Tool Categories

File Operations

Read, write, edit, and search files across your entire filesystem.

Tool	Description
Read	Read file contents (text, images, PDFs, notebooks)
Write	Create new files
Edit	Make targeted text replacements in existing files
MultiEdit	Batch multiple edits in a single operation
InsertLines	Insert content at a specific line number
ReplaceLines	Replace a range of lines
Glob	Find files by pattern (**/*.py, src/**/*.tsx)
Grep	Search file contents with regex

Shell & Git

Execute commands and manage version control.

Tool	Description
Bash	Run shell commands with timeout control
Git	Safe git operations (auto-blocks force push, hard reset)

Web & Browser

Fetch web content and automate browsers.

Tool	Description
WebFetch	Fetch and process any URL
WebSearch	Search the web
AgentBrowser	Headless browser automation (click, fill, screenshot)
DevBrowserConnect	Connect to Chrome DevTools
DevBrowserConsole	Read browser console logs
DevBrowserDom	Inspect DOM structure
DevBrowserEval	Execute JavaScript in page context
DevBrowserScreenshot	Capture screenshots
DevBrowserNetwork	Monitor network requests

Media Generation

Create images and video with AI.

Tool	Description
GenerateImage	Quick image generation
FalGenerate	Generate content with any FAL model
FalJobStatus	Check background generation progress
FalJobResult	Download completed generation results
SearchFalModels	Search 600+ FAL models

Memory & Context

Manage persistent memory and conversation context.

Tool	Description
Remember	Store a fact to long-term memory
RecallMemory	Search across all memory layers
ForgetMemory	Delete a specific memory item
UpdateLedger	Update the continuity ledger
ReadLedger	Read current session state

Planning & Execution

Break down and execute complex tasks.

Tool	Description
TodoWrite	Manage a visible task list
BeadPlan	Create a task dependency graph
BeadExecute	Run approved tasks (parallel or sequential)
BeadStatus	Inspect the task graph

Agent Management

Create and manage AI agents.

Tool	Description
CreateAgent	Create a custom agent
DeleteAgent	Remove an agent
GetAgents	List available agents

Skills & Plugins

Extend Gee-Code’s capabilities.

Tool	Description
Skill	Invoke a skill by name
CreateSkill	Create a new skill
SyncSkill	Upload a local skill to the server
InitSkill	Scaffold a new skill directory

Communication

Reach people outside the terminal and handle capability gaps.

Tool	Description
SendNotification	Send SMS, email, or voice call
AskUserQuestion	Ask interactive questions with options
GeeConnect	Bridge to Gee server (search, calendar, email, storage, Google Drive)
AssessCapabilityGap	Structured analysis when a tool, skill, or credential is missing

System

Port management, process control, and infrastructure.

Tool	Description
CheckPort	Check if a port is in use
WaitForPort	Wait for a server to start
KillPort	Stop process on a port
NotebookEdit	Edit Jupyter notebook cells

Safety Levels

Every tool has a safety classification:

• Safe — read-only operations that can’t modify anything (Read, Glob, Grep, RecallMemory)
• Caution — write operations that modify files or run commands (Edit, Write, Bash, Git)
• Danger — destructive operations (force push, hard reset, file deletion)

Safe tools run automatically. Caution and danger tools may require your approval depending on your permission settings.

MCP Integration

All tools are exposed via the Model Context Protocol (MCP), which means they work with any MCP-compatible client — not just Gee-Code’s built-in AI. You can use them with Claude Code, OpenAI’s tool system, or any custom integration.

gee-code-mcp --transport stdio     # For Claude Code integration
gee-code-mcp --transport sse       # For HTTP/SSE clients

Next Steps

• Code & Files — deep dive into file operations
• Shell & Git — command execution and version control
• Web & Browser — web access and browser automation
• Media Generation — image and video creation
• Communication — notifications, email, server services, and gap handling
• Tools Reference — complete technical reference for all tools