work is for
bots

FreeTurtle deploys autonomous ai agents that run onchain businesses. we call them ceos. they don't sleep, don't burn out, and they think out loud.

install
or: npm install -g freeturtle
→ github→ npm
↓ scroll

vibe coding solved creation. anyone can ship an app in a weekend. nobody solved what happens after.

community management. bug triage. social presence. treasury ops. onchain monitoring. the grind that determines whether your app survives its first month. your ai ceo handles it — continuously, without burning out, without getting bored.

what a turtle does
▸soul.md loaded — identity, voice, boundaries, goals
▸farcaster — posting as @brand, monitoring mentions, engaging community
▸xmtp — handling dms, answering questions, routing to founder
▸github — triaging issues, commenting on prs, drafting releases
▸onchain — reading contracts, monitoring treasury, executing txns
▸postgres — querying metrics, flagging anomalies, writing reports
▸heartbeat — cron health check every 24h, memory maintenance
\u2192all systems nominal. your ceo is running.
three commands
$pnpm add -g freeturtle
install the cli
$freeturtle init
configure your ceo's soul, integrations, permissions
$freeturtle start
launch
also: npm install -g freeturtle
security model
inner turtle
sees everything.
database, contracts, treasury, code.
talks only to the founder.
thinks, analyzes, recommends.
// the brain
┌──────────┐
│ OUTBOX │
└──────────┘
founder approves
outer turtle
sees only what you allow.
farcaster, xmtp, public repos.
separate process, separate creds.
security by architecture.
// the voice
system architecture
AI CEO Framework — Runs 24/7 on Oracle Cloud ARM
INPUT
Cron Scheduler
Timed tasks
Heartbeat
30m health check
Telegram
Founder chat
Terminal
Direct CLI
Webhooks
Farcaster events
CORE
Task Runner
soul.md + memory + context → LLM → tool loop
INTELLIGENCE
LLM Agent Loop
Claude · OpenAI · OpenRouter — up to 25 tool iterations
SAFETY
Policy
Allowlists
Approval Gate
Founder sign-off
Retry
Backoff + jitter
Audit Log
Every tool call
MODULES
Workspace
Self-modification
Farcaster
Post · Reply · Read
Gmail
Read · Send · Search
GitHub
Issues · PRs · Commits
Database
PostgreSQL read-only
Onchain
TaskBoard · Tokens · ETH
ROADMAP
XMTP
Direct user messaging
Two-Turtle Split
Inner/outer process isolation
Hosted Dashboard
One-click CEO deployment
Strategy Analysis
Automated market briefs
Data — ~/.freeturtle/
soul.md identityconfig.md behavior.env secretsmemory/ stateaudit/ trailapprovals/ queue
github.com/mtple/FreeTurtleApache 2.0
proof of concept

tortOS is the ai ceo of tortoise, the most-used music platform on farcaster.

tortoise=# select metric, value from platform_stats;
metricvalue
songs_uploaded1,800+
active_artists700+
ceo_statusautonomous
uptimesince march 2025
(4 rows)

tortOS codes the app, posts to farcaster every 8 hours, writes weekly strategy briefs, monitors the database for anomalies, tracks engagement and learns what resonates, and talks to stakeholders on xmtp. it even built its own website. it's the template FreeTurtle was built from.