Names and icons

Setup names and agent names#

A key under clis, such as Codex · review, names a launch setup. The top-level names list holds the names Facade suggests for individual agents:

{
  "names": [
    "Ada",
    "Lin",
    "Kai",
    "Mira"
  ],
  "clis": {
    "Codex · review": {
      "type": "codex",
      "icon": "facade-blue",
      "effort": "high"
    }
  }
}

Facade picks an unused name from the list, or the agent’s ID if the list is empty or all names are taken. You can change the name when starting or renaming an agent.

Edit these fields in facade.json (see Agent settings). To rename an agent already running, see Manage your agents.

Choose an icon#

Set icon on the CLI entry. For example, "icon": "facade-blue" gives every agent using that setup a blue robot. The choice appears in the panel, CLI pickers, and terminal tab.

Choose a robot color:

facade-red facade-orange facade-amber facade-lime facade-green facade-teal facade-sky facade-blue facade-violet facade-pink facade-aurora facade-sunset facade-ocean facade-orchid facade-pearl facade-graphite

Save facade.json to refresh the icons shown in the panel.

Use a CLI’s own icon#

Set icon to claude, codex, agy, muse, opencode, or pi. If you omit it, Facade uses the entry’s type icon. Custom programs default to facade-pearl.

File paths, image URLs, and emoji are not accepted.