Franco CLI

A local CLI drafts email sequences, manages an outbox and processes replies through your Claude Code or Codex access

  • 693 ★ on the repository
  • Last commit
  • MIT
CLI

Broad access

Why this level

  • The program reads conversations and sends mail as you
  • Mail and address-verification credentials live in the workspace environment
  • Automated outreach can cause complaints, mail-provider restrictions and unwanted contact
All reasons and checks

gortexai/franco

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add cli/franco

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The program reads conversations and sends mail as you
  • Mail and address-verification credentials live in the workspace environment
  • Automated outreach can cause complaints, mail-provider restrictions and unwanted contact

This is third-party code. Review the repository files before installing.

What it does

Franco helps manage outbound business email from a local workspace. It reads company information, prepares messages and queues them. In the normal mode, every outgoing email, including a reply, waits for human approval. Text can come from a model or previously approved templates. Franco invokes your Claude Code or Codex access and sends mail through a separately configured mailbox. A web dashboard places drafts beside their contact rationale and source evidence. After `franco run`, the program periodically checks the outbox and incoming replies. It tracks opt-outs and stops related sequences. Autopilot removes manual message review, so inspect its state before connecting a real mailbox.

Who it is for. Sales specialists preparing outreach and reviewing recipients and wording before sending from their own mailbox.

Good fit when

  • You have a reviewed company list and need outreach drafts
  • Approved templates need to be filled with recipient-specific information
  • Replies and opt-outs need handling in a shared campaign queue
  • You want personalization evidence beside an email draft

Not a fit when

  • There is no basis for contacting recipients or no accountable sender
  • You cannot give the program mailbox read and send access
  • You only need a one-off email edit without a background service

Example request

Prepare Franco with a test mailbox and draft a few messages for my reviewed list. Show sources and the outbox, leaving sending paused.

Limitations

Python 3.11 or later, a mailbox and signed-in Claude Code Pro/Max or Codex are required. Codex requires version 0.159.3 with ChatGPT sign-in on macOS/Linux; an API key does not replace that login. Configure mail separately through Gmail OAuth, SMTP/IMAP or legacy Instantly. New-address verification needs your own Reoon, ZeroBounce or Hunter keys and available funds. franco install downloads Chromium for browser tasks; package installation does not complete browser setup.

How to disable. First run `franco sending pause`, then stop `franco run`. Preserve needed workspace history and revoke mail access. Uninstall with the package manager used for installation. Messages already sent remain with recipients.

FAQ

How do I install Franco?

Run `pipx install franco`, then `franco init ~/franco`. The second command creates a workspace for configuration and data.

Where do I review drafts?

Run `franco dashboard` and open `http://localhost:5555`. `franco outbox` also shows the queue in a terminal.

Does disabling autopilot stop all email?

No. `franco autopilot off` restores review for new drafts, but already approved messages remain queued. Use `franco sending pause` for an immediate stop.

Does it need a separate model API?

The main mode needs no separate model API key. Franco uses the selected CLI’s subscription sign-in and tracks its quota. Availability depends on your plan and client compatibility.

Does address verification guarantee delivery?

No. Verification helps filter addresses, but a mail provider or recipient can reject or report a message. Verification does not establish the recipient’s consent.

What has separate costs?

The model subscription, mailbox and address verification. Franco code uses MIT.

Discussion

No questions or reviews yet.

CLI tools

Harvey finds companies, writes cold emails and triages replies in a loop on your machine, holding each send for approval.

CLIBroad access5.3KRepository stars
Needs a VPN

A Claude Code workspace that tracks jobs, finds roles and sends first messages to 1st-degree LinkedIn connections

PluginBroad access237Repository stars

YC skills for Claude Code hiring: pipeline, candidate emails, scheduling, Work at a Startup, Ashby and Gmail

SkillBroad access125Repository stars
Official

Open-source CRM for small teams with MCP: contacts, deals and tasks open to Claude and other agents, with reply drafts left to you

MCP serverBroad access221Repository stars

OpenOutreach picks B2B prospects from a product description, explains each pick and emails them from your mailbox

PluginBroad access3.7KRepository stars

Cold Outbound Skills

coldoutboundskills

31 skills for Claude Code on cold email: strategy, infrastructure, lead sourcing, copy and deliverability checks. Your own API keys are needed

SkillBroad access815Repository stars

README in short

The suppression list is shared across campaigns: a domain entry blocks every address at that domain. Franco logs can contain email addresses, so inspect them before sharing outside the team.

README badge

Report a problem