Set up your project.

Enter a few details to prepare a guide for your agent. Start fresh, keep your existing stack or pick up where you left off.

Your complete guide

Read the template

Review or edit the Markdown, then give it to your coding agent. For blank details, the guide asks the agent to inspect, so it has no broken placeholders.

Editable template · project details are delegated to inspection.

What you get
Project inspection, relevant setup steps, checks and a note another agent can continue from.
What you need
An agent with folder and terminal access. Use a desktop or remote coding environment to run the guide; preparing it works on your phone.
When you step in
A missing project choice, provider sign-in or a change outside existing permission.

Tested setups

The maintained Hello recipe has its own release evidence. Read the recorded local trials below. Continued reliability and provider setup need separate evidence.

Recorded local fresh-agent trials

New project: 7 recorded runs; 3 completed without rescue, 4 after rescue, 0 blocked, 0 failed, 0 simulated. Latest: completed, 2026/11/08 09:40 Australia/Melbourne / 2026/11/07 22:40 UTC · evidence.

Existing external project: 8 recorded runs; 5 completed without rescue, 3 after rescue, 0 blocked, 0 failed, 0 simulated. Latest: completed, 2026/11/08 09:46 Australia/Melbourne / 2026/11/07 22:46 UTC · evidence.

Other paths: Repeat on a prepared project — 1 recorded, 1 completed, 0 after rescueInterrupted setup — 1 recorded, 1 completed, 0 after rescue.

Coverage for app-composer.project-setup/1 comes from the recorded attempts. Interrupted setup now has one recorded local observation; later changes, other clients, provider onboarding and continued reliability need their own observations.

Rescue includes autonomous tool or local recovery; human actions are recorded separately. Three earlier new-project observations lacked complete clock receipts and are disclosed in the linked evidence rather than counted here. Export checks exercise guide generation and boundaries. They do not count as agent setup attempts.

Follow the evaluation and remaining coverage

Prefer the supported first-app walkthrough? Open Get Ready. Already have a model to build? Open Init. Working as an agent? Choose a role pack.