Home / Guides / AI agent

Let an AI agent organize your iPhone home screen

Describing the layout you want is easier than dragging eighty icons. Your coding agent can do the dragging, and it can't write anything without your yes.

Rearranging a home screen is fiddly to do and easy to describe: "put the games on page 2", "group my work apps in one folder", "sort everything A–Z". IconShuffle is built so an AI coding agent, such as Claude Code, Codex or Cursor, can turn that sentence into a real change on your phone.

The important part: the agent shows you every change and waits for your approval before anything is written. Its instructions say so, and the tool underneath backs up your layout before every write anyway.

What you need

  • An AI coding agent: Claude Code, Codex or Cursor
  • Your iPhone and a USB cable
  • The prompt below. The agent reads the guide and installs the tool if needed.

The prompt to paste

The short version, then tell the agent what you want:

Read https://github.com/YakupEmreYerli/IconShuffle/blob/main/docs/agent-guide.md and help me rearrange my iPhone home screen.

Or the longer one, with your wish at the end:

Read https://github.com/YakupEmreYerli/IconShuffle/blob/main/docs/agent-guide.md and
help me rearrange my iPhone home screen with ios-homescreen. Install it if needed, show me
every change before anything is written to the phone, and wait for my yes. What I want:
put my work apps in one folder and move the games to page 2.

The agent guide tells the agent how to install and use the tool, and that it must show you the changes and wait for your yes before writing. You still connect the phone and tap Trust yourself; only you can do that part.

Things you can ask for

  • "Sort my apps by color."
  • "Group my apps by category: social, work, finance, travel."
  • "Put my games on page 2."
  • "Move my work apps into one folder called Work."
  • "Sort everything A–Z." (There is also a Sort A-Z button in the app, and an ios-homescreen sort command.)
  • "Move the apps I never use to the App Library."

How a session goes

  1. You plug in the phone and tap Trust. The agent can't do this for you; it's the phone's own security step.
  2. The agent reads your layout. IconShuffle pulls your home screen (dock, pages, folders, widgets) into an editable text file.
  3. It proposes the changes. You see what moves where: what leaves a page, what goes into a folder, what goes to the App Library.
  4. You say yes. Only then does it write. Before the write it saves a backup; afterwards it reads the phone back and compares. If the check fails, the backup goes back on by itself.

Safety, in plain terms

Nothing lands on your phone without an explicit yes. Every write is backed up and checked, and ios-homescreen restore latest undoes the last one. Nothing is installed on the iPhone. For Claude Code there is also a ready-made skill in the repository (skills/ios-homescreen) with the same workflow.

Honest limitations

  • The agent works with apps, folders, widgets and pages. It can't add new widgets (those are added on the phone), and iOS doesn't keep empty gaps between icons.
  • The first connection needs a cable and a tap on Trust. After that, Wi-Fi works on iOS 17 and later.
  • Your app names go to whichever AI service your agent uses. That's how it knows which icons are games or work apps.

Prefer to drag things yourself? The app works the same way, minus the typing.

Install IconShuffle