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
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
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/francoDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad 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.
Related
CLI toolsHarvey finds companies, writes cold emails and triages replies in a loop on your machine, holding each send for approval.
A Claude Code workspace that tracks jobs, finds roles and sends first messages to 1st-degree LinkedIn connections
YC skills for Claude Code hiring: pipeline, candidate emails, scheduling, Work at a Startup, Ashby and Gmail
Open-source CRM for small teams with MCP: contacts, deals and tasks open to Claude and other agents, with reply drafts left to you
OpenOutreach picks B2B prospects from a product description, explains each pick and emails them from your mailbox
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
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.