◆Franklin/Docs

CLI

Every command and flag in the Franklin CLI.

Main Command

bash
franklin [flags]

Launches an interactive agent session. Without any flags, Franklin uses the Smart Router to pick the best available model.

Global Flags

  • --trust— skip tool-call confirmations (trust mode)
  • --debug— enable verbose debug logging
  • -m <model> — pin a specific model (e.g., -m claude-sonnet-4-20250514)
  • --version— print the installed version
  • --help— show help text

Subcommands

setup

bash
franklin setup <chain>   # chain: base | solana

Create or import a wallet on the specified chain. Prompts for a private key import or generates a new wallet.

balance

bash
franklin balance

Display your wallet address and current USDC balance across all configured chains.

models

bash
franklin models

List all available models with their provider, cost tier, and current availability status.

config

bash
franklin config [key] [value]

View or set configuration values. Without arguments, prints the full config. With a key, prints that value. With both, sets the value.

search

bash
franklin search <query>

Run a web search from the command line using BlockRun's search API. Returns structured results.

social

bash
franklin social <platform> <action>

Interact with social platforms (X/Twitter). Actions include post, search, and timeline.

proxy

bash
franklin proxy [--port <port>]

Start an OpenAI-compatible API proxy server. Allows any tool that supports the OpenAI API format to route through Franklin's Smart Router.

daemon

bash
franklin daemon start|stop|status

Manage the Franklin background daemon for scheduled tasks and persistent sessions.

migrate

bash
franklin migrate

Import settings, history, and learnings from Claude Code or Cursor. Detects your existing configuration automatically.

init

bash
franklin init

Initialize Franklin in the current project directory. Creates a .franklin/ directory with default settings.

uninit

bash
franklin uninit

Remove Franklin configuration from the current project. Deletes the .franklin/ directory.

panel

bash
franklin panel

Open the Franklin web dashboard in your browser. Shows session history, spending analytics, and model usage.

insights

bash
franklin insights

Display spending analytics, model usage breakdown, and cost trends from the command line.

Quick help

Run franklin --help or franklin <command> --help for usage details on any command.