Radial app

Limits & troubleshooting

Radial is in early access. Here's what v1 deliberately doesn't do yet, and quick fixes for the common setup snags. Stuck on something else? Email support@radial.to.

Troubleshooting

"Node is missing"

Radial needs Node 18 or newer on your machine. Install it with Homebrew, nvm, Volta, or from nodejs.org, then reopen the project. Radial resolves your login shell's PATH, so however you installed Node, it's found, even when Radial is launched from Finder.

The agent shows "Connect the agent"

The built-in agent needs a Claude Code login. Run claude login in any terminal (or set an ANTHROPIC_API_KEY environment variable) and follow the card's one step.

A private repo won't clone

Radial uses your machine's existing git auth. If git clone works for that repo in your own terminal, it works in Radial; if it doesn't, set up your git credentials (SSH key or credential helper) first.

Known limits in v1

• Edit mode changes existing text, links, images, and meta tags. Adding brand-new meta tags, or making layout and styling changes, is agent territory; see Agents & terminal.
• Content fetched at runtime from an external CMS isn't editable; only content in the repo is.
• Interpolated text like Welcome to {brand} is detected and skipped rather than guessed at.
• Undo history is per session and isn't tied to git commits. The 5-minute idle suspend for background tabs is fixed.
• Each open tab runs its own dev server, which is fine for a handful but heavier at scale.
• Radial v1 is a local desktop app. Hosted, zero-install editing is a later phase.