First Session

A guided walkthrough of your first conversation with Franklin.

Start Franklin

Launch Franklin in trust mode to skip tool confirmation prompts:

bash

franklin --trust

What is trust mode?

By default, Franklin asks for confirmation before running tools (shell commands, file edits, etc.). The --trust flag skips these prompts so you can move faster. You can always revoke trust mid-session with /untrust.

Understanding the UI

Once Franklin starts, the status bar at the bottom of your terminal shows three key pieces of information:

Current model— the model handling your current prompt (e.g., kimi-k2.5, grok, claude-sonnet)
USDC balance— your remaining wallet balance
Session cost— how much you've spent in this session so far

Try Some Prompts

Franklin is a general-purpose AI agent. Try a few prompts to see it in action:

text

> what's BTC looking like?

> refactor this file to use async/await

> find X posts about AI agents

> summarize this PDF

Each prompt is automatically routed to the best model for the task — you don't need to pick one.

Smart Router in Action

Franklin's Smart Router analyzes every prompt and selects the optimal model. Here are some examples of how routing works:

CODING tasks → kimi-k2.5 — fast, accurate code generation
TRADING tasks → grok— real-time market data and analysis
REASONING tasks → claude-sonnet— deep analysis and nuanced responses

Override the router

You can force a specific model with the --model flag: franklin --model grok. Or switch mid-session with /model grok.

Check Your Spend

At any point during a session, run the /cost slash command to see a per-model breakdown of your spending:

text

> /cost

Session cost breakdown:
  kimi-k2.5      $0.0012  (3 calls)
  grok           $0.0008  (1 call)
  claude-sonnet  $0.0045  (2 calls)
  ─────────────────────────
  Total          $0.0065

Every API call is a micropayment — you only pay for exactly what you use.