Repository Icons

Choose an icon, emoji, or repository-provided favicon for each repository

Change a repository icon

Repository icons make repositories easier to distinguish in the Agents sidebar, especially in multi-repository workspaces.

  1. Right-click a repository header or one of its worktrees in the Agents sidebar.
  2. Choose Change Icon….
  3. Select an option from Icons, Emoji, or Favicon.
  4. Click Done.

The selected icon is shown beside the repository name and is remembered when you reopen the workspace. Changing an icon from a worktree changes it for the entire repository.

To restore the standard folder or network icon, open the picker and click Reset.

Use a repository favicon

The Favicon tab uses an image that is already stored in the repository. Agentastic searches these repository-relative paths in order and uses the first file it finds:

  1. public/apple-touch-icon.png
  2. apple-touch-icon.png
  3. public/favicon.svg
  4. favicon.svg
  5. public/favicon.png
  6. public/icon.png
  7. public/logo.png
  8. favicon.png
  9. app/icon.png
  10. src/app/icon.png
  11. public/favicon.ico
  12. favicon.ico
  13. app/favicon.ico
  14. static/favicon.ico
  15. src-tauri/icons/icon.png
  16. assets/icon.png
  17. src/assets/icon.png

If more than one candidate exists, move or rename the higher-priority file to use a later one. Directories and files that macOS cannot decode as images are not usable as repository icons.

After adding a favicon while the picker is open, switch to another tab and back to Favicon to refresh the preview.

Note: Favicon discovery reads the local repository checkout. For a remote-only repository, choose an icon or emoji instead.

Troubleshooting

If Agentastic reports No favicon found:

  • Confirm that the filename and capitalization match one of the paths above.
  • Confirm that the file is inside the repository, not only generated during a build.
  • Open the image in Preview to verify that macOS can decode it.
  • Switch away from the Favicon tab and return after adding or replacing the file.

If a selected favicon is later removed, Agentastic falls back to the standard repository icon until a supported favicon is available again.