💻CLI Referenceturtles create

turtles create

Create a new Turtle from one sentence.

Create a new Turtle from one sentence

Usage: turtles create [OPTIONS] <DESCRIPTION>

Arguments:
  <DESCRIPTION>  Task description in natural language

Options:
      --json     Output in JSON format
  -q, --quiet    Minimal output
  -v, --verbose  Detailed output
  -h, --help     Print help

Example

$ turtles create "remind me to drink water every hour from 9am to 6pm"

  ⠋ Compiling...

  ✓ Turtle powers discovered
      ● System (29 tools): runCommand, sendNotification, emit, warn, ...
      ● HTTP (1 tools): fetch
      ● HA:default ★ (3 tools): ha.getState, ha.getStates, ha.callService
      ● MCP: testserver (3 tools): mcp:testserver:echo, mcp:testserver:get_time, mcp:testserver:list_files
      ● Skills (3 tools): skill:self-monitoring, skill:data-persistence, skill:notification-strategy

  ✓ Turtle DNA encoded (3153 tokens used)

  🐢 Name: WaterReminder


🐢 WaterReminder started (PID: 10527)
     Script: ~/.turtles/plans/hydronudge.js
     Log:    ~/.turtles/logs/hydronudge.log

  Watch live: turtles watch WaterReminder
  Stop:      turtles stop WaterReminder

You describe what you want in plain language. OpenTurtles AI compiles it into executable DNA, creates the Turtle, and auto-starts it in the background.

If a Turtle with the same name already exists, a unique suffix is appended automatically (e.g. WaterReminder2).