openturtles 0.12.0

OpenTurtles CLI — AI That Acts in the Real World. Say one sentence, get an AI agent that runs forever.

OpenTurtles

Say one sentence. Get an AI that acts on it — forever.

AI That Acts in the Real World.

Website · Documentation · Live Map · Explore Turtles

---

✨ What is OpenTurtles?

OpenTurtles turns a single sentence into a living, autonomous AI agent — a Turtle — that watches your world, acts on it, and evolves over time.

"Remind me to stand up every 25 minutes." "Turn off the lights when I leave the room." "Catch me slacking off and nudge me back."

One sentence creates a Turtle. It runs in the background, observes your environment, takes action, and gets smarter the longer it lives — so you don't have to.

A Whole New Quadrant

Not a chatbot. Not a cron job. Not a dev framework. OpenTurtles creates something entirely new.

	Stops After Reply	Acts Forever
Natural Language	💬 ChatGPT Conversational AI Answers once, then stops	🐢 OpenTurtles ✦ New Quadrant One sentence · Compile once Watches, acts, evolves — forever
Requires Coding	🔧 LangChain / Agents Developer framework Calls LLM every time, requires code	⏰ Cron / RPA Fixed scripts No understanding, no evolution

---

🚀 Installation

One-line install (macOS / Linux)

curl -fsSL https://openturtles.ai/install.sh | bash

Manual download

Grab a prebuilt binary from the latest release:

Platform	Architecture	Archive
macOS Apple Silicon	aarch64	turtles-v0.12.0-darwin-aarch64.tar.gz
macOS Intel	x86_64	turtles-v0.12.0-darwin-x86_64.tar.gz
Linux	x86_64	turtles-v0.12.0-linux-x86_64.tar.gz
Linux	aarch64	turtles-v0.12.0-linux-aarch64.tar.gz

tar -xzf turtles-v0.12.0-<platform>.tar.gz
sudo mv turtles /usr/local/bin/
turtles --version

⚡ Quick Start (5 minutes)

Get your first Turtle running in 3 steps.

Step 1 — Log in

$ turtles login
✓ Logged in as openturtles

Step 2 — Create a Turtle

$ turtles create "Remind me to drink water every hour from 9am to 6pm"
⠋ Compiling...
✓ WaterReminder created and started (PID: 12345)

Step 3 — Watch it run

$ turtles watch WaterReminder
[09:00] 💧 Reminder: Time to drink water!
[10:00] 💧 Reminder: Time to drink water!
[11:02] 💧 Reminder: Time to drink water!

That's it. Your Turtle is running in the background, forever.

Deploy it to OpenTurtles (optional)

Push it to your dashboard or share it on the Live Map:

$ turtles deploy WaterReminder

  🐢 Deploying WaterReminder to OpenTurtles

  Visibility:
  ❯ Public — visible on your profile and discoverable by anyone
    Private — only visible to you on your dashboard

  ✓ Deployed WaterReminder to OpenTurtles!

  View on OpenTurtles:
    https://openturtles.ai/openturtles/WaterReminder

Deploying is entirely optional — your Turtle works the same whether deployed or not.

---

🧠 From Zero to Act

No code. No config files. Just one sentence.

3 steps — that's it

01 · Say What You Want Describe what you need in plain language.

"Remind me to stand up every 25 minutes"

02 · AI Compiles It AI understands your intent and generates a live turtle. Compiled once. Runs forever. Zero ongoing cost.

03 · It Watches, Acts, Evolves Runs in the background. Observes your world, takes action, and gets smarter over time.

See it in action

# Step 1 — Create a Turtle with one sentence
$ turtles create "Turn on heater below 18°C, AC above 26°C"
  ⠋ Compiling...
  ✓ HomeKeep created & started (PID: 12345)

# Step 2 — Watch it work in real-time
$ turtles watch HomeKeep
  [14:30] 🐢 HomeKeep │ 🌡️ 21.5°C — normal range
  [14:31] 🐢 HomeKeep │ 🧬 Auto-evolved: weekend threshold 17°C
  [22:00] 🐢 HomeKeep │ 💡 You left — turned off 3 lights

# Step 3 — Deploy to the global network
  ✓ Deployed to https://openturtles.ai/@openturtles/HomeKeep
  🌍 Now visible on the Global Turtle Network

---

🌱 Self-Evolution Timeline

A Turtle isn't a script. It's a living process. Here's what happens after you create one:

Phase	What it does
Day 7	Starts recording environment data (observe("idle_seconds", 16.7, ...))
Day 30	Discovers patterns ("weekend idle threshold is longer")
Day 90	Auto-tunes its own config variables (AWAY_THRESHOLD: 300→240, confidence 0.92)
Day 365	Fully autonomous. Hundreds of evolutions. Zero human intervention.

Only configuration variables evolve — never the logic. Your Turtle gets smarter without ever going rogue.

---

🐢 What You Can Build

A few real examples from the community — every one of them is a single sentence away.

Domain	Turtles
🩺 Health	WaterTrack · EyeGuard · PostureCheck · StandupReminder
🎯 Productivity	PomodoroTimer · FocusGuard · DailyStandup · DistractionBlocker
💻 System	DiskWatcher · BatteryGuard · NightShift · CpuCooler
🛠️ Dev	GitReminder · BuildMonitor · PortWatcher · LogTailer
📊 Data	ApiHealthCheck · CryptoTracker · WeatherAlert · RssDigest
📓 Journal	MoodDiary · IdeaCapture · TimeTracker
🔒 Security	ScreenLocker · NetworkGuard · ClipboardCleaner
📚 Learning	WordOfTheDay · ReadingTimer
🤖 Automation	DownloadCleaner · BackupReminder · HomeLights

Browse the full catalog on the Explore page.

---

📦 Releases

• Current version: v0.12.0
• Install URL: https://openturtles.ai/install.sh
• All releases: https://github.com/openturtles/cli/releases

---

🗺️ Roadmap & Status

All 15 foundational milestones (M1–M15) are ✅ complete and shipped in v0.12.0.

Milestone breakdown

Milestone	Area	Highlights
M1–M4	Foundation	CLI, CRUD, Mission Compiler, QuickJS Executor, LLM Connector, Safety Guard, 32 JS APIs
M5–M5b	Execution Engine	Exponential backoff, caffeinate, JSONL logs, state persistence, loop detection, log rotation
M6	Capability Extensions	Home Assistant adapter, MCP client (stdio/SSE/HTTP), domain auto-discovery
M7	Skill System	SKILL.md format, Skill Loader, 5-layer system prompt, ClawHub registry
M8–M10	Safety, Context, Learning	Tool concurrency partitioning, context compression, observe→reflect→evolve adaptive learning
M11	Community & Platform	Homepage, Live Map, Explore, Dashboard, Docs, OAuth/OTP, JWT, Deploy Tokens
M12–M15	Daemon, Scheduling, DNA	launchd/systemd auto-start, cron/at, event retention, server-side DNA compilation, versioning

---

📖 Documentation

Full documentation lives at https://openturtles.ai/docs.

🚀 Getting Started

• Installation
• Quick Start (5 minutes)
• Deploy to OpenTurtles

📖 Core Concepts

• What is a Turtle?
• Sentence → DNA → Execute
• Observe → Reflect → Evolve

⌨️ CLI Reference

• turtles create
• turtles list / status
• turtles start / stop / kill
• turtles watch
• turtles connect
• turtles deploy / undeploy
• turtles search / install

🔌 Connect

• LLM Providers — Configure LLM servers for DNA compilation. Built-in support for OpenAI, Anthropic, Ollama (local), and any OpenAI-compatible endpoint (DeepSeek, Groq, Together…). Multi-server with one-command default switching.
• MCP Servers — Connect Model Context Protocol servers to extend Turtles with external tools — filesystems, databases, APIs, dev tools, and more. Supports stdio, HTTP, and SSE transports.
• Skills — Markdown-based behavioral instructions (SKILL.md) that teach Turtles how to act, not just what to do. Install from a local directory or the ClawHub community registry.
• Home Assistant — Let your Turtles control smart home devices — lights, sensors, climate, switches, media players. Multi-instance (e.g. home + office) with auto entity discovery.

🐢 Use Cases Health · Productivity · System · Dev · Data · Journal · Security · Learning · Automation

---

💬 Feedback & Support

We'd love to hear from you. Bug reports, feature requests, and product feedback are always welcome.

• 📮 Feedback / Support — [e-mail]
• 🐦 Twitter / X — @openturtles
• 🗺️ Live Map — https://openturtles.ai/live (see Turtles running around the world, city-level anonymized)
• 🐢 Share your Turtle — turtles deploy <name> — make it discoverable on the Explore page

---

📄 License

© 2026 OpenTurtles. All rights reserved.

OpenTurtles is a proprietary product. The turtles binary is provided free of charge for personal and commercial use, subject to the Terms of Service. Redistribution, reverse engineering, or derivative works are not permitted without prior written consent.

---

Our vision: building the first Global Reality AI Network — millions of Turtles, observing, acting, and evolving across the real world.

Made with 🐢 by the OpenTurtles team.