Tortilloid
How it works / Free Agent

Docs / How it works / Free Agent

Free Agent

Turn ChatGPT, Claude or any web chat into a full coding agent. No key, no cost.

Free Agent is always on and needs no API key. You use ChatGPT, Claude or any other web chat as your coding agent. Tortilloid writes the prompt, the web chat does the work, and Tortilloid applies what comes back. Every change still goes through the Patch Log, so it can be reviewed and rolled back like any other.

When to use it

  • You don't have an API key yet, or don't want to pay for one.
  • You've run out of agent tokens and want to keep going.
  • You'd rather work in the chat app you already use.

How it works

  1. Choose what the AI sees. Cmd-click files in the file tree to add them to your context.
  2. Copy your code. Click Copy Code. Tortilloid copies the selected files, always their latest version, together with a prompt that tells the chat how to reply.
  3. Ask for a change. Paste into ChatGPT, Claude or any web chat, and describe what you want to build or fix. The chat replies with a patch, the exact code changes for Tortilloid to apply.
  4. Bring the changes back. Copy the reply. In Tortilloid, press Cmd+K to open Apply Patch, paste it and click Apply.
  5. Review and accept. Check the change, accept it, and see it live in your app.

Give the chat Tortilloid's tools

Choose Context › Copy Tortilloid CLI Prompt and paste it into the chat. It gives the chat the same Tortilloid tools agents use, through the tortilloid command-line tool. The chat tells you which commands to run, you run them in a terminal, and paste the results back.

Shortcuts

ToUse
Add a file to your contextCmd-click it in the file tree
Copy the selected files with the promptCopy Code
Apply a patchCmd+K
Add pasted files to your contextShift+Cmd+V
Clear the selectionCmd+0
Save a selection as a presetOption+Cmd+1 to 9
Bring a preset backCmd+1 to 9

Good to know

  • The web chat only sees what you paste into it, under that service's own terms. See What model providers see.
  • Add a checkpoint before a big change, so you can return to it in one step. See Checkpoints.
  • Presets are handy for work you come back to, such as the same few files for one feature.

See Keyboard shortcuts for the full reference.

Out of agent tokens? Keep going in free web chat. Same project. Same tools. Keep building.