Tools

Overview

Franklin comes with 16 built-in tools organized by category. Tools are invoked automatically based on your request — just describe what you want and Franklin picks the right tool.

File & Shell

Core tools for reading, writing, and navigating your filesystem:

• Read— read file contents, supports line ranges for large files
• Write— create or overwrite files
• Edit— surgical string replacements in existing files (sends only the diff)
• Bash— execute shell commands with timeout and background support
• Glob — fast file pattern matching (e.g., **/*.ts)
• Grep— regex search across files with context lines

You: "Find all TypeScript files that import React"
Franklin: [uses Grep with pattern "import.*React" and glob "*.ts"]

Web

Tools for fetching and searching the internet:

• WebFetch— fetch a URL and return its content (HTML, JSON, plain text)
• WebSearch— search the web and return structured results

Agent

Tools for orchestrating complex, multi-step work:

• Task— spawn a background task that runs independently
• SubAgent— delegate work to a child agent with its own context
• AskUser— pause and ask you a clarifying question before proceeding

Creative

• ImageGen— generate images from text descriptions using DALL-E or other providers

Trading

Real-time crypto market data and technical analysis (see Trading for details):

• TradingSignal— live price, RSI, MACD, Bollinger Bands, and volatility analysis
• TradingMarket— price lookup, trending coins, and market overview

Social

X/Twitter integration (see Social for details):

• SearchX— find relevant X/Twitter posts by keyword or topic
• PostToX— draft and post replies to X (requires your confirmation)