Local-first · BYOK · Runs on your machine

Your desktop AI that actually finishes work

Ferryman automates research, content, and operations on your local machine. Your data never leaves. Your API keys, your models, your rules.

What you can do

Real work, not demos.

These are real workflows running in production today. Each one is powered by a Skill — a reusable playbook that Ferryman executes end-to-end.

SEO

SEO Content Matrix

Automatically research keywords, analyze competitor rankings, scrape SERP intent, and generate a structured content calendar with topic clusters — all saved as local Markdown files.

Research → Cluster → Outline → Calendar.md
Intelligence

AI Hotspot Daily Brief

Every morning at 8:00, Ferryman scans 20+ AI sources, filters noise, extracts key signals, and generates a structured intelligence report on your desktop.

Cron 08:00 → Scan → Filter → Report.md
Growth

Backlink Prospecting

Discover free, high-authority backlink opportunities. Ferryman browses directories, forums, and resource pages, filters by domain authority, and compiles a submission-ready report.

Browse → Filter DA → Score → Backlinks.md
Finance

Sentiment & Risk Audit

Monitor market signals or brand mentions, distill noise into risk scores, and generate automated alerts.

Listen → Distill → Risk Score → Alert.md
Marketing

Content Distribution Engine

Autonomously repurpose source content for LinkedIn, Twitter, and Newsletters while maintaining brand voice.

Source → Analyze → Style Map → Post_Batch.md
Research

Market Opportunity Scanner

A self-directed explorer for emerging niches, competitor pricing models, or technology shifts.

Goal → Search → Navigate → Synthesize → Discovery.md

Ships with 6 built-in Skills. While Skills provide optimized playbooks, Ferryman is a general-purpose agent capable of autonomous reasoning for any open-ended task.

Finished output

A readable report is ready when the run finishes.

Ferryman does not stop at a chat answer. It writes a clean local report with the summary, signals, and next actions already organized.

Saved locally sample-seo-keyword-audit.md
SEO Keyword Audit Where GeoSolver can win next
Executive summary

GeoSolver already has traction on alternative-intent pages. The clearest upside is educational content, GeoGuessr strategy guides, and richer structured SEO assets that connect top-of-funnel traffic to tool pages.

Alternative pages Quick win
Image location mega-guide High impact
GeoGuessr meta hub Authority play
View full report sample

Design Principles

Built for trust, not hype.

Three commitments that shape every decision we make.

01

Usable by non-engineers

You shouldn't need to write code to automate your work. Ferryman wraps complex toolchains — browser control, file I/O, LLM orchestration — behind a conversational interface with a visual task monitor. If you can describe what you want, you can run it.

02

Stable and observable

Every tool call is logged. Every task has a visible state. Every output is saved to disk. When automation fails — and it will — you can diagnose from structured logs instead of guessing. No black boxes, no invisible magic.

03

Local-first and private

Your data stays on your machine. Your API keys connect directly to your chosen model provider — we never proxy, log, or store them. All artifacts, logs, and configuration live under ~/.ferryman/. BYOK is not optional, it's the architecture.

Under the Hood

How it actually works.

Full transparency on the systems that power Ferryman. No hand-waving.

A · Context Memory

Each Session owns an isolated workspace directory, conversation history, and a compressed memory summary. Context never bleeds across projects. Long conversations stay coherent through hybrid memory — recent messages in a sliding buffer, older context in a rolling summary.

session.workspace: ~/.ferryman/workspaces/{id}/
session.memory: dynamic compressed summary
session.history: last 30 messages buffer
B · Observability

Every tool call emits a structured event with start/complete/error phases and millisecond-level duration. Tasks follow a state machine (pending → running → success/failed). Token usage is tracked per session.

Task FSM: pending → running → success / failedFSM
Tool events: phase + duration_ms + inputEVENT
Token audit: per-session input/outputAUDIT
C · Action Surface

Five built-in toolkits: a stealth browser with page distillation, a sandboxed file system, a skill-scoped script runner, a task tracker, and a skill delegation engine. Each runs inside the session workspace with strict path isolation.

Web
7 browser actions
File
read / write / list
Script
skill-scoped exec
Task
create / track
Skill
delegate / publish
D · Scheduling

Schedules persist in SQLite with cron expressions and track last/next run times. A daily AI hotspot scan or weekly SEO audit keeps producing deliverables without you watching.

cron: "0 8 * * *"
skill: ai-hotspot-miner
status: enabled
E · Skills as Portable Assets

A Skill is a local directory: SKILL.md (SOP + YAML metadata), optional scripts, reference materials, and output templates. It can be zipped, shared across teams, or published with a single tool call. Automation experience becomes a portable, versionable asset — not a fragile prompt.

seo-keyword-research/
├── SKILL.md # SOP + metadata
├── scripts/ # private executables
├── references/ # knowledge base
└── assets/ # templates
F · Model Routing

Different work deserves different engines. Ferryman routes planning, execution, and formatting to the model path that fits the job. You choose the providers, configure the keys, and control the routing.

Plan with a reasoning model PRO
session → planning
Execute with a faster worker PLUS
task → tool calls
Finalize into deliverables LITE
artifact → saved output

Ready to try
real local automation?

Ferryman is open source on GitHub and runs on macOS. Download the latest release and bring your own API key to get started.

Download for macOS